The Mobius Project, OSU Department of Biomedical Informatics, Multiscale Computing Laboratory

Service Registry (Registrar) Command Line Utilities Reference

The command line utilities are located in the /scripts directory. Each uses the Registrar API to implement common service registry functionality. All of the command line tools that run during service uptime take a -factory argument that allows you to specify the factory class that will be used to get handles to Mobius network services. Omitting this flag will cause the tools to use the default factory for handles. Each of these will also take a -factoryXML argument that specifies the path to a Grid Service Factory configuration file, an example of which is given here.

Passing the -help argument will list the utility's required and optional arguments. Scripts ending .bat are for Windows, .sh for *nix.

Start a Service Registry

This script starts a Service Registry server, parsing the config file passed in. Starting a Service Registry is a generic action, the specifics of which are determined by your config file.
Script name: startRegistrar
Arguments:
Path to config file (required)

Get Service Data

This script prints some useful information about the Service Registry service itself, including uptime and supported request types.
Script name: getServiceData
Arguments:
-registry Registry service ID (required)
-xmlOnly Print the xml result

Get Service List

This script prints out a list of the registered services.
Script name: getServiceList
Arguments:
-registry Registry service ID (required)
-service Filter by Service ID
-serviceType Filter by Service Type

Register a Service

This script registers a new service with the Service Registry.
Script name: registerService
Arguments:
-ports List of ports (PROTOCOL,port) that the service listens on. (required)
-host The hostname that the service is running on. (required)
-registry Registry service ID (required)
-type The type of service (MAKO, GME, REGISTRAR). (required)

Remove a Service

This script removes a service from the Service Registry.
Script name: removeService
Arguments:
-registry Registry service ID (required)
-service ID of the service to remove. (required)

Stop the Service Registry

This script stops the Service Registry, causing it to exit.
Script name: stopRegistrar
Arguments:
-registry Registry service ID (required)

Destroy the Service Registry

This script destroys the Service Registry, killing the process and removing the database schemata.
Script name: destroyRegistrar
Arguments:
-services One or more service IDs of Service Registries (required)