Install Persistence Layer

This chapter will show how to install Orbeon Persistence Layer and all its components from the scratch. At this point is assumed that GemStone/S is already installed in your system.

Install Persistence Layer for GemStone/S

Create the folder structure to store forms attachments By default the attachment path is /opt/orbeon-files/ in this directory execute:

cd /opt/
sudo mkdir orbeon-files
sudo chown gemstone orbeon-files/
cd orbeon-files
mkdir temp
mkdir drafts
mkdir instances
mkdir definitions
cd definitions/
mkdir saved
mkdir published

To change the default attachment path evaluate (and create the folder structure):

OrbeonApiConfiguration default baseAttachmentPath: 'myPathHere'

The whole project will be installed at: /home/{username}/GsDevKit_home/shared/repos/OrbeonPersistenceLayer

Installation Script The following scripts will install OrbeonPersistenceLayer on GemStone/S named "devKit_351" and start the Web Server. Update this script with the name used in your GemStone/S installation: $ cd $GS_HOME/shared/repos/OrbeonPersistenceLayer/scripts $ sh install-all.sh devKit_351 $ sh register-application.sh devKit_351 $ sh start-all.sh devKit_351

Orbeon Properties-local.xml Configuration In Orbeon in properties-local.xml file add the following options: (change the ip address of [oxf.fr.persistence.gemstone.uri] to suit your needs)

<property as="xs:string" name="oxf.fr.persistence.provider.*.*.*" value="gemstone"/>
<property as="xs:anyURI" name="oxf.fr.persistence.gemstone.uri" value="http://192.168.29.133:8888/orbeon-gemstone-api"/>
<property as="xs:boolean" name="oxf.fr.persistence.gemstone.versioning" value="true"/>
<property as="xs:boolean" name="oxf.fr.persistence.gemstone.permissions" value="true"/>
<property as="xs:boolean" name="oxf.fr.persistence.gemstone.autosave" value="true"/>
<property as="xs:string" name="oxf.fr.persistence.gemstone.data-format-version" value="2019.1.0"/>

Note: only 2019.1.0 Format is supported. Forms formats 4.0.0 and 4.8.0 will likely work without problems but 2019.1.0 is the official supported format.

If you are going to use BPM Flow + Orbeon then also set: <property as="xs:boolean" name="oxf.fr.persistence.gemstone.lease" value="false"/>

If you are going to use only Orbeon Persistence Layer then set: <property as="xs:boolean" name="oxf.fr.persistence.gemstone.lease" value="true"/>

If you have any question about Orbeon: http://discuss.orbeon.com/ If you have any question about GemStone/S: http://forum.world.st/GLASS-f1460844.html

[See the video library here] (https://github.com/brunobuzzi/OrbeonPersistenceLayer/wiki/Persistence-Layer-Video-Library)