source: publico/ILSAAP/install/2.0-beta/README.txt @ 3914

Última Alteração nesse arquivo desde 3914 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: 6.4 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: 11 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     libxml2-dev
80* libxslt (Python XML and XSLT support)
81     libxslt1-dev
82* freetype (enables true type fonts in PDFs and Images)
83     libfreetype6-dev
84* wv (used to index Word documents)
85     wv
86     <http://wvware.sourceforge.net/>
87     May be installed after Plone install.
88* xpdf (used to index PDFs)
89     xpdf
90     <http://www.foolabs.com/xpdf/download.html>
91     May be installed after Plone install.
92
93
94Install Location
95================
96- SAAP installed at /var/interlegis/SAAP-2.0
97- Python installed at /var/interlegis/SAAP-2.0/Python-2.4
98- Zope instance installed and configured at /var/interlegis/SAAP-2.0/instance
99- Zope Products folder at /var/interlegis/SAAP-2.0/instance/Products
100- Data.fs (ZODB) at /var/interlegis/SAAP-2.0/instance/var
101
102
103Customizing the install location
104================================
105- Modify $INSTALL_HOME in install.sh to change the default location (/var/interlegis/SAAP-2.0)
106- Modify $PY and $PY_HOME to use a different Python virtual machine (e.g. the system's Python)
107- Modify $PRODUCTS_HOME to customize the location of the Products/ folder
108
109
110Admin Password
111==============
112A random administrator password is generated during the install. The password is located at
113
114 /var/interlegis/SAAP-2.0/receipts/adminPassword.txt
115
116
117Startup/Shutdown/Restart instructions
118=====================================
119To start SAAP,
120   $ sudo /var/interlegis/SAAP-2.0/instance/bin/zopectl start
121
122To stop SAAP,
123   $ sudo /var/interlegis/SAAP-2.0/instance/bin/zopectl stop
124
125To restart SAAP,
126   $ sudo /var/interlegis/SAAP-2.0/instance/bin/zopectl restart
127
128
129Ports
130=====
131- Zope instance runs on port 8280
132
133
134Post-installation instructions
135==============================
136You will need to manually add a SAAP site to the Zope instance by logging on as manager at
137
138http://localhost:8280/manage
139
140(Use the admin password provided at /var/interlegis/SAAP-2.0/receipts/adminPassword.txt)
141
142Select "Plone Site" from the "Add item" drop-down menu near top right to add a SAAP site.
143Select SAAP at "Extension Profiles" then click "Add Plone Site".
144This only needs to be done once (per Zope instance) for each SAAP site you wish to add.
145
146To change the admin password, click the "Password" link for the admin user at
147
148http://localhost:8280/acl_users/users/manage_users
149
150
151Third-party products installed
152==============================
153- PIL (Python Imaging Library)
154- PyXML (XML processing)
155- ReportLab (PDF toolkit)
156- TextIndexNG3 (full-text indexing module)
157- python-openid (OpenID support)
158- libxml2, libxslt, libxml2-python (Marshall support)
159- setuptools (easy_install support)
160
161
162Tested on the following operating environments
163==============================================
164- Ubuntu 6.06, 8.04
165- Fedora 10
166- Debian Etch
167- FreeBSD 6.1, 6.2
168- Mac OS X.4, X.5 (Intel/PowerPC)
169
170
171Uninstall instructions
172======================
1731) Stop SAAP
1742) Remove folder /var/interlegis/SAAP-2.0
175
176
177Backup instructions
178===================
1791) Stop SAAP
1802) Back up folder /var/interlegis/SAAP-2.0
181   $ tar -zcvf SAAP-2.0-backup.tgz /var/interlegis/SAAP-2.0
182   ..or..
183   $ tar -jcvf SAAP-2.0-backup.tar.bz2 /var/interlegis/SAAP-2.0
184
185
186Coexistence with System Python
187==============================
188The Python installed by the Unified Installer will *not* interfere with any other Python
189on your system. The Installer bundles Python 2.4.6, placing it at /var/interlegis/SAAP-2.0/Python-2.4
190
191
192Documentation
193=============
194http://colab.interlegis.gov.br/wiki/ProjetoSaap
195
196
197Installer Bug reports
198=====================
199Please use the SAAP issue tracker at http://colab.interlegis.gov.br/ for all bug reports.
200
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.