Getting Started

Dependencies

This section describes the basic software needed to run the CRISTAL-ISE server. This guide focuses on using a directory server which can be any LDAP implementation. For this guide OpenLDAP is used. It also uses an XML Database which in this case is eXist. However, other options are available but the current version of CRISTAL-ISE has been heavily tested with these components therefore they are recommended for use.

The kernel library itself provides only the CRISTAL-ISE runtime with a very basic set of descriptions, and to obtain a usable server and client additional components will be needed. The project cristalise-dev has been created to provide a CRISTAL-ISE application that can introduce users to the creation and management of descriptions. This is based on an OpenLDAP directory (provided by cristalise-ldap.jar) and the eXist Native XML Database (using cristalise-xmldb.jar).

The current cristalise-dev package can be downloaded from: http://dev.cccs.uwe.ac.uk/cristalise-dev-3.1-beta.zip or they can be pulled directly from github. The server can work both on Linux and Windows.

Java

• CRISTAL requires Java 1.7 or higher. It works with both the standard Oracle JDK and OpenJDK. You can either use the standard Java JRE, or get a server version:
  • Server JRE on Windows: http://www.oracle.com/technetwork/java/javase/downloads/server-jre7-downloads-1931105.html

Set JAVA_HOME, add java/bin dir to PATH, associate .jar with bin/java.exe -jar

• Latest OpenJDK on Linux from your package repository.

eXist

• Download from: http://sourceforge.net/projects/exist/files/latest/download and install.
• Install it as a service/daemon
• Default username and password is admin/admin. Change this if you need it to be secure, but make a note of your settings.
• In linux it is advisable to see if you can find it in your package management system. Or you can download it and install it manually into /opt or your home directory.
• You can test the eXist installation by using this url: http://localhost:8080/

OpenLDAP

On Windows, install Cygwin including the openldap-server and cygrunsrv components.

• Copy cristal.schema into /etc/openldap/schema/
• Add reference to schema in slapd.conf:include /etc/openldap/schema/cristal.schema
• Set suffix, rootdn, rootpw
• Install as service/daemon. On windows use cygrunsrv

On Linux, openldap-server should be available in your distribution's repositories.

On Ubuntu e.g. 12.04 release, use the following instructions

• Copy cristal.schema into /etc/ldap/schema/
• Add reference to schema in /etc/ldap/slapd.conf: include /etc/ldap/schema/cristal.schema
• Set suffix, rootdn, rootpw

The final version of your slapd.conf should look something like this:

#
# THIS IS A COMMENT
#

include        /etc/ldap/schema/core.schema
include        /etc/ldap/schema/cristal.schema

pidfile        /run/slapd/slapd.pid
argsfile       /run/slapd/slapd.args

modulepath     /lib/ldap/
moduleload     back_bdb.so	

database       bdb
suffix         "o=cern,c=ch"
rootdn         "cn=Manager,o=cern,c=ch"
rootpw         slap
directory      /var/lib/ldap
index          objectClass eq
index          cn eq,pres,sub

Running the CRISTAL-ISE server and Swing UI

If you haven't already, download the Cristalise-dev demo package from http://dev.cccs.uwe.ac.uk/cristalise-dev-3.1-beta.zip and unzip it. Or alternatively perform a pull from GitHub.

In the /conf directory, create a 'local.clc' file from the example provided. Edit this with a text editor, and replace the HOSTNAME with your computer name or 'localhost', insert your LDAP parameters into LDAPROOTPATH, LDAPHOSTNAME, LDAPROOTUSER and LDAPPASSWORD, and replace EXISTHOSTNAME, EXISTROOTUSER and EXISTPASSWORD with your eXist-db connection parameters.

You can now start your server in a local console using the 'cristalise-server' bash script or the 'cristalise-server.bat' Windows batch file in the /bin directory. As the server starts, it will import its own bootstrap descriptions, followed by the cristalise-dev descriptions that you will use to create your own.

Launch the Swing UI using the 'cristalise-gui' bash script or the 'cristalise-gui.bat' Windows batch file. Log in with the demo cristalise-dev agent, username: dev, password: test.

Now you can explore the bundled descriptions in the domain tree on the left. In /desc/dev you will find the bundled factories that you can use to create workflows, schemas, scripts and Item descriptions.