Welcome, Guest! Log In | Create Account

Installation instructions

To install IRMIS, you first need to have installed a database engine and a Java application server. We currently suggest mysql and glassfish as these are the products on which we are concentrating our development.

To install MySQL follow the at their site or follow the procedure you prefer (e.g. apt-get, rh-update, ...). We suggest the current stable release (5.0) Rember to set the mysql password for root:

> mysqladmin -u root password NEWPASSWORD

To install glassfish follow the at their site or follow the procedure you prefer. We suggest the latest stable release (v2) At this point you should be able to login to MySQL, and you should see glassfish running on port 8080 and 4848.

Retrieve the tarball and untar it. First we need to create the irmis3 database in MySQL. In the tatball you'll find a directory called "irmis/etc/sql", with two scripts. irmis3-base.sql installs the schema with no data, while irmis3-training.sql installs the schema withh the training dataset. Run the script and create the database

> mysql -u root -p < irmis/etc/sql/irmis3-training.sql

You now need to configure glassfish to be aware of MYSQL. Copy the mysql driver, which we included in the tarball, in the glassfish library directory:

> cp irmis3/etc/jars/mysql-connector-java-5.1.5-bin.jar glassfish/lib

Restart glassfish:

> ./glassfish/bin/asadmin stop-domain
> ./glassfish/bin/asadmin start-domain

and login to http://localhost:4848 (default account: user "admin" / pwd "adminadmin") - the glassfish admin console.Under Resources/JDBC/Connection Pools create a connection pool named "IRMISPool" of type ConnectionPoolDataSource?. In the additional property section, make sure to fill in the "serverName" (localhost), the "databaseName" (irmis3) and the "user" and "password", and to remove all other properties. Under Resource/JDBC/JDBC Resources create a new JDBC resource named "jdbc/irmisDB", and select the "IRMISPool". This will publish the database connection as "jdbc/irmisDB" which will allow the application to find it. Now you can deploy the application:

> cp irmis3/etc/wars/*.war glassfish/domains/domain1/autodeploy/

You should wait until you see some files appear in the autodeploy directory telling you the applications were deployed. You should now be able to open a browser and go to http://localhost:8080/IRMIS to see the application and to http://localhost:8080/IRMISDataService to see the data service.

Note: to run the applets properly, you should install Java 6 update 10 or greater (http://java.com/) which is currently a release candidate.