Installation

Pre-Installation

Before installing Aiakos you have a number of things to consider.

Field Structure

You need to decide what fields are captured on registration, which are mandatory and which are optional. You will also need to decide on syntactic and indexing requirements for the fields. Once you are clear on this, you will need to assemble an LDAP schema. Some tools will be provided to manage this (although they aren't yet).

User Interface

The registration screens are multipage forms. The current forms are based on our schema, which is probably not what you want to use. Some tools are provided to build new forms for you, although these tools are currently pretty rough and ready.

Migration

If you have existing user databases, you will need to merge these into your LDAP directory. There are many potential gotchas involved in this, especially if you have multiple disparate databases.

Installation

  1. Install OpenLDAP and configure it according to These instructions
  2. Install the python crypto libraries
  3. Get Zope and Plone 1 up and running. There are copious resources on doing this elsewhere.
  4. Put the Aiakos product in your Products directory, and restart Zope. You will also require LDAPUserFolder and CMFLDAP.
  5. Create a Plone site to hold the Aiakos server. This can be an existing plone site, but installing Aiakos requires that you delete your acl_users folder, so you will lose any existing users.
  6. In the plone site, delete the following objects:
    • acl_users
    • portal_membership
    • portal_memberdata
  7. Install the Aiakos product into your portal. I recommend using the CMFQuickInstaller
  8. Add an Aiakos Server Tool to your portal. This will also install and configure acl_users, portal_membership and portal_memberdata supplied by LDAPUserFolder and CMFLDAP. You will need to provide the details for your ldap server.

Debian

On debian, I recommend the following packages from the unstable distribution:
  1. slapd
  2. python-crypto
  3. ldap-utils