umestoreds

Description

Persistent Store and Queue services are provided by the umestoreds Windows Service. A store configuration file is optional. If not present, the Registry will be consulted.

The DTD used to validate a configuration file will be dumped to standard output with the -d or --dump-dtd. After dumping the DTD, umestoreds exits instead of providing persistence services as usual.

The configuration file will be validated against the DTD if either the -v or --validate options are given. After attempting validation, umestoreds exits instead of providing persistence services as usual. The exit status will be 0 for a configuration file validated by the DTD and non-zero otherwise.

The -s install or --service=install options will install the service using the given configuration file. Once installed, umestoreds exits. Once installed, the service may be stopped or started via the Windows Service Control Panel.

The -s remove or --service=remove options will remove the service. Once removed, umestoreds exits.

The -s config or --service=config options will update the configuration file used with the service to be the given configuration file. Once updated, umestoreds exits.

Command line help is available with -h.

Usage Notes

When installing the UM Persistent Store or Queue as a Microsoft® Windows® service, use only local disk devices and fully qualified path names for all filenames. This is because Windows services run by default under a Local System account, which has reduced privileges and is not allowed access to network devices.

Stopping the UM Persistent Store or Queue service triggers a clean shutdown, which attempts to cleanly finish outstanding IO requests before shutting down.

Exit Status

The exit status from umestored is 0 for success and some non-zero value for failure.