GUIA DE USUARIO DO

Com isso, o AtolVl adiciona funcionalidades sem precisar de novos desen—

volvimentos, apenas agregando os servigos ofertados pelos aplicativos inte—

grados. FaZ uso da reutilizagao de componentes que transformam o AtolVl

em uma ferramenta mais estavel e economica. Essa arquitetura e comum nos

aplicativos atuais, pois apresenta maior economia e estabilidade.

O Elasticsearch e utilizado pelo AtolVl no apoio a recuperagao das infor—

magoes mantidas
pelo sistema, pois aplicativo de Codigo aberto usado
e um

para tratar de grandes quantidades de dados. Assim, o AtolVl pode indexar

textos completos sem a necessidade do desenvolvimento de programas, ape—

nas integrando um aplicativo pronto ao sistema.

la 0 utilizado como um framework PHP que organiza os com—

Symfony e
ponentes usando orientagao a objetos e melhores padroes de designs prati—
cos da web. Com esse aplicativo, o AtolVl torna—se mais estavel e com padroes

facilmente reconhecidos, necessarios para softwares com desenvolvimento

colaborativo.

O servidor de aplicagao sugerido pelos desenvolvedores do AtolVl e o

NGINX, que apresenta mais leve e rapido que alguns outros aplicativos si—
se

milares. O NGINX e apropriado a sistemas desenvolvidos com PHP, como o

AtolVl, possuindo um proxy HTTP reverso e um servidor de email com uma
grande variagao de configuragao.

Com isso, forma—se uma infraestrutura robusta para o AtolVl, em que cada
aplicativo integrado realiza fungoes especificas, de forma a ter um funciona—
mento pleno. Revela—se ajustado com as questoes de reusabilidade e agre—

gagao, visto que utiliza aplicativos de acesso livre. Assim, o AtolVl pode focar
na sua finalidade, sem necessitar de desenvolvimento.

8.1 lnstalagéo
O processo de instalagao do AtolVl e simples e pode ser feito de forma se—
quencial. Nesse sentido, o presente Guia segue o padrao utilizado na docu—
mentagao oficial do AtolVl. Entretanto, requer—se cuidados para que cada

PARA OS INFORMATICOS
 GUIA DE USUARIO DO

etapa seja executada de forma correta e para que se ten ha urn born resultado,
visto que nenhuma das etapas deve ser substitur’da ou nao executada, pois
pode interferir no funcionamento.

Entretanto, pode—se corn necessidade de ajustes trocar algum aplicativo por

outro semelhante, mas deve—se ter cuidado, pois isso algumas vezes pode in—
terferir no seu funcionamento.Todos os comandos aqui foram feitos utilizando
urn Sistema operacional LINUX, seguindo a orientagao do uso de software livre.

8.2 Atualizar a lista de instalagées autométicas

Para que o seu Sistema operacional tenha a lista de instalagoes automaticas
correta, atualize—a com o seguinte comando, fazendo corn que o Sistema ope—
racional reorganize a lista de instalagoes feitas por meio do comando apt—get:

sudo apt-get update

8.3 lnstalar o Sistema Gerenciador de

Banco de Dados MY SQL

A instalagao do SGBD feita por meio do comando apt—

MySQL pode ser

get, que a faz de modo automatico, facilitando o processo. Para tanto, basta
dar o seguinte comando.

sudo apt-get install mysql-server—5.5

8.3.1 Definir a senha para o usuério root do MySQL

Caso tudo ocorra bem na instalagao, deve surgir uma mensagem pedindo
para que se defina uma senha para o usuario root, ou seja, o usuario adminis—
trador do SGBD.

PARA OS INFORMATICOS
138
 GUIA DE USUARIO DO

Ao responder a pergunta com o S (de Sim), uma nova tela sera apresen—
tada, requerendo a senha do usuario. Deve—se tomar cuidado corn essa etapa,
para que nao se
esquega ou perca a senha, pois ela sera dtil em outras etapas
ou na manutengao do AtolVl.

O sistema requer a confirmagao de senha, para assegurar o registro do ca—

dastrado.Tenha a certeza de digitar a mesma senha informagao no passo an—
terior.

Porfim, basta Clicar em OK para terminar com o processo de instalagao do

SGBD MySQL.

8.4 lnstalagéo do Elasticsearch

Passo 1°: Adicionar o repositorio JAVA

O Elasticsearch requer o uso de um repositorio PPA da Oracle. Para adicio—
nar o PPA, basta digitar o seguinte comando:

sudo add-apt-repository ppa:webupd8team/java

Passo 2°: Depois atualize seu repositorio de pacotes, digite o seguinte co—

mando:

sudo apt-get update

Passo 3°: Depois de instalar e atualizar o repositorio, o E/asticsearch requerera

a instalagao do oracle JDK 8, que é a versao recomendada para instalagao.
Para instalar o JDK, utilize o seguinte comando:

sudo apt-get install oracle-java8—installer

PARA OS INFORMATICOS
GUIA DE USUARIO DO

