Manual Instalao e-cidade no Ubuntu Server 8.

04 LTS

Verso 1.0 21/09/2009

Ttulo Manual Instalao e-cidade no Ubuntu Server 8.04 LTS Autor Fabrzio de Royes Mello Direitos DBSeller Servios de Informtica LTDA. Data Criao 21/09/09 Importante Para este procedimento recomenda-se conhecimentos na instalao de sistemas operacionais linux e apt-get. O servidor que ser utilizado para instalao dever estar conectado a internet, pois os pacotes sero baixados dos repositrios. 1. Revises
Nro 1 2 Data 21/09/09 15/10/09 Observaes Criao deste documento Atualizao Manual

2. Instalao Ubuntu Server 8.04 LTS

2.1 - Download No site http://www.ubuntu.com/getubuntu/download-server tem disponvel para download a verso 8.04LTS de acordo com a sua arquitetura 32 ou 64 bits. 2.2 - Instalao A instalao do Ubuntu Server deve ser padro. Para maiores informaes acessar: https://help.ubuntu.com/8.04/serverguide/C/index.html 2.3 - Usurio Administrador Na instalao do Ubuntu devemos criar um usurio para administrar o Servidor do e-cidade. No nosso caso criamos o usurio chamado dbseller 2.4 Edio arquivos de configurao Sugerimos utilizar o editor vim para edio dos arquivos de configurao que sero alterados nessa instalao. Mais informaes sobre o vim podem ser obtidas em: http://www.vim.org 2.5 Observaes Esse manual contempla a instalao de um Servidor para uso do e-cidade, necessitando ento que o usurio tenha outro computador para acesso, via Firefox, ao sistema ou instale o ambiente grfico no servidor (no recomendado para ambientes de produo):
$sudoaptgetinstallubuntudesktop

3. Instalao PostgreSQL 8.2 (sem otimizao de performance)

3.1 - Instalao Para instalar o PostgreSQL 8.2 basta utilizar a ferramenta apt-get:
$sudoaptgetupdate $sudoaptgetinstallpostgresql8.2

3.2 - Configurao Cluster Devemos utilizar no Cluster do PostgreSQL 8.2 onde ser instalado o DBPortal2 o encoding LATIN1 (ISO-8859-1) a) Editar o /etc/postgresql/8.2/main/pg_hba.conf e deixar conforme segue:
$sudovim/etc/postgresql/8.2/main/pg_hba.conf Alteraraslinhasnofinaldoarquivoqueestosemo#,colocandotrustnolugardaltimacolula: localallalltrust hostallall127.0.0.1/32trust hostallall::1/128trust

b) Recarregar as configuraes do PostgreSQL:

$sudo/etc/init.d/postgresql8.2reload

c) Verificar cluster atual:

$psqlUpostgreshlocalhostl Listofdatabases Name|Owner|Encoding ++ postgres|postgres|UTF8 template0|postgres|UTF8 template1|postgres|UTF8 (3rows)

No caso acima precisamos recriar o cluster executando os prximos passos d) Remover o cluster atual:
$sudopg_dropclusterstop8.2main

c) Criar novo cluster como LATIN1:

$sudopg_createclustereLATIN18.2main $sudo/etc/init.d/postgresql8.2start

e) Editar o /etc/postgresql/8.2/main/pg_hba.conf e deixar conforme segue:

$sudovim/etc/postgresql/8.2/main/pg_hba.conf Alteraraslinhasnofinaldoarquivoqueestosemo#,colocandotrustnolugardaltimacolula: localallalltrust hostallall127.0.0.1/32trust hostallall::1/128trust

f) Recarregar as configuraes do PostgreSQL:

$sudo/etc/init.d/postgresql8.2reload

g) Aps a recriao do cluster o resultado da verificao deve ser o que segue:

$psqlUpostgreshlocalhostl Listofdatabases Name|Owner|Encoding

++ postgres|postgres|LATIN1 template0|postgres|LATIN1 template1|postgres|LATIN1 (3rows)

3.3 - Configurao Principal (/etc/postgresql/8.2/main/postgresql.conf) a) Configuraes a serem alteradas no postgresql.conf (o restante dos parmetros ficam inalterados):
$sudovim/etc/postgresql/8.2/main/postgresql.conf max_fsm_pages=81000 max_fsm_relations=5000 checkpoint_segments=16 redirect_stderr=on log_directory='pg_log' log_filename='postgresql%Y%m%d_%H%M%S.log log_min_messages=warning log_min_duration_statement=5000#5segundos log_line_prefix='%t[%p]:[%l1]user=%u,db=%d' autovacuum_naptime=5min autovacuum_vacuum_threshold=50 autovacuum_analyze_threshold=50 autovacuum_vacuum_cost_delay=20 add_missing_from=on default_with_oids=on escape_string_warning=off

