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

  1. Checkout the latest version of Plone from http://plone.org/products/plone. Click on the link "Download Plone for Linux/BSD/Unix".
  2. abc@gnowledge:~$ sudo tar -zxvf Plone-3.2.1r4-UnifiedInstaller.tgz
  3. abc@gnowledge:~$ cd Plone-3.2.1r4-UnifiedInstaller
  4. 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

  1. Download psycopg2-2.0.9.tgz from the http://initd.org/pub/software/psycopg.
  2. abc@gnowledge:~$ sudo tar -zxvf psycopg2-2.0.9.tgz.
  3. abc@gnowledge:~$ cd psycopg2-2.0.9
  4. abc@gnowledge:~$ sudo PLONE_PYTHON_PATH setup.py build
  5. abc@gnowledge:~$ sudo PLONE_PYTHON_PATH setup.py install
    For example: PLONE_PYTHON_PATH = /opt/plone/Python-2.4/bin/python
  6. 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

  1. abc@gnowledge:~$ sudo su postgres
  2. postgres@gnowledge:~$ psql
  3. postgres=# create user gnowsys with superuser password 'gnowsys'

6.2 Generating GnowsysSchema

  1. abc@gnowledge:~$ svn co svn://svn.sv.gnu.org/gnowsys/gnowsysApp_rc1
  2. abc@gnowledge:~$ cd gnowsysApp_rc1/
  3. abc@gnowledge:~gnowsysApp_rc1$ sudo chown plone.root inituser.txt
  4. abc@gnowledge:~$ cd gnowsysApp_rc1/GBStorage/
  5. 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

  1. Copy the gnowsysApp_rc1 folder to the Products directory of your Plone.
  2. Restart Zope
  3. 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]

    ../images/zmi.png

  4. Add a "Plone Site" from the add product menu. The name of the
    Plone site can be your choice, say 'gnowsys'
  5. From the portal_quickinstaller within the plone-site install
    gnowsysApp_rc1,SQLPASPlugin.

    ../images/quickinstaller.png

  6. 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'.

    ../images/adapter.png

  • Change the field value 'name of the user table' from 'users to auth_schema.users', and apply changes.

    ../images/users.png

  • 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

    ../images/properties.png

  • 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.

    ../images/roles.png

  • 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.

    ../images/md5.png

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.

Author: Rajiv Nair <gnowsys-dev@gnowledge.org>

Date: 2010-03-15 17:47:28 IST

HTML generated by org-mode 6.33trans in emacs 23