source: publico/ILSAAP/install/2.0-beta/README.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: 6.6 KB
Linha 
1
2==========================
3SAAP 2.0 Unified Installer
4==========================
5Maintainer: Jean Rodrigo Ferri (jeanferri at interlegis.gov.br)
6Feedback/bug reports: http://colab.interlegis.gov.br/newticket
7This document last modified: 10 March 2009
8
9Important: Back up your existing SAAP site prior to running the installer.
10
11
12Installation Instructions
13=========================
14To install SAAP 2.0, cd to the installer directory and issue the following command:
15    >> sudo ./install.sh  (or `su; ./install.sh` on a sudo-less system)
16
17The installer will compile Python, Zope, Plone, and all required libraries from source.
18
19
20Upgrade Instructions
21====================
22Installer-based automatic upgrades are not supported. To upgrade your site, you will need to complete the following steps:
23
241) Install SAAP with the Unified Installer (default location: /var/interlegis/SAAP-2.0)
25
262) Stop the existing SAAP instance at /var/interlegis/SAAP-2.0-beta
27    >> sudo /var/interlegis/SAAP-2.0-beta/instance/bin/zopectl stop
28
293) Copy your Data.fs file from /var/interlegis/SAAP-2.0-beta/instance/var/Data.fs to /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) Migrate any third-party or custom products to the new setup
33    >> cp -r /var/interlegis/SAAP-2.0-beta/instance/Products/<CUSTOM_PRODUCT> /var/interlegis/SAAP-2.0/instance/Products/<CUSTOM_PRODUCT>
34
355) Start the new SAAP instance at /var/interlegis/SAAP-2.0
36    >> sudo /var/interlegis/SAAP-2.0/instance/bin/zopectl start
37
386) Click the 'Upgrade' button in the 'Migrate' tab in portal_migration (ZMI).
39
407) Click the 'Upgrade' button in the 'Version Migration' tab in portal_atct (ZMI).
41
428) Reinstall updated products in SAAP instance at Site Setup -> Add/Remove Products (or via portal_quickinstaller in ZMI)
43
44Note: Instructions on how to upgrade from versions prior to SAAP 2.0-beta are beyond the scope of this document.
45
46Detailed upgrade instructions are at http://colab.interlegis.gov.br/wiki/ProjetoSaap and http://plone.org/upgrade
47
48
49Dependencies
50============
511) gcc
522) g++ (gcc-c++)
533) GNU make
544) GNU tar
555) gunzip and bunzip2
566) posix-compliant /bin/sh
57
58
59Recommended Libraries and Utilities
60===================================
61Install libraries prior to running installer.
62Development versions of some packages are required for headers.
63
64* libssl (SSL support)
65     *Strongly recommended.*
66     Used by openid and SecureMailHost; needed for https updates.
67     libssl-dev
68* zlib (GZ compression)
69     The Unified Installer will install this for you if necessary,
70     but system libraries are usually preferable.
71     zlib1g-dev
72* libjpeg (jpeg support)
73     The Unified Installer will install this for you if necessary,
74     but system libraries are usually preferable.
75     libjpeg62-dev
76* readline (Python command-line history)
77     libreadline5-dev readline-common
78* libxml2 (used by marshall)
79     The Unified Installer will install this for you if necessary,
80     but system libraries are usually preferable.
81     libxml2-dev
82* libxslt (Python XML and XSLT support)
83     The Unified Installer will install this for you if necessary,
84     but system libraries are usually preferable.
85     libxslt1-dev
86* freetype (enables true type fonts in PDFs and Images)
87     libfreetype6-dev
88* wv (used to index Word documents)
89     wv
90     <http://wvware.sourceforge.net/>
91     May be installed after Plone install.
92* xpdf (used to index PDFs)
93     xpdf
94     <http://www.foolabs.com/xpdf/download.html>
95     May be installed after Plone install.
96
97
98Install Location
99================
100- SAAP installed at /var/interlegis/SAAP-2.0
101- Python installed at /var/interlegis/SAAP-2.0/Python-2.4
102- Zope instance installed and configured at /var/interlegis/SAAP-2.0/instance
103- Zope Products folder at /var/interlegis/SAAP-2.0/instance/Products
104- Data.fs (ZODB) at /var/interlegis/SAAP-2.0/instance/var
105
106
107Customizing the install location
108================================
109- Modify $INSTALL_HOME in install.sh to change the default location (/var/interlegis/SAAP-2.0)
110- Modify $PY and $PY_HOME to use a different Python virtual machine (e.g. the system's Python)
111- Modify $PRODUCTS_HOME to customize the location of the Products/ folder
112
113
114Admin Password
115==============
116A random administrator password is generated during the install. The password is located at
117
118 /var/interlegis/SAAP-2.0/receipts/adminPassword.txt
119
120
121Startup/Shutdown/Restart instructions
122=====================================
123To start SAAP,
124   $ sudo /var/interlegis/SAAP-2.0/instance/bin/zopectl start
125
126To stop SAAP,
127   $ sudo /var/interlegis/SAAP-2.0/instance/bin/zopectl stop
128
129To restart SAAP,
130   $ sudo /var/interlegis/SAAP-2.0/instance/bin/zopectl restart
131
132
133Ports
134=====
135- Zope instance runs on port 8280
136
137
138Post-installation instructions
139==============================
140You will need to manually add a SAAP site to the Zope instance by logging on as manager at
141
142http://localhost:8280/manage
143
144(Use the admin password provided at /var/interlegis/SAAP-2.0/receipts/adminPassword.txt)
145
146Select "Plone Site" from the "Add item" drop-down menu near top right to add a SAAP site.
147Select SAAP at "Extension Profiles" then click "Add Plone Site".
148This only needs to be done once (per Zope instance) for each SAAP site you wish to add.
149
150To change the admin password, click the "Password" link for the admin user at
151
152http://localhost:8280/acl_users/users/manage_users
153
154
155Third-party products installed
156==============================
157- PIL (Python Imaging Library)
158- PyXML (XML processing)
159- ReportLab (PDF toolkit)
160- TextIndexNG3 (full-text indexing module)
161- python-openid (OpenID support)
162- libxml2, libxslt, libxml2-python (Marshall support)
163- setuptools (easy_install support)
164
165
166Tested on the following operating environments
167==============================================
168- Ubuntu 6.06, 8.04
169- Fedora 10
170- Debian Etch
171- FreeBSD 6.1, 6.2
172- Mac OS X.4, X.5 (Intel/PowerPC)
173
174
175Uninstall instructions
176======================
1771) Stop SAAP
1782) Remove folder /var/interlegis/SAAP-2.0
179
180
181Backup instructions
182===================
1831) Stop SAAP
1842) Back up folder /var/interlegis/SAAP-2.0
185   $ tar -zcvf SAAP-2.0-backup.tgz /var/interlegis/SAAP-2.0
186   ..or..
187   $ tar -jcvf SAAP-2.0-backup.tar.bz2 /var/interlegis/SAAP-2.0
188
189
190Coexistence with System Python
191==============================
192The Python installed by the Unified Installer will *not* interfere with any other Python
193on your system. The Installer bundles Python 2.4.6, placing it at /var/interlegis/SAAP-2.0/Python-2.4
194
195
196Documentation
197=============
198http://colab.interlegis.gov.br/wiki/ProjetoSaap
199
200
201Installer Bug reports
202=====================
203Please use the SAAP issue tracker at http://colab.interlegis.gov.br/ for all bug reports.
204
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.