Relatrio de Entrega de n 4 Produto: SPDO

Instalao e Validao do Sistema

Elaborado por
Consultor PNUD Fabiano Weimar dos Santos

Supervisor
Claudio Morale

Contrato nmero
2011/000260

Verso
001
INTERLEGIS
Comunidade Virtual do Poder Legislativo

ndice
1. Introduo..............................................................................................................................................3 2. Instalao...............................................................................................................................................3 2.1. Instalador Automtico....................................................................................................................3 2.2. Mquinas Virtuais..........................................................................................................................4 3. Utilizando o SPDO................................................................................................................................5 4. Senhas de Acesso...................................................................................................................................6 5. Consideraes Finais.............................................................................................................................9 6. Referncias............................................................................................................................................9

2 1. Introduo
No Relatrio de Entrega de n 1 foram apresentados os casos de uso do sistema SPDO, assim como os modelos de dados, interfaces de usurios e uma detalhada descrio dos programas. No Relatrio de Entrega de n 2 foram descritas as especificaes dos programas. No Relatrio de Entrega de n 3 foi formalizada a entrega dos programas desenvolvidos, publicado todo o cdigo fonte, alm de descrever os testes realizados. Nesse relatrio descrevemos os procedimentos de instalao e configurao do SPDO e sua respectiva validao com algumas distribuies Linux. Esse relatrio tcnico assumir que o leitor esteja familiarizado com as tecnologias Python, Zope, CMF, ZPT e os bancos de dados MySQL e PostgreSQL, requisitos obrigatrios do contrato 2011/000260 que regra esse projeto. Assumir tambm que o leitor seja proficiente na administrao de servidores Linux, nas distribuies Ubuntu e/ou Debian.

3 2. Instalao 3.1 2.1. Instalador Automtico

O Sistema de Protocolo de Documentos SPDO possui um instalador automtico, idealizado para efetuar a instalao em servidores Linux, nas distribuies Ubuntu ou Debian, sem a necessidade de nenhuma configurao. Para instalar o SPDO, acesse o prompt de comandos do sistema com o usurio root e execute o seguinte comando:

$wgetOhttp://repositorio.interlegis.gov.br/il.spdo/trunk/docs/installspdo.sh|sh

O instalador automtico foi testado e validado nas seguintes verses de distribuies Linux:
Ubuntu Ubuntu

10.4 LTS Server 32 bits[1] 11.10 Desktop 64 bits [1] Debian 6 Stable "Squeeze" 32 bits [3] O instalador consiste de um script bash, idealizado para ser facilmente adaptado para suportar novas distribuies Linux. As distribuies acima foram escolhidas pois representam as verses de Linux mais populares no Interlegis. importante ressaltar que a execuo do instalador pode demorar. Isso deve-se ao fato do instalador baixar da internet o Plone [4] verso 4.1.3, assim como todas as dependncias necessrias a instalao do SPDO. O instalador tambm efetua o processo de compilao de diversas bibliotecas em 3

linguagem C e C++, necessrias ao funcionamento do servidor Zope, rotinas de criptografia, gerao de arquivos em formato PDF, etc. Como referncia, um computador rodando o sistema operacional Linux Ubuntu, verso 11.10 64 bits, com processador Intel Core i5 e 4 GB de memria RAM, conectado a internet rpida (com link de 35 Mbits) levou cerca de 13 minutos para instalar todo o sistema. Se seu servidor antigo ou se seu acesso a internet lento, rodar o instalador pode demorar horas e no ser a melhor forma de instalar o SPDO. Por fim, visando facilitar a investigao de problemas na instalao, o script gera um arquivo de log em /tmp/spdo-install.log.

3.2 2.2. Mquinas Virtuais

Pensando naqueles usurios que tem problemas para acessar a internet, o sistema SPDO tambm foi empacotado no formato appliance, ou seja, uma mquina virtual disponvel para download no formato OVA - Open Virtualization Format [2]. Foram disponibilizadas mquinas virtuais validadas nas seguintes distribuies Linux:
Ubuntu

10.4 LTS Server 32 bits [1] Debian 6 Stable "Squeeze" 32 bits [3] Para instalar uma mquina virtual, siga o seguinte procedimento: 1.Acesse a pgina do projeto SPDO no Colab [5] 2.Faa o download da mquina virtual que desejar 3.Instale o VirtualBox [6] em seu servidor. A verso do VirtualBox utilizada na validao do sistema foi 4.1.8. Caso prefira, utilize outro sistema de virtualizao de servidores, desde que o mesmo seja compatvel com o formato OVA. 4.Importe o appliance no VirtualBox, acessado a opo Arquivo Importar Appliance ou ainda pressionando Ctrl-I. 5.Inicie a mquina virtual. 6.Efetue login na mquina virtual, utilizando o usurio de sistema spdo ou root. As senhas de acesso padro esto descritas no item #4 desse relatrio. 7.Utilize o comando ifconfig para descobrir o endereo IP de sua mquina virtual. 8.Utilize um navegador para acessar o endereo http://IP:8380/SPDO, onde IP deve ser substitudo pelo endereo IP da mquina virtual. Antes de executar o passo #5, certifique-se que a configurao de rede da mquina virtual esteja utilizando uma bridge, selecionando o dispositivo de rede adequado. Quando o servidor real conecta-se a rede utilizando um cabo, o dispositivo correto costuma ser eth0. Quando o servidor conecta-se a rede utilizando tecnologia sem fio (WIFI), o dispositivo correto costuma ser wlan0. A definio incorreta do modo de operao da rede ou do dispositivo de rede impedir o acesso ao sistema SPDO.

