TtuloManual Instalao e-cidade no Ubuntu Server 12.04 LTS

AutorFabrzio de Royes Mello, Felipe Diefenbach

ColaboraoLus Fernando Paiva Smia Gerncia de Inovaes Tecnolgicas - DSI/MPOG

DireitosDBSeller Servios de Informtica LTDA.

Data Criao05/11/12

ImportantePara 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.

Revises

NroDataObservaes

Instalao Ubuntu Server 12.04 LTS

2.1 - DownloadNo site http://www.ubuntu.com/getubuntu/download-server existem disponveis para download a verso 12.04LTS de acordo com a sua arquitetura 32 ou 64 bits.Dica: Se o seu servidor possuir mais de 4GB de memria RAM ento instale a verso 64 bits do sistema operacional.

2.2 - InstalaoA instalao do Ubuntu Server deve ser padro. Para maiores informaes acessar:https://help.ubuntu.com/12.04/serverguide/C/index.html

2.3 Edio arquivos de configuraoSugerimos 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.4 ObservaesEsse 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), durante a instalao do servidor voc deve fornecer um nome de usurio diferente de dbseller, pois mais adiante o mesmo ser utilizado para administrar o E-cidade:$ sudo apt-get install ubuntu-desktop

Instalao PostgreSQL 9.2 (sem otimizao de performance)

3.1 - PreparaoPara instalar o PostgreSQL 9.2 teremos de utilizar uma ferramenta do apt chamada apt-add-repository que nos prove as ltimas atualizaes dos pacotes requeridos atravs de um canal seguro e confivel uma vez que os pacotes so distribudos pelos mantenedores do pacote no Ubuntu server 12.04. Para isso precisamos realizar os seguintes passos:

Certifique-se de ter instaldo o pacote: $ sudo apt-get install python-software-properties

Em seguida adicione os seguintes repositrios com o comando apt-add-repository

$ sudo apt-add-repository ppa:pitti/postgresql

Observaes: Maiores detalhes sobre a utilizao do repositrio podem ser encontradas no site https://launchpad.net/~pitti/+archive/postgresql

3.2 - InstalaoPara instalar o PostgreSQL 9.2 basta utilizar a ferramenta apt-get:$ sudo apt-get update$ sudo apt-get install postgresql-9.2 postgresql-contrib-9.2

3.3 - Configurao Cluster

Devemos utilizar o encoding LATIN1 (ISO-8859-1) no Cluster do PostgreSQL 9.2 onde ser instalado o e-cidade.

a) Remover o cluster atual:$ sudo pg_dropcluster --stop 9.2 main

b) Corrigir a ordenao do encode no ISO-8859-1:

$ sudo vi /usr/share/i18n/locales/pt_BR

c) Adicionar no trecho do LC_COLLATE as linhas a seguir, entre LC_COLLATE e END LC_COLLATE:

LC_COLLATEcopy "iso14651_t1"

reorder-after ;;;reorder-end

END LC_COLLATE

d) Redefinir o locale

$ sudo localedef -i pt_BR -c -f ISO-8859-1 -A /usr/share/locale/locale.alias pt_BR

e) regerar o locale alterado e reconfigurar o sistema para fazer uso dele:

$ sudo locale-gen pt_BR$ sudo dpkg-reconfigure locales$ export LC_ALL=pt_BR$ sudo echo LC_ALL=pt_BR >> /etc/environment

f) Criar novo cluster como LATIN1:

$ sudo pg_createcluster -e LATIN1 9.2 main

g) Iniciar servidor PostgreSQL$ sudo /etc/init.d/postgresql start

h) Editar o /etc/postgresql/9.2/main/pg_hba.conf e deixar conforme segue:$ sudo vim /etc/postgresql/9.2/main/pg_hba.conf

Alterar as linhas no final do arquivo que esto sem o #, colocando trust no lugar da ltima coluna:

local all all trust host all all 127.0.0.1/32 trusthost all all ::1/128 trust

i) Recarregar as configuraes do PostgreSQL:

$ sudo /etc/init.d/postgresql reload

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

$ psql -U postgres -h localhost -l List of databases Name | Owner | Encoding --------------------------------+----------+---------- postgres | postgres | LATIN1 template0 | postgres | LATIN1 template1 | postgres | LATIN1 (3 rows)

3.4 - Configurao Principal (/etc/postgresql/9.2/main/postgresql.conf)

