XRegistry

From Ogce

Contents

[edit]

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.

[edit]

Prerequisites

  • Java 1.5 or higher
  • MySQL 5.0 or higher
  • Maven 2.0.7 or higher.
[edit]

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.

[edit]

SVN Release Tag

The current release tag is our TeraGrid 2008 version 

  svn co  https://ogce.svn.sourceforge.net/svnroot/ogce/tags/xregistry-tg08/
[edit]

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/
[edit]

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.
[edit]

Build and Install

[edit]

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';

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>
[edit]

Build XRegistry

Run the command 

 mvn clean install
[edit]

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. Log messages are written to xregistry.log in the dist-bin directory.

[edit]

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`
[edit]

Using XRegistry

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

Retrieved from "http://gridfarm007.ucs.indiana.edu/ogce/index.php/XRegistry"
Web site tools