As of Release v0.2, this page is obsolete.

Introduction

The instructions on this page show how to deploy a CollectionSpace service provider instance from a project milestone release or development release.

Prerequisites

You need a user account on the source.collectionspace.org machine to get a copy of the release archives. The account needs to be a member of the 'collectionspace' group. Contact one of the CollectionSpace technical leads to obtain an account or to add an existing account to the 'collectionspace' group.

These instructions assume you'll be deploying the service provider on a Fedora 10 version of Linux, and are running the 'bash' shell. (With minor modifications, these instructions may also work on any mainstream distribution of Unix, Linux, or Mac OS X, although they have not yet been fully tested outside Fedora.)

Ensure the following software is installed on your deployment system:

• Sun's JDK 1.5+
• MySQL 5.X Server

Setting up the MySQL Database Instance.

Using an SFTP or FTP client, connect to the source.collectionspace.org machine and 'get' the MySQL script named 'init_db.sql' at '/home/collectionspace/ftp/v0.1rc1'

Next, execute this script to setup a "clean" database instance for the CollectionSpace service provider. These instructions assume a MySQL server user account named 'root'. Your username might be different for your MySQL server instance.

Getting and unpacking the JBoss/Nuxeo (Deployment Platform) Archive

Using an FTP client, connect to source.collectionspace.org machine and 'get' the archive named 'jboss-4.2.3.GA.nuxeo.-5.2.M4.tar.gz' at /home/collectionspace/ftp/. For example, from an FTP command line client,

Copy the archive file you just downloaded, whose filename ends in ".tar.gz", to a directory in which you which you wish to install JBoss and have write permission. (In this Fedora 10 version of Linux example, that directory is assumed to be /usr/local/share.)

Next, unpack and install the archive:

Assuming the above command created a directory named 'jboss-4.2.3.GA.',

Getting and installing the CollectionSpace Service Provider Archives

Again, using an FTP client, connect to source.collectionspace.org and 'get' the archives named 'helloworld.war' and 'nuxeo-platform-collectionspace-5.2-SNAPSHOT.jar' at /home/collectionspace/ftp/v0.1rc1/.

Copy the file 'helloworld.war' to '$JBOSS_HOME/server/default/deploy'.

Copy the file 'nuxeo-platform-collectionspace-5.2-SNAPSHOT.jar' to '$JBOSS_HOME/server/default/deploy/nuxeo.ear/system'.

Starting and Stopping the ColletionSpace Service Provider

To start the server,

Once you've given JBoss and Nuxeo time to start, test for a successful deployment of the CollectionSpace service provider by trying to access the following URL from an HTTP client or web browser:

http://<host name>:8080/helloworld/cspace-nuxeo/echo

You should see a response something like the following:

To stop the server,

How To "Consume" CollectionSpace Services

To get more information about the CollectionSpace services, see How To "Consume" CollectionSpace Services