Personal tools
You are here: Home GRIA Documentation Documentation 5.2 Reference Manuals Service Installation Manual (all services)

Service Installation Manual (all services)

Note: Return to reference manual view.

This guide contains the core installation instructions that are common to all GRIA services. Topics covered include installing Java and Tomcat, war file deployment and firewall configuration.

1. Service Administration

Describing how to navigate the web portal and perform the initial general configuration.

The Service Administration Page

The GRIA main administation page gives access to the administration pages of the individual services within the same .war file as well as providing configuration, status reporting and logging control for all services.

You can find the administration page by clicking on the web application's link in the Tomcat manager and then clicking on the "Admin" link in the navigation bar at the top of the web application.

Initial Configuration

When first accessed, the services will be greyed out and the system will lead you to provide the required general configuration information, which is:

  • The location of a configuration directory in which to store the service configuration. This is not stored inside the webapp so that it will not be lost when upgrading.
  • A keystore containing the service's private key. This allows clients to check that they are really using the service they think they are.
  • A location for the database files. GRIA uses hibernate, which allows it to be configured to use a range of database backends. However, the default is to store everything locally in a few files, which saves the need to configure a separate database server.
  • The endpoint address for the service. The default offered should be used in most cases. When users create a new resource, this is the address that the service will tell them to use to access it. If your service is fronted by Apache on another machine, for example, you should give the address of the machine running Apache here.

The Navigation Menu

The navigation menu along the top of the window provides access to various useful pages:

Main
Return to the public page.
Admin
The main administration page.
Check Axis
Check that requires libraries are available for the underlying Axis system.
View logs
View the service log file and edit the logging configuration.
Access control
View the resources and resource types managed by the access control system.
List of services
View the list of services and their operations and WSDL interfaces.
Atom feed
Subscribe to this feed to get notifications of issues or problems with the services.
Send support request
If you have problems or suggestions, please send us a support request.

Service Status Feeds

Each service reports its current status and other important information. Each item is displayed on the main page under the service reporting it. You can also get this information from the Atom feed. This is useful if you have many services to administer, since you can get your news aggregator to subscribe to each one and check them for you.

After the general configuration is done, each service will report that it requires configuration too. Click on any item for more information.

Service specific configuration

For instructions on configuring the specific services, consult the appropriate service manual.