Installation of eSciDoc Infrastructure 1.2

Supported Operating Systems

Officially SupportedTestedKnown to work
Windows XP
SUSE Linux
Solaris 10Mac OS X
Windows Vista
Windows 7

Other operating systems might work, but we have no expericence yet.

Prerequisites for the Installation

The eSciDoc infrastructure is a Java application that runs in an J2EE application server. You need to install and configure a runtime environment first before you can actually deploy the infrastructure.
  1. Java
  2. PostgreSQL


To make the installation process as simple as possible, we provide an installer with a graphical user interface. As soon as you have a current Sun Java JDK and a running PostgreSQL database instance on your machine, you can download the installer and run it by either double-click the file or invoking it in a command shell:

java -jar escidoc-core-1.2.1-installer.jar

Important Note
Please remeber to start the PostgreSQL database server before running the installer!

The installer will install the JBoss Application Server, Fedora, and the eSciDoc Infrastructure. Additionally, it will configure the system and create a first set of users accounts.

Manual Installation

You will need to install and configure the following software packages in order to deploy the eSciDoc infrastructure:
  1. Ant
  2. JBoss Application Server
  3. Fedora
  4. Configure Infrastructure
  5. Deploy eSciDoc

If you mastered these steps than you have a running eSciDoc infrastructure. Congratulation! If you have difficulties to get the system running, these hints may be useful.

The next steps would be to work with the infrastructure. You can either ingest your data or some examples for the first tests.

Configuration of different Login-providers

Upgrade Installations

Upgrades from an 1.0.x release

If you upgrade from an 1.0.x release, you will first need to upgrade to the latest 1.1.x release (see upgrade instructions). Only after a successful migration from release 1.0.x to the latest 1.1.x release, you will be able to upgrade in a second step to the latest 1.2.x release (see next section).

Upgrades from an 1.1.x release

If you upgrade from an 1.1.x release, please read the upgrade instructions.

Upgrade from 1.2.0 to 1.2.1 release

This update requires replacing the escidoc-core.ear within your JBoss installation (drop the EAR file into ${jboss.dir}/server/default/deploy.

The release 1.2.1 still works with Fedora 3.3 but we suggest upgrating to Fedora 3.4.1. Please read the Upgrade Guide from Fedora. The installation guide for Fedora 3.4.1 can be found here.

Build eSciDoc from Source

If you want to build the eSciDoc framework from source, please take a look at building and deploying the eSciDoc infrastructure from the source code distribution tutorial.