source: publico/ILSAAP/install/2.0/LEIAME.txt

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

Finalizando alterações nos scripts de instalação do SAAP 2.0 versão beta

  • Propriedade svn:executable mudada para *
File size: 7.2 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: 11 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     libxml2-dev
81* libxslt (suporte a XML e XSLT no Python)
82     libxslt1-dev
83* freetype (habilita as fontes true type em PDFs e imagens)
84     libfreetype6-dev
85* wv (usado para indexar documentos do Word)
86     wv
87     <http://wvware.sourceforge.net/>
88     Pode ser instalado após a instalação do SAAP.
89* xpdf (used to index PDFs)
90     xpdf
91     <http://www.foolabs.com/xpdf/download.html>
92     Pode ser instalado após a instalação do SAAP.
93
94
95Localização da Instalação
96=========================
97- SAAP instalado em /var/interlegis/SAAP-2.0
98- Python instalado em /var/interlegis/SAAP-2.0/Python-2.4
99- Instância do Zope instalada e configurada em /var/interlegis/SAAP-2.0/instance
100- Diretório de produtos do Zope em /var/interlegis/SAAP-2.0/instance/Products
101- Data.fs (ZODB) em /var/interlegis/SAAP-2.0/instance/var
102
103
104Customização do local de instalação
105===================================
106- Modifique $INSTALL_HOME em install.sh para alterar a localização padrão (/var/interlegis/SAAP-2.0)
107- Modifique $PY e $PY_HOME para usar uma máquina virtual Python diferente (ex: o Python do sistema)
108- Modifique $PRODUCTS_HOME para customizar a localização do diretório de produtos (Products/)
109
110
111Senha do Administrador
112======================
113Uma senha aleatória para o administrador é gerada durante a instalação. A senha estará localizada em:
114
115 /var/interlegis/SAAP-2.0/receipts/adminPassword.txt
116
117
118Instruções para Inicializar/Parar/Reiniciar
119===========================================
120Para inicializar o SAAP,
121   $ sudo /var/interlegis/SAAP-2.0/instance/bin/zopectl start
122
123Para parar o SAAP,
124   $ sudo /var/interlegis/SAAP-2.0/instance/bin/zopectl stop
125
126Para reiniciar o SAAP,
127   $ sudo /var/interlegis/SAAP-2.0/instance/bin/zopectl restart
128
129
130Portas
131======
132- Instância do Zope rodando na porta 8280
133
134
135Instruções Pós-instalação
136=========================
137Você precisará adicionar manualmente um site SAAP na instância do Zope autenticando-se como administrador em
138
139http://localhost:8280/manage
140
141(Use a senha de administrador (admin) fornecida em /var/interlegis/SAAP-2.0/receipts/adminPassword.txt)
142
143Selecione "Plone Site" no menu superior direito para adicionar um site SAAP.
144Selecione "SAAP" em "Extension Profiles" e clique no botão "Add Plone Site".
145Isto precisá ser feito somente uma vez (por cluster ZEO) para cada site SAAP que você deseja adicionar.
146
147Para alterar a senha do administrador, clique no link "Password" para o usuário "admin" em
148
149http://localhost:8280/acl_users/users/manage_users
150
151
152Produtos extra instalados
153=========================
154- PIL (biblioteca de imagens do Python)
155- PyXML (processador XML)
156- ReportLab (ferramentas para PDF)
157- TextIndexNG3 (módulo de indexação de texto)
158- python-openid (suporte ao OpenID)
159- libxml2, libxslt, libxml2-python (suporte a manipuladores)
160- setuptools (suporte ao easy_install)
161
162
163Testado nos seguintes ambientes operacionais
164============================================
165- Ubuntu 6.06, 8.04
166- Fedora 10
167- Debian Etch
168- FreeBSD 6.1, 6.2
169- Mac OS X.4, X.5 (Intel/PowerPC)
170
171
172Instruções para desistalação
173============================
1741) Parar o SAAP
1752) Remover o diretório /var/interlegis/SAAP-2.0
176
177
178Instruções para cópia de segurança (backup)
179===========================================
1801) Parar o SAAP
1812) Copiar o diretório /var/interlegis/SAAP-2.0
182   $ tar -zcvf SAAP-2.0-backup.tgz /var/interlegis/SAAP-2.0
183   ..ou..
184   $ tar -jcvf SAAP-2.0-backup.tar.bz2 /var/interlegis/SAAP-2.0
185
186
187Coexistência com o Python do Sistema
188====================================
189O Python instalado pelo Instalador Unificado não irá interferir em qualquer outro Python do seu sistema.
190O instalador isolou o Python 2.4.6 no diretório /var/interlegis/SAAP-2.0/Python-2.4
191
192
193Documentação
194============
195http://colab.interlegis.gov.br/wiki/ProjetoSaap
196
197
198Reportação de Problemas Sobre o Instalador
199==========================================
200Por favor utilize o gerenciador de tickets do SAAP em http://colab.interlegis.gov.br/ para reportar qualquer problema.
201
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.