Getting Started Guide

Getting Started Guide

This Getting Started Guide explains how to deploy Grimoires and use GShell - which is a command line client tool - to perform the publish and inquire operations for a business. Grimoires must be deployed into an appropriate Web Services container, which must be up and running prior to deployment. There are 3 possible container environments that are supported: Tomcat / Axis, Globus Toolkit 4 and OMII. For OMII, the required container environment (henceforth refered to as the OMII container) corresponds to a Base and Extensions Installation. It is assumed that you are acquainted with the operation of the container environment of your choice, have downloaded it and started it before proceeding with the rest of this quick start guide, and that your classpath for Ant and Java has been set appropriately. This guide does not require UDDI specific knowledge.

Download

Download the Grimoires source release and unzip it. There is a build.xml and an init.properties file in the root directory, whose parameters need to be configured correctly in order to deploy Grimoires.

Configure

Parameter configuration is described for the case of an OMII container. It is assumed that the Tomcat in OMII is active at the port http://your.host.name:18080, and there is a manager account whose username is "tomcat" and password is "tomcat". Grimoires will be deployed at http://your.host.name:18080/grimoires. The parameter details are as follows:

container = omii

tomcat.host = http://your.host.name
tomcat.port = 18080

# Grimoires install path
omii.context.path = grimoires

# username/password for a manager role
omii.tomcat.username = tomcat
omii.tomcat.password = tomcat

Deploy

Run "ant deploy" to deploy Grimoires.

Test installation

Run "ant test-install" to test whether Grimoires is successfully deployed. If Grimoires is successfully installed, you will see something like:

<h1>publish</h1>
<p>Hi there, this is an AXIS service!</p>
<i>Perhaps there will be a form for invoking the service here...</i>

It means a Grimoires publish web service is successfully deployed.

Start to use Grimoires

Go to the "GShell" subdirectory under the Grimoires release.

Type "ant" to compile.

Type "run http://your.host.name:18080/grimoires" (on Windows) or "./run.sh http://your.host.name:18080/grimoires" (on Linux/Unix) to run GShell, which is a command line client tool.

On Linux/Unix, you may need to make "run.sh" executable by typing "chmod +x run.sh".

You can publish/inquire a business as follows:

Publish a business

Publish a business called "Univ. of Southampton". A business is the UDDI's terminology for an organization. You will get a business key. On the screen, you will see:

>run PublishBusiness
==== Publish a business ====
Input the business name:
Univ. of Southampton
Input the business description:
University
Business key[$1]: ca5bdb5b-cf1c-4054-8626-65862727b9ff

Inquire a business

Inquire a business by name. On the screen, you will see:

>run InquireBusiness
==== Inquire a business ====
Input the business name:
Univ. of Southampton
Business key[$2]: ca5bdb5b-cf1c-4054-8626-65862727b9ff

Undeploy and re-deploy

Run "ant undeploy" to undeploy Grimoires.

Run "ant undeploy" then run "ant deploy" to re-deploy Grimoires.

Where to go from here

You can also use UDDI browser to publish web services to and inquire web services from the deployed Grimories.
Read more Grimoires documentation.