You can use this OMII Stack Installer:
to install the Software Component services (including the stand-alone Account Service).
to install just the WS container with supporting databases. This will give you the basic OMII authentication (WS-Security) layer only. Some Software Components require only this layer.
to install the entire OMII server "stack". This consists of a Web Services container (WS container), Integrated Resource, Job and Data Services, server-side Cauchy Application and all supporting databases.
All these installations can be carried out as a non-root user or root user. You can install an Account Service from the Software Components menu as described lower down in this topic. It can be used with either the Software Component services or Integrated Services.
Please see Prerequisites.
|
To install this: |
Use these Stack Installer options: |
|
Everything ie. secured WS database & container, Software Component database & ALL Components, Integrated Services database and Services. |
./OMIIstackInstall.pl -typical |
|
Everything ie. secured WS database & container, Software Component database & ALL Components, Integrated Services database and Services. |
./OMIIstackInstall.pl -all |
|
All the databases for the WS container, Software Components and Integrated Services |
./OMIIstackInstall.pl -all-database |
|
All the stack components for the WS container, Software Components and Integrated Services |
./OMIIstackInstall.pl -all-stack |
To manually install the full OMII Stack, you will need to run the Stack Installer six times. In order to install the WS container and Software Component Services, you will need to run the Installer four times.
1. Create a directory on your machine where you want your downloaded files to be stored.
2. Download the OMII Server installation from http://www.omii.ac.uk into this chosen location.
3. Open a new terminal window.
4. Change your working directory to the location of your downloaded files.
5. Log in as the root user using "su -" if you are not root already or if you wish to perform a non-root install, stay logged in as yourself.
6. Unpack your release, change directory to /omii-server and then type
$ ./OMIIstackInstall.pl
7. You will see the following:
Welcome to the OMII_X.X.X Server stack installer.
For support issues or queries, please either:
- Visit http://www.omii.ac.uk/support
- Email support@omii.ac.uk
- See the Support section of the OMII Installation & Setup Guide
This installer is designed to take you through the Server installation.
An OMII Server installation consists of a Web Services (WS) container
installation, with optional Software Components and an optional
Integrated services package.
Please choose the WS container database option (1), followed by the
corresponding component option (2). Then optionally install the Software
Components (3 & 4) and/or the Integrated services package (5 & 6).
Web Services container (See "Web Services container" section in User Guide)
1) Database
2) Components
Software Component (See "Software Components" section in User Guide)
3) Database
4) Components
Integrated Services package (See "Integrated Services" section in User Guide)
Please note that these services depend upon the Account Service which can be
installed via option 4.
5) Database
6) Components
7) Uninstall Options (See "Stack Installer > Uninstallation" in Install Guide)
If you use the OMII Stack installer to first install the database, then you reboot your machine and try to run OMIIStackInstall.pl again to install the server stack itself, you will need to start the database manually first. This can be done by using:
./database_service start
If you are a non-root user, you need to also specify the database location:
./database_service start /home/user/database/postgres
For more information on PostgreSQL, please see the Troubleshooting section of this OMII User Guide.
This database option should always be selected because you always need to install the WS container database and its components. These are needed as the basis for any subsequent installations of either the Software Component services or the entire OMII Stack.
If installing on an Apple Mac, you need to ensure that all the OMII supporting databases are installed on a separate Linux box - this is because the OMII does not support the use of an OMII-installed PostgreSQL on the Apple Mac platform at this time. You can however install your own PostgreSQL from source. When installing your OMII server on the Apple Mac, start from Option 2 - WS container components.
Root User:
You will be asked:
Which of the following database install options would you like to use?
1) RPM based Postgres 7.3.4
2) RPM based Postgres 8.0.1
Choose a PostgreSQL version. The packages will then be installed and tables setup. Your database is installed to /var/lib/pgsql/data and will run on port 5432. You will then see:
Web Services Database setup complete.
The recommended method for stopping, starting and restarting the database is described here.
Non-Root User:
You do not have a choice of database as a non-root user and hence you will see:
Installing Relocatable Postgres 8.0.3
Please enter the full path to where you would like postgres installed
for example: /usr/local/OMII or /home/user_id/
Enter your chosen database location, ensuring that this is a location that you have permission to access. You are then given a choice of port to run on:
Please enter the port number on which you want to run the Postgres server.
Or just press return for the default port (5432)
Enter your chosen port number and then you will see:
Postgres has been configured. If your OMII server is to be installed on a different machine,
then remote access to this database must be given to that machine.
Please supply the IP Address for the remote server OR press return if the server is local.
Enter your chosen port number and then you will see:
Web Services Database setup complete.
Now run the Stack Installer again and choose option 2 to install the WS components.
If you have problems installing the database due to, for example, Redhat PostgreSQL libraries, already being present, help can be found here.
Full details of the questions asked and how to respond can be found in How to install the WS container (including using a database on another machine).
In summary, you are asked for :
The fully qualified hostname
If you are not using a locally hosted database, you will need to know the fully qualified hostname of the machine that is hosting your database.
Your database port
Your OMII_HOME directory
The username of any local user(s) you wish to add to the 'omii_tomcat' group.
Details so that the OMII can provide you with a temporary keystore and certificate.
A series of questions which relate to the default location of your OMII keystore.
Now run the Stack Installer again and choose the appropriate options for installing either the Software Component database and components or the Integrated Services database and components.
Please refer to the OMIIMPservices_readme.txt at the top level of your release or How to install Software Component Services in this User Guide.
Please refer to the OMIIMPservices_readme.txt at the top level of your release or How to install Software Component Services in this User Guide.
All Users:
All users are given the choice of using a local or remote database with their OMII server.
If your OMII server is to be installed on a different machine,then remote access to this database must be given to that machine. Please supply the IP Address for the remote server
OR press return if the server is local.
Enter an IP address or press return.
At the end of database setup, all users should see the message:
Integrated Services Database setup complete.
Now run the Stack Installer again and choose Option 6 to install the Integrated Services components.
If you have any problems with PostgreSQL, please refer to the PostgreSQL Self Help topic in the Troubleshooting section of this OMII User Guide.
All Users:
Enter fully qualified hostname (default: machine.domain):
After being prompted for your chosen server location, you are asked:
Please enter the fully qualified name of the machine hosting your database.
Or just press return for a locally hosted database.
If your database is locally hosted on the same machine, press return, otherwise you need to enter the fully qualified name of the remote machine where the database install was carried out. If you did not carry out the database install, you need to get this information (and the port number) from the person who did do it.
Please enter the port on which your database is running.
Or just press return if it is running on the default port (5432).
Enter the port number that your database is running on. You will then be asked further questions about server location, keystore details, etc. For more details, please see How to install the Integrated Services.
Please see "How to stop and start the OMII release" in the User Guide.
You can set up your Linux machine so that the WS container and PostgreSQL start when the machine is rebooted. The method for setting this up varies with each Linux distribution so it is not described here.
Please see How to uninstall the OMII Stack.
Please see How to reinstall the OMII Stack.
This can be done by setting some environment variables. With OMII_PROMPT set to 'off', the OMII Stack Installer will ask the user for less input during the installs. With OMII_AUTO set to 'on', defaults will be assumed for all user inputs; the non-root installation will assume a default of $HOME/OMII. eg. /home/OMII.
In order for a fully automatic install to take place, you must have also primed the WS container part of the Stack installer by having changed directory to omii-server/extension (where you downloaded your Server release) and run ./get_details.pl. This script will ask questions relating to OMII keystore generation and the answers will be stored for later use by the Stack installer.
Please see Installing Multiple OMII Servers and their Databases.
Please see Changing username and password for the "tomcat" role.
