XRegistry

From Ogce

Contents

XRegistry Overview

XRegistry is a Web Service registry that is part of the OGCE's Workflow Suite. For more information on installing and using these related tools and services, see GFAC and GFAC_Portlet. XRegistry uses the | XSUL Web service container (included in the release) and does not require an Apache Tomcat web server.

Prerequisites

  • Java 1.5 or higher
  • MySQL 5.0 or higher
  • Maven 2.0.7 or higher.

Get the Code

As with other OGCE software, you can get XRegistry from our SVN repository. You can use a standard SVN client to get both tagged releases and the current working version. You can also download just the tar files if you prefer. Specific instructions are below.

SVN Release Tag

The current release tag is our TeraGrid 2009 version

  svn co  https://ogce.svn.sourceforge.net/svnroot/ogce/tags/xregistry-tg09/

SVN Access

This will give you access to the current version of the code. Use "svn update" to get updates to the code.

  svn co https://ogce.svn.sourceforge.net/svnroot/ogce/ogce-xsul-services/xregistry/

Just Want the Tars?

Tar versions of all the OGCE projects are available from SourceForge's SVN viewer, http://ogce.svn.sourceforge.net/viewvc/ogce. Navigate to the top level directory of the desired project and click the "Download GNU tarball" link on the bottom left. Specific links are below.

  • The current tagged release tar is available from here.
  • To get a tar of the current code's snapshot, click here.

Build and Install

Set Up Your Database

Install and run MySQL following the typical instructions and create a new database, "xregistry_ogce". Grant privileges on this database to a user xreg_ogce with password 'xreg_pass. The specific commands are below.

   mysql -u root -p
   mysql> create database xregistry_ogce;
   mysql> grant all on xregistry_ogce.* to 'xreg_ogce'@'%' identified by 'xreg_pass';   

Note: If root user does not have password, setup a password for root user. Commands are

  shell> mysql -u root
  mysql> SET PASSWORD FOR 'root'@'localhost' = PASSWORD('newpwd');
  mysql> SET PASSWORD FOR 'root'@'%' = PASSWORD('newpwd');


You can use a different database name, user name, and password if desired. However, these must match the values in the pom.xml file. Edit the following properties at the top of pom.xml file.

  <databaseUrl>jdbc:mysql://localhost:3306/xregistry_ogce</databaseUrl>
  <databaseUser>xreg_ogce</databaseUser>
  <databasePass>xreg_pass</databasePass>

Build XRegistry

Run the command

 mvn clean install

Start XRegistry

XRegistry is deployed into the directory target/dist-bin after a successful compilation. To start the service, run the following commands:

 cd target/dist-bin
 ./xregistry.sh xregistry.properties

The service will be available on https://your.host.machine:6666/xregistry. You can view the WSDL at the URL https://your.host.machine:6666/xregistry?wsdl. Check this URL to make sure the service started correctly. Note: Ignore following message on command

    ./xregistry.sh: line 4: kill: (5742) - No such process

The startup scripts first make sure any previously started xregistry has been stopped.

Log messages are written to xregistry.log in the dist-bin directory. To see logs

   more xregistry.log

Check this log file to make sure the service started with no errors.

Stop XRegistry

The UNIX process ID for the XRegistry service is located in the file target/dist-bin/xregistry.pid. To stop the service, use the command

  kill `cat xregistry.pid`

Using XRegistry

Documentation for using XRegistry is available from http://www.extreme.indiana.edu/xregistry/xregistry.html.

Web site tools