Manual de Instalação - URBEM

Manual de Instalação
Versão – 2.05.3
Manual de Instalação: URBEM CNM – Soluções em Gestão
Pública
Versão: 2.05.3
O URBEM CNM - Soluções em Gestão Pública - é um software livre
desenvolvido de acordo com a demanda dos municípios, tendo por objetivo o
aperfeiçoamento da gestão pública, através de uma visão moderna que
contemple a eficiência, a economicidade, a agilidade e transparência da
gestão municipal. Totalmente orientado à WEB, foi desenvolvido em
plataforma de software livre, desde o sistema operacional, o sistema
gerenciador de banco de dados e as ferramentas de programação.
Requisitos mínimos necessários para a instalação do URBEM CNMSoluções em Gestão Pública
Uma estrutura mínima necessária para que o sistema todo trabalhe em apenas um servidor.
Nota: O servidor, físico ou virtual, deverá ser dedicado exclusivamente para o sistema URBEM – Soluções em Gestão Pública.
Requisitos Mínimos do Servidor:
Hardware:
Processador Compatível com Arquitetura: x86 / x86-64;
Memória: 4GB (Recomendado 8GB);
HD: 80GB (Recomendado 500GB);
Software:
- Sistema Operacional Linux distribuição Ubuntu 12.04 LTS
(com mais de 4GB de memória, utilize a versão de 64bits);
- Apache 2.2;
- PHP 5.3;
- PostgreSQL 9.1;
- Java 6 ou superior;
- Tomcat 7;
- Dialog;
(O passo a passo orientará a instalação destes pacotes e demais
pacotes vinculados em linux ubuntu)
Pré-Requisitos Estações de Trabalho:
Qualquer computador com navegador firefox ou google chrome;
Observações:
NÃO utilize este roteiro caso o servidor já possua uma
instalação prévia do URBEM.
O URBEM pode funcionar com outras distribuições Linux. No entanto,
as mesmas não foram testadas/homologadas pelas equipes de
desenvolvimento e testes de software da Confederação Nacional de
Municípios.
Passo a Passo para a Instalação do URBEM
(Necessário usuário do ubuntu com permissão de super usuário.)
1) Abrir um Terminal de linha de comando no Linux;
2) Crie um diretório para copiar os arquivos necessários e posicione
nele:
mkdir urbem_tmp
cd urbem_tmp
pwd
Observe o caminho do diretório com o comando pwd.
3) Atualizar lista de pacotes do repositório:
sudo apt-get update -y
4) Instalação dos pacotes necessários (o comando abaixo é uma única
linha):
sudo apt-get install -y postgresql-9.1 postgresql-client-9.1 postgresql-contrib9.1 php5 php5-cli php5-pgsql php5-gd apache2 dialog openjdk-7-jre tomcat7 zip
unzip
ATENÇÃO: Copie e cole a linha de comando em um editor de texto,
para efetuar correções de quebra de linha.
5) * Efetuar o download da runtime do birt e extrair o arquivo:
• O birt é a ferramenta utilizada no URBEM para geração de relatórios
(saiba mais sobre o birt em: http://www.eclipse.org/birt).
Atualmente utilizamos a versão de runtime: 4.4.0
Download: (o comando abaixo é uma única linha)
wget http://eclipse.c3sl.ufpr.br/birt/downloads/drops/R-R1-4_4_0201406111043/birt-runtime-4_4_0-20140611.zip -O birt-runtime-4_4_0.zip
6) Extrair o arquivo da runtime:
unzip birt-runtime-4_4_0.zip
7) Copiar a runtime para a estrutura do tomcat7:
sudo cp -f -r birt-runtime-4_4_0/WebViewerExample /var/lib/tomcat7/webapps/viewer_440
8) Ajuste de configuração do viewer:
Edite com o editor de sua preferência o arquivo de configuração:
/var/lib/tomcat7/webapps/viewer_440/WEB-INF/web.xml
(utilizar o comando sudo na linha de comando antes do editor)
Neste arquivo, você precisa localizar “WORKING_FOLDER_ACCESS_ONLY”
e modificar o “param-value” de “true” para: “false” como demonstrado
abaixo:
De:
<context-param>
<param-name>WORKING_FOLDER_ACCESS_ONLY</param-name>
<param-value>true</param-value>
</context-param>
Para:
<context-param>
<param-name>WORKING_FOLDER_ACCESS_ONLY</param-name>
<param-value>false</param-value>
</context-param>
9) Efetuar download do JDBC do PostgreSQL:
wget http://jdbc.postgresql.org/download/postgresql-9.1-903.jdbc4.jar
10) Copiar o JDBC do PostgreSQL para o diretório do viewer(runtime) do
birt (o comando abaixo é uma única linha):
cp postgresql-9.1-903.jdbc4.jar /var/lib/tomcat7/webapps/viewer_440/WEB-INF/lib
11) Ajustar a permissão do arquivo JDBC (o comando abaixo é uma única
linha):
sudo chmod 755 /var/lib/tomcat7/webapps/viewer_440/WEB-INF/lib/postgresql-9.1903.jdbc4.jar
12) Ajustar proprietário do viewer:
sudo chown -R tomcat7. /var/lib/tomcat7/webapps/viewer_440
13) Reinicializar o serviço tomcat:
sudo service tomcat7 restart
14) Ajustar método de autenticação do banco de dados.
Editar o arquivo abaixo com o editor de sua preferência.
(utilizar o comando sudo na linha de comando antes do editor).
/etc/postgresql/9.1/main/pg_hba.conf
Neste arquivo certifique que o método de autenticação esteja definido
como md5 (última informação da linha abaixo, geralmente está peer):
De:
local
all
all
peer
local
all
all
md5
Para:
15) Ajustar porta padrão.
Optamos por utilizar o postgresql 9.1 em outra porta para evitar
conflito com possíveis instalações/restaurações de backup de versões
anteriores do urbem. Portanto, sugerimos que esta alteração seja
feita.
Editar o arquivo abaixo com o editor de sua preferência.
(utilizar o comando sudo na linha de comando antes do editor)
/etc/postgresql/9.1/main/postgresql.conf
Neste arquivo modifique o parâmetro port para 2345.
port = 2345
16) Reinicializar o serviço do banco de dados para funcionar com as
novas definições.
sudo service postgresql restart
17) Logar com usuário postgres e preparar banco de dados para
restauração da base de dados padrão.
sudo su - postgres
psql template1
Criar extensão hstore
CREATE EXTENSION hstore;
Definir uma senha para o usuário postgres.
alter user postgres with password 'nova_senha';
Criar o usuário do urbem no banco de dados e definir uma senha.
create user urbem superuser password 'nova_senha';
create database urbem;
create role birt login;
update pg_authid set rolpassword = 'md517e68e814c79648270e8a9c28b6386e7' where
rolname = 'birt';
18) Com usuário postgres, efetuar o download da base de dados padrão e
extrair o arquivo:
wget http://www.urbem.cnm.org.br/downloads/urbem_2.05.3.sql.bz2
\q
bunzip2 urbem_2.05.3.sql.bz2
19) Com usuário postgres, restaurar a base de dados padrão:
psql urbem < urbem_2.05.3.sql
psql postgres
alter database urbem owner to urbem;
grant urbem to birt;
\q
exit
20) Pelo navegador, efetuar o download dos fontes do urbem a partir da
página: http://www.urbem.cnm.org.br/formdownload.php
Observação: Copiar o arquivo para o diretório urbem_tmp de
acordo com o passo 2.
Após efetuar o download dos fontes (O exemplo abaixo refere-se a
versão 2.05.3, adapte o passo 16 de acordo com a última versão).
Em seguida efetue sua extração:
Exemplo:
tar xjf 29072016-urbem_2.05.3.tar.bz2
21) Copiar os fontes para a raiz do apache:
sudo cp -r urbem-2.05.3 /var/www/urbem
22) Criar o o arquivo de conexão a partir do modelo:
sudo cp /var/www/urbem/config.yml-dist /var/www/urbem/config.yml
23) Editar o arquivo de conexão com o editor de sua preferência.
(utilizar o comando sudo na linha de comando antes do editor)
/var/www/urbem/config.yml
Efetuar ajustes nos parâmetros port e password (do usuário 'urbem')
de acordo com os passos 14 e 15:
urbem:
connection:
database: urbem
host:
localhost
port:
2345
username: urbem
password: nova_senha
env:
type: prod
birt:
port: 8080
port_ssl: 8443
host:
24) Editar o arquivo abaixo com o editor de sua preferência.
(utilizar o comando sudo na linha de comando antes do editor)
/etc/apache2/conf.d/charset
De:
#AddDefaultCharset UTF-8
Para:
AddDefaultCharset UTF-8
25) Reinicializar o serviço apache para funcionar com a nova definição.
sudo service apache2 restart
26) Ajustar permissões/proprietário dos arquivos
sudo
sudo
sudo
sudo
sudo
sudo
chmod 755 /var/www/urbem
find /var/www/urbem -type d -exec chmod 755 {} \;
find /var/www/urbem -type f -exec chmod 644 {} \;
chmod 400 /var/www/urbem/config.yml
chmod 777 /var/www/urbem/gestaoAdministrativa/fontes/PHP/framework/tmp
chown -R www-data. /var/www/urbem
27) Após a instalação o sistema poderá ser acessado a partir do
navegador firefox.
http://ENDERECO_IP_DO_SERVIDOR/urbem
Utilize:
Usuário: admin
Senha: suporte
OBSERVAÇÕES FINAIS:
Não esqueça, de trocar a senha do admin no URBEM!
Efetuar backups tanto da base de dados (verificar
documentação do postgresql) quanto do diretório de fontes do
URBEM(/var/www/urbem). Procure enviar os backups para um
local seguro fora das dependências do prédio.
O manual eletrônico do sistema para a sua operação, encontrase disponível na página: http://www.urbem.cnm.org.br/manual
Suporte Urbem:
Telefone: (61) 3037-1101
E-mail: [email protected]