b) Reiniciar PostgreSQL:
$sudo/etc/init.d/postgresql8.2restart

3.4 - Configurao Acessos (pg_hba.conf) a) Editar o /etc/postgresql/8.2/main/pg_hba.conf e deixar conforme segue:

$sudovim/etc/postgresql/8.2/main/pg_hba.conf

Alteraraslinhasnofinaldoarquivoqueestosemo#,colocandotrustnolugardaltimacolula: localallalltrust hostallall127.0.0.1/32trust hostallall::1/128trust

b) Recarregar as configuraes do PostgreSQL:

$sudo/etc/init.d/postgresql8.2reload

4. Instalao Apache 2
4.1 - Instalao Para instalar o Apache 2 basta utilizar a ferramenta apt-get:
$sudoaptgetinstallapache2

4.2 - Editar arquivo /etc/apache2/apache2.conf $ sudo vim /etc/apache2/apache2.conf

a) Alterar o parmetro Timeout para 12000

Timeout12000

b) Adicionar as seguintes linhas ao final do arquivo:

#linhasadicionadasparaoecidade LimitRequestLine16382 LimitRequestFieldSize16382

4.3 - Editar arquivo /etc/apache2/conf.d/charset a) Alterar o parmetro AddDefaultCharset

AddDefaultCharsetISO88591

ATENO! Cuidado para no deixar o AddDefaultCharset comentado, ou seja, com o caracter # no inicio!! 4.4 - Criao Pasta Arquivos Temporrios a) Deve ser criada uma pasta tmp no DOCUMENT_ROOT do Apache (/var/www)
$sudomkdir/var/www/tmp $sudochownRwwwdata.wwwdata/var/www/tmp $sudochmodR777/var/www/tmp

b) Adicionar o usurio que ir administrar o DBPortal2 no grupo www-data, no nosso caso foi criado um usurio, na instalao do Ubuntu, chamado dbseller
$sudovim/etc/group (adicionarousuriodbsellerouoquevoccriounoitem2aogrupowwwdata) wwwdata:x:33:dbseller

5. Instalao PHP 5
5.1 - Instalao Para instalar o PHP 5 e os mdulos necessrios basta utilizar a ferramenta apt-get:
$sudoaptgetinstallphp5php5gdphp5pgsqlphp5cliphp5mhashphp5mcrypt

ATENO! As bibliotecas bcmath e DOM devem estar instaladas tambm. Nas distribuies baseadas em Debian elas vem compiladas junto ao pacote do PHP5-COMMON e no existe em separado, mas em outras distribuies Linux isso pode ser diferente. 5.1 - Configurao a) Criar pasta para os logs do PHP5
$sudomkdir/var/www/log $sudochownRwwwdata.wwwdata/var/www/log

b) Editar o arquivo /etc/php5/apache2/php.ini e modificar os parmetros: Observaes: os parmetros a serem configurados que na linha iniciam com o caracter #, este deve ser retirado. $ sudo vim /etc/php5/apache2/php.ini
register_globals=on register_long_arrays=on register_argc_argv=on post_max_size=64M magic_quotes_gpc=on upload_max_filesize=64M

default_socket_timeout=60000 max_execution_time=60000 max_input_time=60000 memory_limit=512M allow_call_time_pass_reference=on error_reporting=E_ALL&~E_NOTICE display_errors=off log_errors=on error_log=/var/www/log/phpscripts.log session.gc_maxlifetime=7200

c) Reiniciar Servidor Web Apache

$sudo/etc/init.d/apache2restart

6. Instalao OpenOffice
6.1 - Instalao Para instalar o OpenOffice basta utilizar a ferramenta apt-get:
$sudoaptgetinstallopenoffice.orgheadlessopenoffice.orgjavacommonsunjava6jre

6.2 - Configurao Adicione o que segue ao arquivo /etc/rc.local antes da linha que contm exit 0
$sudovim/etc/rc.local /usr/bin/sofficeaccept="socket,host=localhost,port=8100;urp;"nofirststartwizardheadless& exit0

7. Instalao e-cidade
7.1 - Introduo Antes de mais nada devemos obter o pacote com a verso desejada, e para isso precisamos entender a nomenclatura de um pacote do software conforme segue: ecidadeVERSAO.RELEASE.SUBRELEASESISTEMAOPERACIONAL.TIPO.tar.bz2

