spacer

Browser information

Overview

The InterPro website is run from Java servlet software, with data provided from an Oracle database. This page documents this software. Please note that InterProScan is not part of this package.

Reference material

Installation guide

You will need:

  • An Oracle database (tested with version 9.2)
  • A web application container, such as Tomcat v5 or above (tested on 5.5.12)
  • Java SE v5 or above

1. Install the database

a) Oracle:

Download the Oracle export file and import it into a database (a parameter file is supplied in the FTP directory). For the sake of security, it is recommended to create another user account which has read only access to the schema into which you have imported the data. The username and password for this account will be needed later. You will also need a JDBC driver, which is for example located at jdbc/lib/ojdbc14.jar in the 9.2 Oracle home directory.

b) Other RDBMS: are not supported

2. Download the web site

Download and unzip the archive. This contains the web site (pages, templates, images etc.), source code, the configuration files and the web application (war file) itself.

3. Edit the configuration

You need to create 3 configuration files, which can be put together in the site subdirectory.

Create the database configuration file interpro-database.config, filling in the database details from earlier:

driverClass=oracle.jdbc.driver.OracleDriver
driverJar=the location of the driver jar file
url=jdbc:oracle:thin:@database machine name:JDBC port:instance name
user=database user
password=database password

Note that this file should not be put anywhere would be visible on the web, for security reasons.

Create the main configuration file interpro-site-config.xml. You may need to change the schema values if you imported into a schema other than interpro.

<config password="mypassword" defaults="interpro-default-config.xml">
<database name="web" type="jdbc" config='interpro-database.config' sql="config/standard-queries.xml">
<sql name="interpro-schema" value="interpro"/>
<sql name="function-schema" value="interpro"/>
<sql name="interpro-struct-schema" value="interpro"/>
</database>
</config>

Create the deployment descriptor deploy.xml:

<Context docBase="/path/to/InterPro-version.war">
<Parameter name="interpro-web-config-file" value="/path/to/interpro-site-config.xml"/>
</Context>

4. Install the web application

a) Tomcat:

Ensure that the manager application is configured. In the default configuration, you will need to set a username and password for an administrative user in the conf/tomcat-users.xml. For example

<user username="username" password="password" roles="admin,manager"/>

Then connect to the manager application and set the path and URL to the deployment descriptor, and deploy. The URL will be of the format:
file:/path/to/deploy.xml (Unix)
file:drive:\path\to\deploy.xml (Windows)

b) Other application containers: You're on you own here.

5. Done!

You can collect updates here whenever you like.

spacer
InterPro 37.0