a) Configuraes a serem alteradas no postgresql.conf (o restante dos parmetros ficam inalterados):

$ sudo vim /etc/postgresql/9.2/main/postgresql.conf

listen_addresses = '*'max_connections = 20bytea_output = 'escape'

max_locks_per_transaction = 256

default_with_oids = on escape_string_warning = offstandard_conforming_strings = off

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

Instalao Apache 2

4.1 - Instalao

Para instalar o Apache 2 basta utilizar a ferramenta apt-get:$ sudo apt-get install apache2

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

a) Alterar o parmetro Timeout para 12000

Timeout 12000

Dica: Caso voc utilize proxy (squid) na sua rede tem que atentar para o read timeout do mesmo em que o padro 10 minutos, e dependendo do processamento a ser efetuado no sistema, um programa pode levar bem mais de 10 minutos para executar (Ex: Clculo de Folha de Pagamento) ento ser necessrio aumentar o valor desse parmetro.

b) Adicionar as seguintes linhas ao final do arquivo:

# linhas adicionadas para o e-cidadeLimitRequestLine 16382
LimitRequestFieldSize 16382

4.3 - Editar arquivo /etc/apache2/conf.d/charset

a) Alterar o parmetro AddDefaultCharset

AddDefaultCharset ISO-8859-1

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)

$ sudo mkdir /var/www/tmp$ sudo chown -R www-data.www-data /var/www/tmp$ sudo chmod -R 777 /var/www/tmp

Instalao PHP 5

5.1 - Instalao

Para instalar o PHP 5 e os mdulos necessrios basta utilizar a ferramenta apt-get:

$ sudo apt-get install php5 php5-gd php5-pgsql php5-cli php5-mhash php5-mcrypt

ATENO! As bibliotecas bcmath, DOM e mbstring devem estar instaladas tambm. Nas distribuies baseadas em Debian elas vem compiladas junto ao pacote do PHP5 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$ sudo mkdir /var/www/log$ sudo chown -R www-data.www-data /var/www/log

b) Acertar permisses do /var/lib/php5$ sudo chown root.www-data /var/lib/php5$ sudo chmod g+r /var/lib/php5

c) 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.iniregister_globals = onregister_long_arrays = onregister_argc_argv = onpost_max_size = 64Mmagic_quotes_gpc = onupload_max_filesize = 64Mdefault_socket_timeout = 60000max_execution_time = 60000max_input_time = 60000memory_limit = 512Mallow_call_time_pass_reference = onerror_reporting = E_ALL & ~E_NOTICEdisplay_errors = offlog_errors = onerror_log = /var/www/log/php-scripts.logsession.gc_maxlifetime = 7200

d) Reiniciar Servidor Web Apache$ sudo /etc/init.d/apache2 restart

Instalao LibreOffice

6.1 - InstalaoPara instalar o LibreOffice basta utilizar a ferramenta apt-get:$ sudo apt-get install libreoffice-writer python-uno openjdk-6-jre

6.2 - ConfiguraoAdicione o que est em "negrito" ao arquivo /etc/rc.local. Antes da linha que contm exit 0:

$ sudo vim /etc/rc.local/usr/bin/soffice -accept="socket,host=localhost,port=8100;urp;" -nofirststartwizard -headless &exit 0

ATENO!! Caso voc utilize outra distribuio Linux ou instalou o OpenOffice de outra forma, deve verificar o arquivo "/var/www/e-cidade/bin/oo2pdf/oo2pdf.sh" para ajustar corretamente o caminho do OpenOffice na varivel "OOFFICE" e do Python na varivel "OOOPYTHON" para que a integrao do e-cidade com o OpenOffice funcione corretamente.

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:e-cidade-VERSAO.RELEASE.SUBRELEASE-SISTEMAOPERACIONAL.TIPO.tar.bz2VERSAO: Nmero da verso do e-cidade. Ex: 2

RELEASE: Nmero da release atual do e-cidade. Ex: 3

SUBRELEASE: Nmero da sub-release (tambm chamado de compilao) do e-cidade. Ex: 3

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 pacote da verso 2.3.3 ficaria assim:e-cidade-2.3.3-linux.completo.tar.bz2 (pacote para nova instalao da verso 2.3.3)

7.2 - Usurio AdministradorDevemos criar um usurio para administrar o e-cidade. Criaremos ento o usurio dbseller.