VERSAO: Nmero da verso do e-cidade. Ex: 2 RELEASE: Nmero da release atual do e-cidade. Ex: 2 SUBRELEASE: Nmero da sub-release (tambm chamado de compilao) do e-cidade. Ex: 9 SISTEMAOPERACIONAL: Sistema Operacional para o qual foi gerado o pacote de instalao. Atualmente somente "linux" suportado TIPO: Tipo do Pacote, se no existir nenhum comentrio ento esse um pacote de atualizao de verso, caso contrrio ser indicado pelo termo "completo" que um pacote para uma nova instalao.

Um exemplo do pacotes da verso 2.2.9 ficaria assim:

ecidade2.2.9linux.tar.bz2(atualizaoparaverso2.2.9) ecidade2.2.9linux.completo.tar.bz2(pacoteparanovainstalaodaverso2.2.9)

7.2 - Criao Base de Dados do e-cidade Para exemplificar a instalao utilizaremos o pacote denominado "e-cidade-2.2.9-linux.completo.tar.bz2" que dever ser baixado do Portal do Software Pblico, comunidade e-cidade. 1. Descompactar o pacote no diretrio /tmp

$cd/tmp [Baixaropacote] $sudotarjxvfecidade2.2.9linux.completo.tar.bz2

2. Criao da base de dados (chamaremos a base de "e-cidade")

$sudocdecidade2.2.9linux.completo/sql $psqlUpostgreshlocalhosttemplate1ccreateroledbportalwithsuperuserloginpassword 'dbportal' $psqlUpostgreshlocalhosttemplate1ccreateroledbsellerwithloginpassword'dbseller' $createdbUdbportalecidade $psqlUdbportalecidadefecidade2.2.9.sql

7.2 - Instalao do e-cidade ( ) a) Acessar o pacote e copiar programas para pasta do Apache2
$cd/tmp/ecidade2.2.9linux.completo $sudocprecidade/var/www

b) Ajustar permisses da pasta

$sudochownRdbseller.wwwdata/var/www/ecidade $sudochmodR775/var/www/ecidade $sudochmodR777/var/www/ecidade/tmp

c) Configurar acesso a base de dados ( conferncia )

$sudovim/var/www/ecidade/libs/db_conn.php (Ajustarasvariveis:) $DB_USUARIO='dbportal'; $DB_SENHA='';//Ousefordefinidaalgumasenhaparaousuariodbportalnopostgresql $DB_SERVIDOR='localhost'; $DB_PORTA='5432'; $DB_PORTA_ALT='5432'; $DB_BASE='ecidade';

7.3 Acesso ao e-cidade a) Se voc optou por instalar o ambiente grfico (ubuntu-desktop) junto ao servidor conforme descrito no item 2.5 ento basta abrir o navegador Firefox e acessar a url: http://localhost/e-cidade b) Caso voc tenha instalado o servidor sem ambiente grfico, ento apartir de um computador desktop abra o navegador Firefox e acesse a url: http://<ip_do_servidor>/e-cidade Onde ip_do_servidor indica o entereo IP atribudo na instalao do servidor Ubuntu. c) Na tela de login do e-cidade informar o usurio dbseller e deixar a senha em branco. ATENO! O Firefox deve estar com as pop-up habilitadas para o IP do Servidor para que o e-cidade possa funcionar.

7.4 - Instalao do e-cidadeonline O pacote e-cidadeonline o servio disponvel ao cidado. a) Acessar o pacote e copiar programas para pasta do Apache2
$cd/tmp/ecidade2.2.9linux.completo $sudocprecidadeonline/var/www

b) Ajustar permisses da pasta

$sudochownRdbseller.wwwdata/var/www/ecidadeonline $sudochmodR775/var/www/ecidadeonline $sudochmodR777/var/www/ecidadeonline/tmp

c) Configurar acesso a base de dados ( conferncia )

$sudovim/var/www/ecidadeonline/libs/db_conn.php (Ajustarasvariveis:) $DB_INSTITUICAO=1; $DB_SENHA='';//Ousefordefinidaalgumasenhaparaousuariodbportalnopostgresql $DB_SERVIDOR='localhost'; $DB_PORTA='5432'; $DB_BASEDADOS='ecidade';

8. Glossrio
Termo
encoding cluster apt-get Vim Firefox DBSeller Sistemas

Significado
http://en.wikipedia.org/wiki/Character_encoding http://www.postgresql.org/docs/8.2/interactive/creating-cluster.html http://www.debian.org/doc/manuals/apt-howto http://pt.wikipedia.org/wiki/Advanced_Packaging_Tool http://www.vim.org http://www.mozilla.org/firefox http://www.dbseller.com.br