Manual Instalacao e Cidade Ubuntu 12.04 Server LTS
-
Upload
raydeman-sidon -
Category
Documents
-
view
261 -
download
0
Transcript of Manual Instalacao e Cidade Ubuntu 12.04 Server LTS
Manual Instalao e-cidade no
Ubuntu Server 12.04 LTSVerso 1.0
05/11/2011
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.
1. Revises
NroDataObservaes
2. Instalao Ubuntu Server 12.04 LTS
2.1 - Download
No 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 - Instalao
A 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 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.4 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), 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
3. Instalao PostgreSQL 9.2 (sem otimizao de performance)
3.1 - Preparao
Para 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 - Instalao
Para 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_COLLATE
copy "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 trust
host 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 = 20
bytea_output = 'escape'
max_locks_per_transaction = 256
default_with_oids = on
escape_string_warning = off
standard_conforming_strings = off
b) Reiniciar PostgreSQL:
$ sudo /etc/init.d/postgresql restart
4. 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-cidade
LimitRequestLine 16382LimitRequestFieldSize 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
5. 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.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/php-scripts.log
session.gc_maxlifetime = 7200
d) Reiniciar Servidor Web Apache
$ sudo /etc/init.d/apache2 restart
6. Instalao LibreOffice
6.1 - Instalao
Para instalar o LibreOffice basta utilizar a ferramenta apt-get:
$ sudo apt-get install libreoffice-writer python-uno openjdk-6-jre
6.2 - Configurao
Adicione 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.
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:
e-cidade-VERSAO.RELEASE.SUBRELEASE-SISTEMAOPERACIONAL.TIPO.tar.bz2
VERSAO: 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 Administrador
Devemos 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-cidadeb) 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-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.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';
8. 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
Pgina 2/12