a) Criando o usurio no grupo correto.$ sudo useradd -d /home/dbseller -g www-data -k /etc/skel -m -s /bin/bash dbseller$ sudo passwd dbseller (definir a senha default como dbseller)

b) Para corrigir as permisses de criao de arquivos devemos modificar o login.defs e setarmos o parmetro umask para ao valor 002 da seguinte maneira:

$ sudo vi /etc/login.defs

UMASK 002

Observaes: os parmetros a serem configurados que na linha iniciam com o caracter #, este deve ser retirado.

7.3 - Criao Base de Dados do e-cidade

Para exemplificar a instalao utilizaremos o pacote denominado "e-cidade-2.3.3-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$ sudo tar jxvf e-cidade-2.3.3-linux.completo.tar.bz2

2. Criao da base de dados (chamaremos a base de "e-cidade")$ sudo cd e-cidade-2.3.3-linux.completo/sql$ psql -U postgres -h localhost template1 -c "create role ecidade with superuser login password 'ecidade'" $ psql -U postgres -h localhost template1 -c "create role dbseller with login password 'dbseller'"$ createdb -U ecidade e-cidade$ psql -U ecidade e-cidade -f e-cidade-2.3.3.sql 2> /tmp/erros.txt$ vim /tmp/erros.txt$ psql -U ecidade e-cidade -c "VACUUM ANALYZE VERBOSE;"

Observaes: Caso voc queira instalar o e-cidade utilizando uma base de dados para demonstrao, ou seja, com dados fictcios ento no item 2, linha 5 ao invs de recuperar o arquivo e-cidade-2.3.3.sql mude para e-cidade-demo-2.3.3.sql.

7.4 - Instalao do pacote do e-cidade

a) Acessar o pacote e copiar programas para pasta do Apache2$ cd /tmp/e-cidade-2.3.3-linux.completo$ sudo cp -r e-cidade /var/www

b) Ajustar permisses da pasta$ sudo chown -R dbseller.www-data /var/www/e-cidade$ sudo chmod -R 775 /var/www/e-cidade$ sudo chmod -R 777 /var/www/e-cidade/tmp

c) Configurar acesso a base de dados ( conferncia )$ sudo vim /var/www/e-cidade/libs/db_conn.php

(Ajustar as variveis:)$DB_USUARIO = 'ecidade';$DB_SENHA = ''; // Ou se for definida alguma senha para o usuario ecidade no postgresql$DB_SERVIDOR = 'localhost';$DB_PORTA = '5432';$DB_PORTA_ALT = '5432';$DB_BASE = 'e-cidade';

7.5 Acesso ao e-cidade

a) Se voc optou por instalar o ambiente grfico (ubuntu-desktop) junto ao servidor conforme descrito no item 2.4 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:///e-cidadeOnde 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.6 - 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/e-cidade-2.3.3-linux.completo$ sudo cp -r e-cidadeonline /var/www

b) Ajustar permisses da pasta$ sudo chown -R dbseller.www-data /var/www/e-cidadeonline$ sudo chmod -R 775 /var/www/e-cidadeonline$ sudo chmod -R 777 /var/www/e-cidadeonline/tmp

c) Configurar acesso a base de dados ( conferncia )$ sudo vim /var/www/e-cidadeonline/libs/db_conn.php (Ajustar as variveis:)

$DB_INSTITUICAO = 1;$DB_SERVIDOR = 'localhost';$DB_BASEDADOS = 'e-cidade';$DB_USUARIO = 'ecidade';$DB_SENHA = ''; // Ou se for definida alguma senha para o usuario ecidade no postgresql$DB_PORTA = '5432';

Glossrio

TermoSignificado

encodinghttp://en.wikipedia.org/wiki/Character_encoding

clusterhttp://www.postgresql.org/docs/8.2/interactive/creating-cluster.html

apt-gethttp://www.debian.org/doc/manuals/apt-howtohttp://pt.wikipedia.org/wiki/Advanced_Packaging_Tool

Vimhttp://www.vim.org

Firefoxhttp://www.mozilla.org/firefox

DBSeller Sistemashttp://www.dbseller.com.br

proxyhttp://pt.wikipedia.org/wiki/Proxy

squidhttp://pt.wikipedia.org/wiki/Squid

Manual Instalao e-cidade no Ubuntu Server 12.04 LTSVerso 1.005/11/2011

Pgina /