Page History
...
Table of Contents | ||
---|---|---|
|
Once you have an eagle-i repository to talk to (see repository installation and administration guide), installing the rest of the eagle-i suite applications is relatively straightforward.
...
Our reference implementation (used by the eagle-i Consortium) uses Tomcat 6.This installation guide references Tomcat file names and property files in its examples; equivalent details for other application containers are out of scope.
Prerequisites
- Tomcat with the eagle-i repository installed.
Locate Tomcat's home directory (usually dictated by your OS) and set an environment variableCATALINA_HOME
, for example:Code Block CATALINA_HOME=/opt/tomcat
- Optional: MySQL for search usage logging
...
General procedure
1. Create common configuration directory
Initial Procedure for all Applications
- Create some repository users
Log in as an administrator to your eagle-i repository at https://your.server/repository/admin . Navigate to the Manage User Accounts page and create the following users:- an anonymous user with no roles, to be used by the search application
- a sample user with Resource Navigator role (to collect data)
- a sample user with Curator role (to curate and publish data)
- Create eagle-i application home and configuration directory
Create
...
- a directory to place eagle-i application data and configuration files. You may want to reuse part of the path used when installing the eagle-i repository. For example
...
- , if you installed the repository in {{ /opt/eaglei/repo}}, you would define the application home as
/opt/eaglei
Code Block mkdir /opt/eaglei/conf
2. edit catalina.properties
...
- edit
catalina.properties
Open the file${CATALINA_HOME/conf/catalina.properties
in your favorite text editor.
Add the eagle-i configuration directory to the common class loader. Note thatcatalina.properties
should already have a common.loader definition, you only need to add the eagle-i configuration directory, for example:Code Block common.loader=${catalina.base}/eaglei/conf,${catalina.base}/lib,...
...
- Add the definition of the eagle-i home property. This needs to be the full path, without using variables, for example:
Code Block org.eaglei.home=/
...
opt/eaglei
...
...
3. Create application configuration files and place in the configuration directory.
Examples for all configuration files are located in the examples directory of the code trunk
...
Instructions specific to SWEET
- create Dowlload the file sample
datatools.properties
(see file from the examples directory) and copy to the common configuration directoryplace it in the eagle-i configuration directory (defined in step 1 of the Initial Procedure for all Applications section). This file contains the URL of the repository where data will be entered. Edit it to reflect your installation (note that the URL must ba an https URL and include the port number) - Download the SWEET war file from our Software download page (choosing the version you need, usually you will want the latest release) and place in a temporary location, e.g.
/tmp
. Rename the war to rename the war tosweet.war
and drop in the tomcat place it in your Tomcat webapps directory:Code Block mv /tmp/eagle-i-webapp-sweet-[version].war ${CATALINA_HOME}/webapps/sweet.war
- Restart restart Tomcat
- SWEET will be available at:
Code Block https://your.server/sweet
- Log in as one of the test users created in the Initial Procedure for all Applications and explore the SWEET. You can invoke the user help from the link on the top right hand corner.
Instructions specific to Institutional Search
- Download the sample
whoami.xml
file from the examples directory and place it in the eagle-i configuration directory (defined in step 1 of the Initial Procedure for all Applications). Edit this file to reflect your institution's information. Please pay attention to the instructions in the file. - Download the Institutional search war file from our Software download page (choosing the version you need, usually you will want the latest release) and place in a temporary location, e.g.
/tmp
. Rename the war toinstitution.war
and place it in your Tomcat webapps directory:Code Block mv /tmp/eagle-i-webapp-institution-[version].war ${CATALINA_HOME}/webapps/institution.war
- Optional: set up a database for logging search activity
- Create a database named
searchlogdb
(refer to the MySQL manual) - Dowlload the sample
asynclogger.properties
file from the examples directory and place it in the eagle-i configuration directory (defined in step 1 of the initial procedure for all applications). Edit it to reflect your MySQL user name and password.
- Create a database named
- Restart
- create the following properties files and copy to the common configuration directory:
- institution-registry.properties - contains the repository credentials for using the harvest service
- asynclogger.properties - contains the credentials for search usage database
Wiki Markup \[instructions to set up logging database\]
Wiki Markup \[instructions to set up solr home directory\]
- rename the war to institution.war and drop in the tomcat webapps directory
- restart Tomcat
- Institutional search will be available at:
Code Block https://your.server/institution
- Log in as one of the test users created in the Initial Procedure for all Applications and explore the search application. You can invoke the user help from the link on the top right hand corner.
Instructions specific to the ontology browser
...
Code Block |
---|
https://your.server/model |
Instructions specific to the monitor
...
Overview
Content Tools