Manual de Instalao

Verso 2.03.9

Manual de Instalao: URBEM CNM Solues em Gesto

Pblica
Verso: 2.03.9
O URBEM CNM - Solues em Gesto Pblica - um software livre
desenvolvido de acordo com a demanda dos municpios, tendo por objetivo o
aperfeioamento da gesto pblica, atravs de uma viso moderna que
contemple a eficincia, a economicidade, a agilidade e transparncia da
gesto 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 programao.
Requisitos mnimos necessrios para a instalao do URBEM CNMSolues em Gesto Pblica
Uma estrutura mnima necessria para que o sistema todo trabalhe em apenas um servidor.
Nota: O servidor, fsico ou virtual, dever ser dedicado exclusivamente para o sistema URBEM Solues em Gesto Pblica.
Requisitos Mnimos do Servidor:
Hardware:
Processador Compatvel com Arquitetura: x86 / x86-64;
Memria: 4GB (Recomendado 8GB);
HD: 80GB (Recomendado 500GB);
Software:
- Sistema Operacional Linux distribuio Ubuntu 12.04 LTS
(com mais de 4GB de memria, utilize a verso de 64bits);
- Apache 2.2;
- PHP 5.3;
- PostgreSQL 9.1;
- Java 6 ou superior;
- Tomcat 7;
- Dialog;
(O passo a passo orientar a instalao destes pacotes e demais
pacotes vinculados em linux ubuntu)

Pr-Requisitos Estaes de Trabalho:

Qualquer computador com navegador firefox ou google chrome;
Observaes:
NO utilize este roteiro caso o servidor j possua uma
instalao prvia do URBEM.
O URBEM pode funcionar com outras distribuies Linux. No entanto,
as mesmas no foram testadas/homologadas pelas equipes de
desenvolvimento e testes de software da Confederao Nacional de
Municpios.
Passo a Passo para a Instalao do URBEM
(Necessrio usurio do ubuntu com permisso de super usurio.)
1) Abrir um Terminal de linha de comando no Linux;
2) Crie um diretrio para copiar os arquivos necessrios e posicione
nele:
mkdir urbem_tmp
cd urbem_tmp
pwd

Observe o caminho do diretrio com o comando pwd.

3) Atualizar lista de pacotes do repositrio:
sudo apt-get update -y

4) Instalao dos pacotes necessrios (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

ATENO: Copie e cole a linha de comando em um editor de texto,

para efetuar correes de quebra de linha.

5) * Efetuar o download da runtime do birt e extrair o arquivo:

O birt a ferramenta utilizada no URBEM para gerao de relatrios
(saiba mais sobre o birt em: http://www.eclipse.org/birt).

Atualmente utilizamos a verso 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 configurao do viewer:

Edite com o editor de sua preferncia o arquivo de configurao:
/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 diretrio 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 permisso do arquivo JDBC (o comando abaixo uma nica

linha):
chmod 755 /var/lib/tomcat7/webapps/viewer_440/WEB-INF/lib/postgresql-9.1903.jdbc4.jar

12) Ajustar proprietrio do viewer:

chown -R tomcat7. /var/lib/tomcat7/webapps/viewer_440

13) Reinicializar o servio tomcat:

sudo service tomcat7 restart

14) Ajustar mtodo de autenticao do banco de dados.

Editar o arquivo abaixo com o editor de sua preferncia.
(utilizar o comando sudo na linha de comando antes do editor).
/etc/postgresql/9.1/main/pg_hba.conf

Neste arquivo certifique que o mtodo de autenticao esteja definido

como md5 (ltima informao da linha abaixo, geralmente est peer):
De:
local

all

all

peer

local

all

all

md5

Para:

15) Ajustar porta padro.

Optamos por utilizar o postgresql 9.1 em outra porta para evitar
conflito com possveis instalaes/restauraes de backup de verses
anteriores do urbem. Portanto, sugerimos que esta alterao seja
feita.
Editar o arquivo abaixo com o editor de sua preferncia.
(utilizar o comando sudo na linha de comando antes do editor)
/etc/postgresql/9.1/main/postgresql.conf

Neste arquivo modifique o parmetro port para 2345.

port = 2345

16) Reinicializar o servio do banco de dados para funcionar com as

novas definies.
sudo service postgresql restart

17) Logar com usurio postgres e preparar banco de dados para

restaurao da base de dados padro.
sudo su - postgres
psql template1

Criar extenso hstore

CREATE EXTENSION hstore;

Definir uma senha para o usurio postgres.

alter user postgres with password 'nova_senha';

Criar o usurio do urbem no banco de dados e definir uma senha.

create user urbem superuser password 'nova_senha';
create database urbem;
\q

18) Com usurio postgres, efetuar o download da base de dados padro e

extrair o arquivo:
wget www.urbem.cnm.org.br/downloads/urbem_2.03.9.sql.bz2
bunzip2 urbem_2.03.9.sql.bz2

19) Com usurio postgres, restaurar a base de dados padro:

psql urbem < urbem_2.03.9.sql
psql postgres
alter database urbem owner to urbem;
\q
exit

20) Pelo navegador, efetuar o download dos fontes do urbem a partir da

pgina: http://www.urbem.cnm.org.br/formdownload.php

Observao: Copiar o arquivo para o diretrio urbem_tmp de

acordo com o passo 2.
Aps efetuar o download dos fontes (O exemplo abaixo refere-se a
verso 2.03.9, adapte o passo 16 de acordo com a ltima verso).
Em seguida efetue sua extrao:
Exemplo:
tar xjf 21052015-urbem_2.03.9.tar.bz2

21) Copiar os fontes para a raiz do apache:

sudo cp -r urbem-2.03.9 /var/www/urbem

22) Criar o o arquivo de conexo a partir do modelo:

sudo cp /var/www/urbem/config.yml-dist /var/www/urbem/config.yml

23) Editar o arquivo de conexo com o editor de sua preferncia.

(utilizar o comando sudo na linha de comando antes do editor)
/var/www/urbem/config.yml

Efetuar ajustes nos parmetros port e password (do usurio '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 preferncia.

(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 servio apache para funcionar com a nova definio.

sudo service apache2 restart

26) Ajustar permisses/proprietrio 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) Aps a instalao o sistema poder ser acessado a partir do

navegador firefox.
http://ENDERECO_IP_DO_SERVIDOR/urbem
Utilize:
Usurio: admin
Senha: suporte
OBSERVAES FINAIS:
No esquea, de trocar a senha do admin no URBEM!
Efetuar backups tanto da base de dados (verificar
documentao do postgresql) quanto do diretrio de fontes do
URBEM(/var/www/urbem). Procure enviar os backups para um
local seguro fora das dependncias do prdio.
O manual eletrnico do sistema para a sua operao, encontrase disponvel na pgina: http://www.urbem.cnm.org.br/manual
Equipe Urbem:
Telefone: (61) 2101-6000
E-mail: suporte@cnm.org.br