GNOWSYS Installation Instructions
-*- mode: org; -*-
Table of Contents
1 Operating systems
GNOWSYS has been tested on Ubuntu and Debian.
It would be great if you are using any one of
the operating system mentioned. If any other
operating system is being used please let us know
the errors you get while installation
2 Dependencies
- gcc
- postgresql-8.3
- libpq-dev
- python2.4-dev
- postgresql-plpython-8.3
3 Plone download and installation
- Checkout the latest version of Plone from http://plone.org/products/plone. Click on the link "Download Plone for Linux/BSD/Unix".
- abc@gnowledge:~$ sudo tar -zxvf Plone-3.2.1r4-UnifiedInstaller.tgz
- abc@gnowledge:~$ cd Plone-3.2.1r4-UnifiedInstaller
- Read the README.txt file for installation instructions.
4 Plone Products
4.1 LocalFS
Download LocalFS product from: http://www.easyleading.org/Downloads/LocalFS-1.7rc1-andreas.tar.gz.
LocalFS should be unpacked and put in the `Products` folder. One needs to restart Zope for it to work.
We use LocalFS to access filesystem at the CLIENT_HOME.
Note: You need to change an import statement on line number 52 of the LocalFS.py file in
the LocalFS folder. Replace the line "from OFS.content_types import find_binary" to
"from zope.app.content_types import find_binary"
4.2 SQLPASPlugin
You can obtain this from http://plone.org/products/sqlpasplugin
This plugin stores all the user details in postgresql and is an extension to
the Plone/Zope authentication. SQLPASPlugin is a Plone Archetype product.
Copy the folder 'SQLPASPlugin' in the Products folder
5 Zope Relational Database Adapter
- Download psycopg2-2.0.9.tgz from the http://initd.org/pub/software/psycopg.
- abc@gnowledge:~$ sudo tar -zxvf psycopg2-2.0.9.tgz.
- abc@gnowledge:~$ cd psycopg2-2.0.9
- abc@gnowledge:~$ sudo PLONE_PYTHON_PATH setup.py build
-
abc@gnowledge:~$ sudo PLONE_PYTHON_PATH setup.py install
For example: PLONE_PYTHON_PATH = /opt/plone/Python-2.4/bin/python -
abc@gnowledge:~$ sudo cp - R ZPsycopgDA INSTANCE_HOME/Products.
INSTANCE_HOME is the directory were your Products folder would be.
To check what your INSTANCE_HOME is please enter the ZMI and click
on Control Panel
6 GNOWSYS Installation
6.1 User creation in postgres
- abc@gnowledge:~$ sudo su postgres
- postgres@gnowledge:~$ psql
- postgres=# create user gnowsys with superuser password 'gnowsys'
6.2 Generating GnowsysSchema
- abc@gnowledge:~$ svn co svn://svn.sv.gnu.org/gnowsys/gnowsysApp_rc1
-
abc@gnowledge:~$ cd gnowsysApp_rc1/
-
abc@gnowledge:~gnowsysApp_rc1$ sudo chown plone.root inituser.txt
-
abc@gnowledge:~$ cd gnowsysApp_rc1/GBStorage/
-
abc@gnowledge:~gnowsysApp_rc1/GBStorage$ sudo python Install.py
DATABASE: gnowsysdb ( name of the database)
USERNAME: gnowsys ( postgres user username )
PASSWORD: gnowsys ( postgres user password )
HOST: localhost
6.3 Installing GNOWSYS as a Plone Product
- Copy the gnowsysApp_rc1 folder to the Products directory of your Plone.
- Restart Zope
-
Visit Zope management Interface using a browser, say firefox
depending on which port the Zope is currently running. Usually
it is [http://localhost:8080/manage] -
Add a "Plone Site" from the add product menu. The name of the
Plone site can be your choice, say 'gnowsys' -
From the portal_quickinstaller within the plone-site install
gnowsysApp_rc1,SQLPASPlugin. -
If the name of the Plone Site is given as 'gnowsys', then view
the site from [http://localhost:8080/gnowsys]
7 Configuring SQLPASPlugin for authentication
- Click on "Site Setup" after viewing the site
- In the Preferences menu, notice the 'Add on Product Configuration' items, select 'SQL Authentication'.
-
Choose the adapter 'dbadapter' and click 'apply changes'.
-
Change the field value 'name of the user table' from 'users to
auth_schema.users', and apply changes.
- Visit the 'acl_users' object from the Plone instance. You will see three SQL objects in the acl_users's folder.
-
Click on the 'source_properties' and then on 'properties`'. Change
the 'Column Mapping Field' values, and add two lines as follows and
save changes.
fullname/fullname
email/email -
Then from the acl_users folder, click on 'source_roles' and then on 'properties'. Change the value of
'roles_table' to 'auth_schema.roles' and save changes.
-
Then from the acl_users folder, click on 'source_users' and
then on 'properties'.Change the value of 'default_encryption'
to 'md5' and save changes.
8 Mailing list
Subscription Page: http://gnowledge.org/cgi-bin/mailman/listinfo/gnowsys-dev
To post to the list send a mail to gnowsys-dev@gnowledge.org
9 Usage Examples
For examples refer the EXAMPLES.txt file in the same directory.
It's advisable to use gnowsys-mode to work with GNOWSYS. For more
information on gnowsys-mode visit http://www.gnu.org/software/gnowsys/gnowsysmode.html.
Date: 2010-03-15 17:47:28 IST
HTML generated by org-mode 6.33trans in emacs 23