Passo 4°: Aceitar o contrato de licenga do Oracle Clicando na opgao’OK”:

Passo 5°: Para instalar este pacote, deve—se aceitar os termos da licenga (o
Acordo de Licenga do Oracle) Clicando na opgao’Sim”:

Passo 6°: Depois de instalar corn exito 0 Java, proceda a instalagao do Elas—
t/CSearCh. Baixe e instale a Chave de assinatura pdblica utilizada em seu repo—
sitorio, digitando o seguinte comando:

sudo apt-get install oracle-java8—installer

Passo 7°: Adicione no arquivo /etC/apt/sources.list para permitir que o repo—

sitorio seja instalado.
a. Abra o arquivo sourcelist, digitando o seguinte comando:

sudo nano /etc/apt/sources.list

b. Adicione no arquivo a linha de comando abaixo:

deb http://packages.elasticsearch.org/elastic
search/0.90/debian stable main

c. Atualize novamente a lista de instalagoes utilizando o seguinte co—

mando:

sudo apt-get update

Passo 8°: Depois de adicionar o repositorio PPA e instalar o JDK, 0 Elas—

ticsearch pode ser instalado. Utilizando o seguinte comando:

PARA OS INFORMATICOS
 GUIA DE USUARIO DO

sudo apt-get install elasticsearch

Passo 9°: Inicie e configure o servigo para iniciar o Elasticsearch quando o

sistema for inicializado. Utilize oseguinte comandoz

sudo update-rc.d elasticsearch defaults 95 10

8.5 lnstalagéo do Nginx

Passo 1°: Para instalar o AtoiVl, e recomendado que utilize o Nginx. Neste ma—
nual utilizaremos o Nginx, mas e perfeitamerite possivel utilizar 0 Apache. Di—

gite o comandoz

sudo apt-get install nginx

Passo 2°: Adiciona—se o repositério Nginx digitando o comandoz

sudo add-apt-repository ppa:nginx/stable

Passo 3°: Atualize novamente a lista de instalagées, utilizando o seguinte co—

mando;

sudo apt-get update

Passo 4°: Depois de adicionar o repositério PPA para o Nginx e atualizar, digite
o comando apt—get para instalar o Nginx:

PARA OSINFORMATICOS
141
 GUIA DE USUARIO DO

sudo apt-get install nginx

Passo 5°: 0 Nginx implementa um servidor padrao conhecido como Virtua—

/Host, Chamado default, que é encontrado em /etC/Nginx/sites—available/de—
fault. Para instalar o AtoM, é preciso editar o virtualhost ou criar um novo,
digitando os seguintes comandos:
a. Crie o arquivo de configuragaoz

sudo touch letc/nginx/sites-avaiIable/atom

b. Vincular o arquivo de configuragao com o arquivo sites—enabled/,

que é o diretério que o Nginx ira procurar:

sudo In -sf letc/nginx/sites-avaiIable/atom letc/nginx/sites-enabled/atom

c. Remova o arquivo sites—enabled/default:

sudo rm letc/nginx/sites-enabled/default

d. Adicione ao arquivo sites—enabled/AtoM os seguintes comandos de

configuragaoz

sudo nano letc/nginx/sites-enabled/atom

e. Depois de instalar e criar os arquivos de configuragao do Nginx, rei—

nicie o servigo Nginx:

PARA OS INFORMATICOS
142
 GUIA DE USUARIO DO

sudo service nginx restart

upstream AtoM {
server unix:/var/run/php5-fpm.AtoM.sock;
}

