You will need the following:

The Tomcat web server can be obtained, together with instructions for installation and configuration, from the Apache Website. You should have an administrator account set up on the web server, and should configure it to run on the required ports and under the required protocols.^[3]

If https is to be used, a keystore will be required on the web server, with a tomcat entry for use by SSL. See the Apache website's SSL Configuration : HOW-TO.

Tomcat Installation Options

There are two types of Tomcat installation - either as a normal executable, or on Windows as a 'Service'. These are available as different downloads from the Apache website.

The way that you start and stop Tomcat is different in these two modes. Also, because Windows services cannot directly launch user-interface forms, the way that the product is unlocked is also different in these two situations.

Starting and Stopping Tomcat as a Standard Executable

The Tomcat server can be started by using the appropriate startup script in the Tomcat installation's bin directory, it can be stopped using the shutdown script.

Starting and Stopping Tomcat as a Service

When the 'Service' version of Tomcat has been installed on a Windows machine, an 'Apache Tomcat' entry is added to the Start menus Program listing. To start Tomcat in this mode:

Once You Have Started Tomcat

You should then be able to log in to the Tomcat administrator web page at the following url^[4]:

http://<your-server-address>/manager/html

or

https://<your-server-address>/manager/html, if SSL is enabled on the web-server.

Before installing Stibium, you may wish to register on our website; this can be done using our on-line registration form. The Stibium distribution can then be downloaded from the following page:

http://www.rcrt.co.uk/downloads/downloads.jsp

You must be logged-in to access this page, a website password is provided as part of the registration process.

This distribution consists of a single Windows msi installer file: Stibium.msi,^[5] the installer must be run on a Windows machine, where it will create and populate the necessary folders on the desktop, once this has been done the files can be moved to, and run on, any platform that supports Java.

If all is well, the file/directory structure created by the installer is as follows:

 --# Stibium-<version>
   |
   |-- ReadMe.txt
   |-- ReleaseNotes.txt
   |
   |--# client
   |  '-- StibiumClient.jar
   |
   |--# server
   |  '-- Stibium.war
   |
   |--# junit
   |  |
   |  |--# lib
   |  |  '-- StibiumJUnit.jar
   |  |
   |  |--# scripts
   |  |  '-- runJUnit.cmd
   |  |  '-- runInterop.cmd
   |  |
   |  '--# src 
   |     '-- (junit source files)
   |
   |--# dotnet
   |  '-- StibiumDotNetSetup.msi
   |
   |--# docs
   |  |-- StibiumGettingStarted.pdf
   |  |-- StibiumTechManual.pdf
   |  |-- StibiumJUnitTestSuites.pdf
   |  |-- StibiumDotNetGettingStarted.pdf
   |  |-- StibiumDotNetClientManual.pdf
   |  |-- StibiumNUnitTestSuitesDoc.pdf
   |  |
   |  '--# javadoc
   |     '-- (client & junit javadoc files)
   |
   |--# stibium-data
   |  |-- stibium-accounts.xml
   |  |-- stibium-config.xml
   |  |-- stibium-berry.xml
   |
   '--# thirdparty
      '-- (other jar archives required by clients)

Assuming that you have Apache Tomcat installed and working, and that you have downloaded, verified and unpacked the Stibium distribution archive, perform the following steps:

If the Stibium web application appears in the list of deployed applications on the Tomcat manager page, open your web browser and type in the following url to go to the Stibium installation home page, which should then appear as shown below:

http://<your-server-address>/Stibium/pages/home.jsp

Then, navigate to the Status Page, which will display a summary of the application statistics.

Before the Stibium server will respond to client requests, it is necessary to install a software license. The way that this is done depends on whether Tomcat is running as a standard executable, or as a Windows Service.

Unlocking Stibium in a Standard Executable Version of Tomcat

This is done using the dialogs shown below. These are launched automatically if Stibium is started (within a non 'Service' environment) without a license in place^[6].

This process is described in more detail on our web site, under 'Unlocking Software'.

If you are connected to the Internet when you perform the 'Unlock' process, you will receive automatically confirmation of your details by email.

Unlocking Stibium in a Windows Service Version of Tomcat

The license forms cannot be launched directly from within a Windows Service, so an alternative method is used, by making an entry in the stibium-config.xml file:

An Example of a 'License' Element in stibium-config.xml

  <sc:license>
    <sc:email-address value='your.name@yourcorp.co.uk'/>
    <sc:unlock-code   value='TBUMA0A69GKVBDYLEABC'/>
  </sc:license>

Running the JUnit Test Suites

A series of JUnit test suites are included in the Stibium distribution, which can be used to check the behaviour of an installation. These are described in the document: The Stibium JUnit Test Suites.

Configuring Stibium

This is done by setting up the stibium-config.xml, stibium-accounts.xml and stibium-berry.xml files, as necessary. This process is covered in Chapter 4 of: The Stibium Naming Server Technical Manual.