This quick start guide is intended to be a reference for the steps necessary to install an eagle-i institutional server. For detailed instructions, please refer to the linked guides.

Prerequisites

For details, see: Repository Installation, Upgrade and Administration Guide, section Installation / Install and Configure the Repository / Prerequisites

1. Install and configure the Tomcat web application server to ${CATALINA_HOME}
   1. Configure Tomcat to use SSL
   2. Purchase and install an SSL server certificate (for testing purposes it is possible to use a self-signed certificate; a property to this effect can be set in the file eagle-i-apps.properties )
   3. Set up the networking configuration such that Tomcat responds on standard ports 80 and 443
2. Move aside the default ROOT.war if it is present in Tomcat's webapps directory

1. Install the eagle-i repository

For details, see: Repository Installation, Upgrade and Administration Guide, section Installation / Install and Configure the Repository
For downloads, see: Get Software

1. Download the eagle-i repository distribution package, {{eagle-i-repository-dist-\[version\].zip}}

2. Establish a repository home directory, such as /opt/eaglei/repo and set an environment variable ${REPO_HOME}. Unzip the distribution package to this location
3. Copy ${REPO_HOME}/webapps/ROOT.war to Tomcat's webapps directory
4. Configure Tomcat's JAVA_OPTS (in tomcat6.conf or similar): 
   JAVA_OPTS="-XX:PermSize=64M -XX:MaxPermSize=256M -Xmx1024m"
5. Add two system properties to catalina.properties:
   org.eaglei.repository.home=/opt/eaglei/repo
derby.system.home=/opt/eaglei/repo
6. Run the script ${REPO_HOME}/etc/prepare-install.sh
7. Edit the repository configuration file in ${REPO_HOME}/configuration.properties
8. Start up Tomcat
9. Run the script ${REPO_HOME}/finish-install.sh
10. Run the script ${REPO_HOME}/upgrade.sh

2. Install SWEET, Institutional Search and Online Help

For details, see: SWEET and Institutional Search Installation and Upgrade Guide
For software downloads, see: Get Software
For configuration sample files, see: examples in our code repository

1. Stop Tomcat
2. Establish an eagle-i application home directory and a subdirectory for common application configuration files, e.g. /opt/eaglei and /opt/eaglei/conf. Edit catalina.properties to reflect these:
   org.eaglei.home=/opt/eaglei
common.loader=/opt/eaglei/conf,.....
3. Create an "anonymous" repository user with no roles (to be used by search), and a few test users with different roles.
4. Download example configuration files eagle-i-apps.properties, eagle-i-apps-credentials.properties, whoami.xml, place them  in the common configuration directory and modify them to reflect your installation

5. Download {{eagle-i-webapp-sweet-\[version\].war}} into Tomcat's webapps directory and rename to {{sweet.war}}

6. Download {{eagle-i-webapp-institution-\[version\].war}} into Tomcat's webapps directory and rename to {{institution.war}}

7. Download {{eagle-i-webapp-help-\[version\].war}} into Tomcat's webapps directory and rename {{help.war}}

8. Start Tomcat