Running Penrose Server

Windows Platforms

On Windows platforms, go to Start -> Programs -> Identyx -> Penrose Server.
If you need to stop the server simply press Ctrl-C on the server window.

You can also run Penrose Server from the command line. Go to PENROSE_HOME/bin, execute:

.\penrose.bat

RedHat Linux Platforms

On RedHat Linux platforms, execute:

service penrose start

If you need to stop, execute:

service penrose stop

Mac OS X Platforms

Go to PENROSE_HOME/bin, execute:

sudo ./penrose.sh start

If you need to stop, execute:

sudo ./penrose.sh stop

Unix-like Platforms

Go to PENROSE_HOME/bin, execute:

./penrose.sh start

If you need to stop, execute:

./penrose.sh stop

If you need to stop the server simply press Ctrl-C on the server window.

Common Problems

If you got an exception like the following:

javax.naming.NamingException [Root exception is java.io.InvalidClassException: o
rg.apache.ldap.common.message.LockableAttributeImpl; local class incompatible: s
tream classdesc serialVersionUID = -5158233254341746514, local class serialVersi
onUID = -7348304016528131632]

This means you have a previous installation of Penrose server, and the data files are not compatible. You need to remove PENROSE_HOME/var/data folder, then restart the server. Note that you will lose any existing data.

Adding JVM Options

If you need to add JVM options (e.g. setting heap size) you can edit the PENROSE_OPTS variable in the Penrose startup script. On Windows platforms edit PENROSE_HOME/bin/penrose.bat:

@echo off

set PENROSE_OPTS=...

On other platforms edit PENROSE_HOME/bin/penrose.sh:

#!/bin/sh

PENROSE_OPTS=...

Note that there should be no spaces right before and after the "=" sign.

The Penrose Project

The Safehaus