This quick start guide is intended as 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 > Install and Configure Repository > Prerequisites
See also System Requirements.
- Install and configure the Tomcat web application server to
${CATALINA_HOME
}- Configure Tomcat to use SSL
- 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
) - Set up the networking configuration such that Tomcat responds on standard ports 80 and 443
- 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 > Install and Configure Repository
For downloads, see: Get Software
Download the eagle-i repository distribution package,
eagle-i-repository-dist-[version].zip
- Establish a repository home directory, such as
/opt/eaglei/repo
and set an environment variable${REPO_HOME
}. Unzip the distribution package to this location - Copy
${REPO_HOME}/webapps/ROOT.war
to Tomcat's webapps directory - Configure Tomcat's JAVA_OPTS (in tomcat6.conf or similar):
JAVA_OPTS="-XX:PermSize=64M -XX:MaxPermSize=256M -Xmx1024m"
- Add two system properties to
catalina.properties
:
org.eaglei.repository.home=/opt/eaglei/repo
derby.system.home=/opt/eaglei/repo
- Run the script
${REPO_HOME}/etc/prepare-install.sh
- Edit the repository configuration file in
${REPO_HOME}/configuration.properties
- Start up Tomcat
- Run the script
${REPO_HOME}/etc/finish-install.sh
- Run the script
${REPO_HOME}/etc/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
- Stop Tomcat
- Establish an eagle-i application home directory and a subdirectory for common application configuration files, e.g.
/opt/eaglei
and/opt/eaglei/conf
. Editcatalina.properties
to reflect these:
org.eaglei.home=/opt/eaglei
common.loader=/opt/eaglei/conf,.....
- Create an "anonymous" repository user with no roles (to be used by search), and a few test users with different roles.
- 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 Download
eagle-i-webapp-sweet-[version].war
into Tomcat's webapps directory and rename tosweet.war
Download
eagle-i-webapp-institution-[version].war
into Tomcat's webapps directory and rename toinstitution.war
Download
eagle-i-webapp-help-[version].war
into Tomcat's webapps directory and renamehelp.war
- Start Tomcat