Page History

...

1. Unix-like operating system. This procedure is only valid for Unix variants like Linux, Solaris, MacOSX. To run some of the scripts you will need to have these commands installed:
   • bash
   • perl
   • curl
   • awk (surely anything that calls itself unix must have awk)
   • tr (seriously, is tr missing? if you are running Gentoo, install an operating system)
2. Sun's Java JDK 1.6.0.18 (though any 1.6 version ought to work just as well).
3. Apache Tomcat web servlet container, version 6.0 or 7.0, configured to run with the Java JDK in #2.
   • Tomcat must be configured to use SSL, see for example: Apache Tomcat 6.0 SSL Configuration HOW-TO
   • See the Procedures section if using Ubuntu's tomcat6 package.
   • It may be necessary to download Tomcat directly and install it manually if the version supplied by the host OS's package system is not usable. Don't hesitate to do this if it is expedient; Tomcat can run as a pure Java application in a single file hierarchy, so a manual download can work just as well (if not better) than the packaged version.
4. Optional: Apache Derby RDBMS installed in your Tomcat servlet container.
   • A copy of Derby is provided if you need to install it.

Step 1. Get Repository Distribution

The repository is distributed as a single Zip file. It contains a file README which identifies the software release it was built from. It is the artifact produced by the Maven project:

...

cp ${REPO_HOME}/lib/derby-* ${CATALINA_HOME}/lib/

Step 7. (OPTIONAL) Choose alternate Apache Derby implementation

Are you already running applications which use a certain Apache Derby in your servlet container? If so, set the environment variable DERBY_HOME as documented by Apache; if not, leave it unset and the script will use its own version of Derby (the jars in its lib/ subdirectory):

...

1. Copy the webapps to the Tomcat webapps directory:

   Code Block
   cp ${REPO_HOME}/webapps/* ${CATALINA_HOME}/webapps

2. Create your be initial administrative user login. Think of a USERNAME and PASSWORD and substitute them for the italicized words in this command:

   Code Block
   bash ${REPO_HOME}/etc/prepare-install.sh USERNAME PASSWORD ${REPO_HOME}

3. Start up the servlet container (Tomcat).
4. Run the finish-install script, which loads the data model ontology among other things. Note that you can also give it additional options to specify a personal name and email box for the initial admin user. 

   Code Block
   bash ${REPO_HOME}/etc/finish-install.sh USERNAME PASSWORD https://localhost:8443

   ...or, with username metadata included:

1. Code Block
   bash ${REPO_HOME}/etc/finish-install.sh \ -f firstname \ -l lastname \ -m admin@ei.edu \ USERNAME PASSWORD https://localhost:8443

2. Confirm it is running by visiting the admin page (login with USERNAME and PASSWORD):

   Code Block
   https://localhost:8443/repository/admin

...