source: publico/ILSAAP/install/2.0-beta/LEIAME.txt @ 3911

Última Alteração nesse arquivo desde 3911 foi 3911, incluída por jeanferri, 12 anos atrás

Corrigido instalador do produto ILSAAP

  • Propriedade svn:executable mudada para *
File size: 7.5 KB
Linha 
1
2================================
3Instalador Unificado do SAAP 2.0
4================================
5Mantenedor: Jean Rodrigo Ferri (jeanferri em interlegis.gov.br)
6Sugestões/reportar problemas: http://colab.interlegis.gov.br/newticket
7Este documento foi modificado em: 10 de Março de 2009
8
9Importante: Faça uma cópia de segurança do seu atual site SAAP antes de executar este instalador.
10
11
12Instruções de Instalação
13========================
14Para instalar o SAAP 2.0, abra um terminal, vá para o diretório do instalador e execute o seguinte comando:
15    >> sudo ./install.sh  (ou `su; ./install.sh` em um sistema sem sudo)
16
17O instalador irá compilar o Python, Zope, Plone, e todas as bibliotecas dependentes a partir do código fonte.
18
19
20Instruções de Atualização
21=========================
22Não são suportadas atualizações automáticas pelo instalador. Para atualizar o seu site, você precisará completar os seguintes passos:
23
241) Instalar o SAAP com o Instalador Unificado (localização padrão: /var/interlegis/SAAP-2.0)
25
262) Parar a instância existente do SAAP em /var/interlegis/SAAP-2.0-beta
27    >> sudo /var/interlegis/SAAP-2.0-beta/instance/bin/zopectl stop
28
293) Copiar o seu arquivo Data.fs de /var/interlegis/SAAP-2.0-beta/instance/var/Data.fs para /var/interlegis/SAAP-2.0/instance/var
30    >> cp /var/interlegis/SAAP-2.0-beta/instance/var/Data.fs /var/interlegis/SAAP-2.0/instance/var/Data.fs
31
324) Migrar qualquer produto extra ou customizado para a nova instalação
33    >> cp -a /var/interlegis/SAAP-2.0-beta/instance/Products/<PRODUTO> /var/interlegis/SAAP-2.0/instances/Product/<PRODUTO>
34
355) Inicializar a nova instância do SAAP em /var/interlegis/SAAP-2.0
36    >> sudo /var/interlegis/SAAP-2.0/instance/bin/zopectl start
37
386) Clicar no botão 'Upgrade' na aba 'Migrate' no portal_migration (ZMI).
39
407) Clicar no botão 'Upgrade' na aba 'Version Migration' no portal_atct (ZMI).
41
428) Reinstalar os produtos atualizados na instância do SAAP em 'Configurações do Site' -> 'Adicionar/Remover produtos' (ou via portal_quickinstaller na ZMI)
43
44Observação: Instruções sobre como atualizar a partir de versões anteriores ao SAAP 2.0-beta estão fora do escopo deste documento.
45
46Instruções detalhadas sobre atualização podem ser encontradas em http://colab.interlegis.gov.br/wiki/ProjetoSaap e http://plone.org/upgrade
47
48
49Dependências
50============
511) gcc
522) g++ (gcc-c++)
533) GNU make
544) GNU tar
555) gunzip e bunzip2
566) posix-compatível /bin/sh
57
58
59Bibliotecas Recomendadas e Utilidades
60=====================================
61Instalar as bibliotecas antes de executar o instalador.
62As versões de desenvolvimento de alguns pacotes são necessárias para os
63cabeçalhos de instalação.
64
65* libssl (suporte SSL)
66     *Altamente recomendado.*
67     Usado pelo openid e SecureMailHost, necessário para atualizações https.
68     libssl-dev
69* zlib (compressão GZ)
70     O Instalador Unificado instalará ela para você se for necessário, mas as
71     bibliotecas do sistema são geralmente preferíveis.
72     zlib1g-dev
73* libjpeg (suporte jpeg)
74     O Instalador Unificado instalará ela para você se for necessário, mas as
75     bibliotecas do sistema são geralmente preferíveis.
76     libjpeg62-dev
77* readline (histórico da linha de comando do Python)
78     libreadline5-dev readline-common
79* libxml2 (usado pelo marshall)
80     O Instalador Unificado instalará ela para você se for necessário, mas as
81     bibliotecas do sistema são geralmente preferíveis.
82     libxml2-dev
83* libxslt (suporte a XML e XSLT no Python)
84     O Instalador Unificado instalará ela para você se for necessário, mas as
85     bibliotecas do sistema são geralmente preferíveis.
86     libxslt1-dev
87* freetype (habilita as fontes true type em PDFs e imagens)
88     libfreetype6-dev
89* wv (usado para indexar documentos do Word)
90     wv
91     <http://wvware.sourceforge.net/>
92     Pode ser instalado após a instalação do SAAP.
93* xpdf (used to index PDFs)
94     xpdf
95     <http://www.foolabs.com/xpdf/download.html>
96     Pode ser instalado após a instalação do SAAP.
97
98
99Localização da Instalação
100=========================
101- SAAP instalado em /var/interlegis/SAAP-2.0
102- Python instalado em /var/interlegis/SAAP-2.0/Python-2.4
103- Instância do Zope instalada e configurada em /var/interlegis/SAAP-2.0/instance
104- Diretório de produtos do Zope em /var/interlegis/SAAP-2.0/instance/Products
105- Data.fs (ZODB) em /var/interlegis/SAAP-2.0/instance/var
106
107
108Customização do local de instalação
109===================================
110- Modifique $INSTALL_HOME em install.sh para alterar a localização padrão (/var/interlegis/SAAP-2.0)
111- Modifique $PY e $PY_HOME para usar uma máquina virtual Python diferente (ex: o Python do sistema)
112- Modifique $PRODUCTS_HOME para customizar a localização do diretório de produtos (Products/)
113
114
115Senha do Administrador
116======================
117Uma senha aleatória para o administrador é gerada durante a instalação. A senha estará localizada em:
118
119 /var/interlegis/SAAP-2.0/receipts/adminPassword.txt
120
121
122Instruções para Inicializar/Parar/Reiniciar
123===========================================
124Para inicializar o SAAP,
125   $ sudo /var/interlegis/SAAP-2.0/instance/bin/zopectl start
126
127Para parar o SAAP,
128   $ sudo /var/interlegis/SAAP-2.0/instance/bin/zopectl stop
129
130Para reiniciar o SAAP,
131   $ sudo /var/interlegis/SAAP-2.0/instance/bin/zopectl restart
132
133
134Portas
135======
136- Instância do Zope rodando na porta 8280
137
138
139Instruções Pós-instalação
140=========================
141Você precisará adicionar manualmente um site SAAP na instância do Zope autenticando-se como administrador em
142
143http://localhost:8280/manage
144
145(Use a senha de administrador (admin) fornecida em /var/interlegis/SAAP-2.0/receipts/adminPassword.txt)
146
147Selecione "Plone Site" no menu superior direito para adicionar um site SAAP.
148Selecione "SAAP" em "Extension Profiles" e clique no botão "Add Plone Site".
149Isto precisá ser feito somente uma vez (por cluster ZEO) para cada site SAAP que você deseja adicionar.
150
151Para alterar a senha do administrador, clique no link "Password" para o usuário "admin" em
152
153http://localhost:8280/acl_users/users/manage_users
154
155
156Produtos extra instalados
157=========================
158- PIL (biblioteca de imagens do Python)
159- PyXML (processador XML)
160- ReportLab (ferramentas para PDF)
161- TextIndexNG3 (módulo de indexação de texto)
162- python-openid (suporte ao OpenID)
163- libxml2, libxslt, libxml2-python (suporte a manipuladores)
164- setuptools (suporte ao easy_install)
165
166
167Testado nos seguintes ambientes operacionais
168============================================
169- Ubuntu 6.06, 8.04
170- Fedora 10
171- Debian Etch
172- FreeBSD 6.1, 6.2
173- Mac OS X.4, X.5 (Intel/PowerPC)
174
175
176Instruções para desistalação
177============================
1781) Parar o SAAP
1792) Remover o diretório /var/interlegis/SAAP-2.0
180
181
182Instruções para cópia de segurança (backup)
183===========================================
1841) Parar o SAAP
1852) Copiar o diretório /var/interlegis/SAAP-2.0
186   $ tar -zcvf SAAP-2.0-backup.tgz /var/interlegis/SAAP-2.0
187   ..ou..
188   $ tar -jcvf SAAP-2.0-backup.tar.bz2 /var/interlegis/SAAP-2.0
189
190
191Coexistência com o Python do Sistema
192====================================
193O Python instalado pelo Instalador Unificado não irá interferir em qualquer outro Python do seu sistema.
194O instalador isolou o Python 2.4.6 no diretório /var/interlegis/SAAP-2.0/Python-2.4
195
196
197Documentação
198============
199http://colab.interlegis.gov.br/wiki/ProjetoSaap
200
201
202Reportação de Problemas Sobre o Instalador
203==========================================
204Por favor utilize o gerenciador de tickets do SAAP em http://colab.interlegis.gov.br/ para reportar qualquer problema.
205
Note: Veja TracBrowser para ajuda no uso do navegador do trac.
 

The contents and data of this website are published under license:
Creative Commons 4.0 Brasil - Atribuir Fonte - Compartilhar Igual.