Upgrading To 1.0.3
1.0.2 is a mandatory upgrade. Networking components have changed such that earlier versions will not be able to communicate with 1.0.2 servers.
1) Delete <TOMCAT_HOME>/webapps/Registry
2) (optional) If you are upgrading from 0.6 or earlier delete tables from your database. There are many tables from 0.6 and earlier versions that are now unused.
3) Follow standard installation instructions below
 | If you have an existing database configuration saved in Registry.xml the database must be created manually. The installer will only create the tables |
Installation
1) Download the following pre-requisites and install according to the instructions in each:
2) Download the binary tarball
and extract it. The main folder will be refered to as <DISTRO_ROOT> in the rest of this document.
3) Copy <DISTRO_ROOT>/Registry to <TOMCAT_HOME>/webapps
4) Copy contents of <DISTRO_ROOT>/tomcat_jars to <TOMCAT_HOME>/common/endorsed
5) Start Tomcat
6) Goto http://<HOST>/Registry and follow the instructions.
 | "Logging in"
The default login username/password is admin/admin. You will be asked to change this password the first time you log in. |
Running The Application
1) What you should see once the app is running
In anywhere from 10-30 minutes, you should see records appear when you click on the services, agents, or collections navigation links. If, after 30 minutes, you do not see any records, then the app is not running correctly.
2) The interfaces can be accessed at
- JSP: http://<HOST>/Registry
- OAI-PMH JSP: http://<HOST>/Registry/oaicat
- OAI-PMH: http://<HOST>/Registry/OAIHandler
More Documentation can be found here
Building From Source
1) Download the following pre-requisites and install according to the instructions in each:
2) Download the source from either SVN or the tar distribution.
3) Untar it. It should create a folder named "RegistryRelease".
| When checking out specific versions from SVN the root directory will be named "OCKHAM-Registry-x.x". Rename the directory to "RegistryRelease". |
4) Switch to directory "RegistryRelease"
5) Build with ANT using the "release" target
6) The ANT build script will create a directory RegistryRelease/release containing a binary and source tar of your build. Follow the Instructions above to install.
