Universal Messaging 10.5 | Administration Guide | Command Line Administration Tools | Syntax reference for command line tools | Syntax: Diagnostic Tools
 
Syntax: Diagnostic Tools
RealmInformationCollector

Tool name:
RealmInformationCollector

Description:
Collects diagnostic information from a Universal Messaging realm server
installation and stores it in a zip archive.

Usage:
runUMTool RealmInformationCollector -mode=<mode> -instance=<instance>
[optional_args]

Examples:

RealmInformationCollector -mode=offline -instance=umserver

RealmInformationCollector -mode=offline -instance=umserver
-include=data,heapdumps

RealmInformationCollector -mode=offline -instance=*

RealmInformationCollector -mode=live -instance=umserver,umserver2
-include=heapdump

RealmInformationCollector -mode=live -instance=umserver,umserver2
-exclude=jaas,plugins

RealmInformationCollector -mode=live -instance=umserver,umserver2
-outputfile=/path/to/outputfile.zip

Required arguments:

mode : Operating mode, either 'offline' or 'live'.
The chosen mode determines what information is collected.
If 'offline' is specified, the tool will ensure that all instances to collect
information from are not running.
If 'live' is specified, the tool will ensure that all instances are running.

In live mode, certain Universal Messaging directories/files are not collected,
because reading them may cause failures on the server.
For example, if the content of the data directory is needed, it can be
collected only in offline mode.

The following collectors will be executed by default in live mode:

tanukilogs - Collects Tanuki wrapper logs of an UM server instance.

secfile - Collects the security file of an UM server instance.

installlogs - Collects SoftwareAG installer logs.

tanukiconf - Collects Tanuki wrapper configuration of an UM server
instance.

env - Collects environment information from a running UM server.

license - Collects the license file of an UM server instance.

realmconfig - Exports realm configuration from a running UM server instance.

instancemgr - Collects Universal Messaging instance manager logs.

healthchecker - Acquires health information from a running UM server instance
using UM HealthChecker tool

jaas - Collects JAAS configuration of an UM server instance.

threaddump - Generates 3 thread dumps of a running UM server instance.

plugins - Collects plugins directory of an UM server instance.

Collectors not enabled per default in live mode (need to be explicitly included):

heapdump - Acquires heap dump from a running UM server instance.
Note: This collector is not available on all platforms.

heapdumps - Collects heap dumps directory of an UM server instance.

The following collectors will be executed by default in offline mode:

tanukilogs - Collects Tanuki wrapper logs of an UM server instance.

secfile - Collects the security file of an UM server instance.

installlogs - Collects SoftwareAG installer logs.

tanukiconf - Collects Tanuki wrapper configuration of an UM server instance.

license - Collects the license file of an UM server instance.

instancemgr - Collects Universal Messaging instance manager logs.

jaas - Collects JAAS configuration of an UM server instance.

logs - Collects logs of an UM server instance.

plugins - Collects plugins directory of an UM server instance.

Collectors not enabled per default in offline mode (need to be explicitly
included):

data - Collects data directory of an UM server instance.

heapdumps - Collects heap dumps directory of an UM server instance.


instance :
Specifies a comma-separated list of realm server instance names to
collect information from. Specify '*' to include all available instances.

Optional Parameters:

outputfile :
The directory or file to write generated archive to.
If a directory is specified, it must exist.
If a file is specified and it is already present, the tool will fail.
If this argument is omitted, the tool will generate the archive in the
current working directory.

exclude :
Specifies a comma-separated list of collector names to exclude.
See 'mode' for list of available collectors.

include :
Specifies a comma-separated list of collector names to include.
See 'mode' for list of available collectors.

username :
Your Universal Messaging server username.

password :
Your Universal Messaging server password.