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 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. Wiki Markup
   Download the eagle-i repository distribution package, {{eagle-i-repository-dist-\[XXXversion\].zip}}

2. Select Establish a repository home directory, such as /opt/eaglei/repo and set an environment variable ${REPO_HOME}, and unzip . Unzip the distribution package to this location
3. Copy  ROOT${REPO_HOME}/webapps/ROOT.war located in the webapps subdirectory, to Tomcat's webapps directory
4. Configure Tomcat's JAVA_OPTS (in tomcat6.conf or similar) and system properties in : 
   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/Run the prepare-install.sh script
7. Edit the repository configuration file in ${REPO_HOME}/configuration.properties
8. Start up Tomcat
9. Run the script ${REPO_HOME}/finish-instalinstall.sh script
10. Run the script ${REPO_HOME}/upgrade.sh script

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 the common configuration directory and edit 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 itthese:
   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.Create basic repository users
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, install and configure sweet.war
6. Download, install and configure institution.war

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

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

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

11. Start TomcatDownload, install and configure help.war