Installation of eSciDoc Infrastructure 1.1

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.1.4-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.

Upgrade Installations

Upgrades from a previous 1.0.x release

If you upgrade from an previous major release (1.0.x), please read the Upgrade From 1.0.x manual.

Upgrades from a previous 1.1.x release

Usually, minor releases (applies when the last digit of the version number differs) do not require data migration or additional configuration.

An update from a previous minor release (1.1.x) to the latest 1.1.x release requires replacing the escidoc-core.ear within your JBoss installation (drop the EAR file into ${jboss.dir}/server/default/deploy.

Nevertheless, please read the release notes carefully. In rare cases, additional steps are required even when installing minor releases.

Build eSciDoc Infrastructure from Source

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