server {

listen 80;
root /usr/share/Nginx/AtoM;

# http://wiki.Nginx.org/HttpCoreModule#server_name
# _
means catch any, but it's better if you replace this with your ser-

ver

# name, e.g. archives.foobar.com

server_name _;

client_max_body_size 72M;

# http://wiki.Nginx.org/HttpCoreModule#try_files
location / {
try_files $uri /index.php?$args;
}

location ~

/\.{
deny all;
return 404;
}

location ~*
(\.yml|\.ini|\.tmpl)$ {
deny all;
return 404;

PARA OSINFORMATICOS
143
 GUIA DE USUARIO DO

location ~*
/(?:uploads|files)/.*\.php$ {
deny all;
return 404;
}

location ~*
/uploads/r/(.*)/conf/{

location ~* A/uploads/r/(.*)$ {
include /etc/Nginx/fastcgi_params;
set $index /index.php;
fastcgi_param SCRIPT_F|LENAME $document_root$index;
fastcgi_param SCRIPT_NAME $index;
fastcgi_pass AtoM;
}

location ~

A/private/(.*)$ {
internal;
alias /usr/share/Nginx/AtoM/$1;
}

location A/(index|qubit_dev)\.php(/|$) {
~

include /etc/Nginx/fastcgi_params;
fastcgi_param SCRIPT_F|LENAME
$document_root$fastcgi_script_name;
fastcgi_split_path_info A(.+\.php)(/.*)$;
fastcgi_pass AtoM;

location ~*
\.php${
deny all;
return 404;

Quadro 3 Arquivo Ato/Vl

—

PARA OS INFORMATICOS
144
 GUIA DE USUARIO DO

8.6 lnstalagéo do PHP

0 AtolVl usa o (FastCGl Process Manager) que é uma alternativa

PHP—FPlVl

para a implementacao PHP FastCGl. O comando a seguir ira instala—lojunto

corn as extensoes PHP requeridas pelo AtolVl:

sudo apt-get install phpS-cli phpS-fpm php5-curl phpS-mysql php5-xsl

phpS-json phpS-ldap php-apc

Se voce estiver usando 0 Ubuntu 14.04, 0 pacote phpS—readline tambem

e recomendado. Entao digite o comando abaixo:

sudo apt-get install phpS-readline

Vamos adicionar urn novo conjunto de PHP para AtolVl, acrescentando os

seguintes comandos em urn novo arquivo chamado /Atol\/l.conf:

sudo nano letc/php5/fpm/pool.d/atom.conf

[AtoM]

#The user running the application

user WWW-data
=

group WWW-data
=

# Use UNIX sockets if Nginx and PHP-FPM are running in the same

machine
listen =
/var/run/php5-fpm.AtoM.sock

PARA OS INFORMATICOS
145
 GUIA DE USUARIO DO

|isten.owner = www-data
|isten.group = www-data
|isten.mode = 0600

# The following directives should be tweaked based in your hardware

resources

pm dynamic
=

pm.max_children = 30
pm.start_servers = 10
pm.min_spare_servers = 10
pm.max_spare_servers 10 =

pm.max_requests 200 =

chdir =/

# Some defaults for your PHP production environment

# A full list here: http://www.php.net/manual/en/ini.list.php
php_admin_value[expose_php] off =

php_admin_value[allow_url_fopen] on =

php_admin_value[memory_limit] 512M =

php_admin_value[max_execution_time] 120 =

php_admin_value[post_max_size] 72M =

php_admin_value[upload_max_filesize] 64M =

php_admin_value[max_fi|e_uploads] 10 =

php_admin_value[cgi.fix_pathinfo] 0 =

php_admin_value[display_errors] off =

php_admin_value[display_startup_errors] off =

php_admin_value[htm|_errors] off =

php_admin_value[session.use_only_cookies] 0 =

#APC, which is still used in PHP 5.5 for userland memory cache un-

less you
# switching to something like
are sfMemcacheCache
php_admin_value[apc.enabled] = 1
php_admin_value[apc.shm_size] = 64M

PARA OS INFORMATICOS
146
 GUIA DE USUARIO DO

php_admin_va|ue[apc.num_fi|es_hint] = 5000
php_admin_va|ue[apc.stat] 0 =

# Zend OPcache
# Only in Ubuntu 14.04 (PHP 5.5).
# Don't use this in Ubuntu 12.04, it won't work.
php_admin_va|ue[opcache.enab|e] 1 =

php_admin_va|ue[opcache.enab|e_c|i] 0 =

php_admin_va|ue[opcache.memory_consumption] 192 =

php_admin_va|ue[opcache.interned_strings_buffer] 16 =

php_admin_va|ue[opcache.max_acce|erated_fi|es] 4000 =

php_admin_value[opcache.va|idate_timestamps] 0 =

php_admin_va|ue[opcache.fast_shutdown] 1 =

# This is a good place to define some environment variables, e.g. use

# ATOM_DEBUG_|P to define list of IP addresses with full access to the

a

# debug frontend or ATOM_READ_ONLY if you want AtoM to prevent

# authenticated users

env[ATOM_DEBUG_IP] "10.10.10.10,127.0.0.1"
=

env[ATOM_READ_ONLY] "off" =

Quadro 4 Arqu/vo AtoA/i.conf

—

Depois de instalar as extensoes do PHP, e' necessario reiniciar o servico:

sudo service php5-fpm restart

Se 0 servico nao for iniciado, verifique se 0 arquivo de configuracao foi colado

corretamente. Vocé tambe’m pode verificar a sintaxe executando o comando:

sudo php5-fpm —test

PARA OS INFORMATICOS
147
GUIA DE USUARIO DO

8.7 lnstalagéo do servidor German Job

O servidor de Gearman Job e requerido pelo AtoM a partir da versao 2.2.

Instale o Gearman Job Server com o seguinte comandoz

sudo apt-get install gearman-job-server

8.8 Outros pacotes

O AtoM requer a instalagao do Apache FOP 1.0, que gera arquivos em PDF.
Para instalar 0 Apache FOP 1.0, digite os seguintes comandos:

Passo 1°: Digite o comando abaixo para baixar o arquivo de instalagao fop—1.0:

wget https://archive.apache.org/dist/xmIgraphics/
fop/binaries/fop-1.0-bin.tar.gz

Passo 2°: Extrair o arquivo digitando o comando abaixo;

tar -zxvffop-1.0-bin.tar.gz

Passo 3°: Remova o arquivo compactado do FOP 1.0 digitando o comando

abaixo;

rm fop-1.0-bin.tar.gz

PARA OS INFORMATICOS