4 3. Utilizando o SPDO
Depois de instalado o servidor SPDO, utilizando o instalador automtico, abra o navegador e acesse o endereo http://IP:8380/manage, onde IP deve ser substitudo pelo endereo IP do servidor. A senha de acesso est descrita no item #4 desse relatrio. Se voc utilizou o instalador automtico, ser necessrio criar o seu sistema SPDO, instanciando um Plone Site e selecionando a 'policy SPDO default'. Esse procedimento est ilustrado nas 3 imagens a seguir. No entanto, se voc optou por utilizar uma mquina virtual, a porta do servio muda para 8080 e j existir um Plone Site SPDO previamente criado e pronto para uso.

5 4.

Senhas de Acesso
Tanto o instalador automtico quanto as mquinas virtuais possuem o mesmo usurio e senha de acesso ao servidor Zope. Para acessar a Zope Management Interface - ZMI (a interface de gerenciamento do Zope) utilize um navegador e acesse:
ZopeManagementInterface(ZMI) http://IP:8380/manage usurio:admin senha:OFGfizjN

Alm do usurio admin, o sistema SPDO entregue com alguns usurios de teste, que auxiliam no entendimento e avaliao do sistema. So eles: usurio: tiao@macale.net senha:12345 5

usurio: john@small.org senha: 54321 Por padro, o instalador automtico considera que o acesso ao banco de dados MySQL, com o usurio root, no requer senha e, durante a instalao, altera a senha do usurio root no acesso ao banco de dados spdo para a palavra interlegis. Isso no implicaria necessariamente em um problema de segurana, desde que o servidor MySQL esteja escutando apenas no localhost. O acesso ao sistema operacional das mquinas virtuais pode ser feito diretamente na console do sistema ou ainda utilizando um cliente do protocolo SSH. As senhas de acesso so listadas abaixo:
MquinaVirtualUbuntu usurio:spdo senha:interlegis

No ubuntu o usurio root no possui senha. Para acessar o sistema com os privilgios do usuario root, efetue login com um usurio e execute o comando sudo su -
MquinaVirtualDebian usurio:root senha:interlegis

Recomenda-se que as senhas do usurio admin e as senhas dos usurios do sistema operacional (spdo e/ou root) sejam trocadas. A senha de admin deve ser trocada utilizando a interface ZMI (acessando o objeto acl_users). Por sua vez, as senhas no sistema operacional das mquinas virtuais devem ser trocadas utilizando o comando passwd. possvel configurar o SPDO para utilizar um servidor de banco de dados remoto ou mesmo armazenar os anexos em um diretrio especfico do servidor. Para isso, necessrio editar o seguinte arquivo de configurao: /var/interlegis/spdo/zinstance/src/il.spdo/il/spdo/config.py O contedo relevante desse arquivo segue abaixo:
#BancodeDados# DEFAULT_DSN='mysql://root:interlegis@localhost/spdo?charset=utf8' TABLE_ARGS={'mysql_engine':'InnoDB','mysql_charset':'utf8'} CREATE_ALL_TABLES=True #Anexos# PATH_ANEXOS='/var/interlegis/spdo/anexos'

A varivel DEFAULT_DSN deve receber a string de conexo com o banco de dados, de acordo com a sintaxe aceita pelo SQLAlchemy, documentada em [7]. A varivel CREATE_ALL_TABLES permite que o script db.py crie a estrutura de todas as tabelas no banco de dados. 6

O script db.py deve ser executado com os privilgios do usurio root. Para isso, utilize os seguintes comandos: sudo su cd /var/interlegis/spdo/zinstance ./bin/zopepy src/il.spdo/il/spdo/db.py Modificaes realizadas na varivel DEFAULT_DSN devem ser feitas tambm no seguinte arquivo: /var/interlegis/spdo/zinstance/src/il.spdo/il/spdo/profiles/default/saconnections.xml O contedo padro do saconnections.xml segue abaixo: <?xml version="1.0"?> <connections> <connection name="spdo" string="mysql://root:interlegis@localhost/spdo?charset=utf8" /> </connections> Percebe-se que a configurao de banco de dados aqui descrita tem carter global, afetando todos os sistemas SPDO que estejam instalados no servidor. Para ambientes onde exista a necessidade de manter diversos sistemas SPDO em um nico servidor possvel definir as strings de conexo em Configuraes do Site, opo localizada na portlet Tabelas Auxiliares (ltimo link), disponvel apenas para usurios com privilgios administrativos (role Manager). O usurio admin possui esses privilgios e tem sua senha descrita no incio do item #4 desse relatrio.

6 5. Consideraes Finais
Esse documento complementa os Relatrios de Entrega de n 1, 2 e 3, descrevendo os procedimentos de instalao do sistema SPDO, assim como as validaes que o sistema teve em diversas verses de distribuies Linux. Acredita-se que os procedimentos aqui descritos estejam de acordo com as determinaes do contrato 2011/000260 e do Termo de Referncia 135641.

7 6. Referncias
[1] http://www.ubuntu.com/download/ubuntu/download [2] http://en.wikipedia.org/wiki/Open_Virtualization_Format [3] http://www.debian.org/distrib/ [4] http://plone.org/products/plone [5] http://colab.interlegis.gov.br/wiki/SPDO [6] https://www.virtualbox.org/ [7] http://www.sqlalchemy.org/docs/core/engines.html