2. Installation

Installing the service

To save you having to compile anything now, you can download the binary release of the sample service. The service is deployed in much the same way as the core GRIA services:

1. Ensure that Tomcat 5 is installed. You can either deploy the sample webapp into the same Tomcat instance as your other services, or you can install it into a new copy on a different machine. Either upload sample.war using Tomcat's administrator web-interface, or copy it into the webapps directory and restart Tomcat. If you're not sure about this, consult the installation instructions supplied with your existing GRIA 5 services.

2. Point your web-browser at http://localhost:8080/sample (or at that address on the machine running Tomcat, if different) and follow the on-screen instructions. The process of configuring the base system (keystore, database and endpoint address) is exactly the same as for configuring the GRIA services.

Once configuration is complete, the sample service will prompt you to configure it by specifying whether an account or SLA is required in order to use it, and which account and SLA services to trust if so. We recommend that you configure it as a "free" service for now; instructions on configuring trusted management services are provided later in this tutorial.

The sample service's web interface

• Click on the Grid Sample Service link and configure it in the same was as a GRIA job or data service: either make it free or add trusted Account and SLA services to the list using the web interface.

Now that your new service is installed and configured correctly, it's time to test it using the client.

Installing the client plugin

The standard GRIA 5 client doesn't know how to use the sample service. If you try dragging the WSDL link from the admin page to the client you'll find that the popup menu just has a generic "Invoke operation" menu item, which requires you to enter the XML for the SOAP request message manually. Note: if drag-and-drop doesn't do anything, right click on Services and choose Add a service and enter the URL of the WSDL manually. Also, ensure that you have a 5.3 or later version of the client.

Having to enter the request message's XML manually is awkward. We can create a better user interface using the client's plug-in system.

To install the client plugin and test it:

1. Copy the plugin jar (gria-sample-client-5.3.jar) from the dev-kit package to the client's conf/plugins directory.
2. Restart the client.

You can now use the popup menu over your sample service to create a new sample resource:

Creating a sample resource using the client

Next: Architecture