Syntax: Recovery Tools
AddInterfaceOffline
DeleteInterfaceOffline
Tool name:
DeleteInterfaceOffline
Description:
Removes an interface from an offline realm using config data.
Usage:
runUMTool DeleteInterfaceOffline -dirname=<dirname> -interface=<interface>
[optional_args]
Examples:
DeleteInterfaceOffline -dirname=~/realmDirectories/realm0/data/ -interface=nhp0
Required arguments:
dirname :
Data directory of the realm to dump interfaces for.
interface :
Name of the interface to be removed.
Optional Parameters:
username :
Your Universal Messaging server username.
password :
Your Universal Messaging server password.
DumpInterfacesOffline
Tool name:
DumpInterfacesOffline
Description:
Dumps the list of interfaces for a specified offline realm.
Usage:
runUMTool DumpInterfacesOffline -dirname=<dirname> [optional_args]
Examples:
DumpInterfacesOffline -dirname=~/realmDirectories/realm0/data/
Required arguments:
dirname :
Data directory of the realm to dump interfaces for.
Optional Parameters:
username :
Your Universal Messaging server username.
password :
Your Universal Messaging server password.
ExportEventsFromOfflineMemFile
Tool name:
ExportEventsFromOfflineMemFile
Description:
Dumps events from offline mem file to XML file optionally using selector based filtering.
Usage:
runUMTool ExportEventsFromOfflineMemFile
-memfileloc=<memfileloc> -xmlfilename=<xmlfilename> [optional_args]
Examples:
ExportEventsFromOfflineMemFile
-memfileloc=C:\source_folder\protobuf_channel94fab9fe6d3a92
-dumpdata=true
-xmlfilename=C:\destination_folder\file_name.xml
-protobufdescriptor="C:\folder\School.fds"
ExportEventsFromOfflineMemFile
-memfileloc=C:\source_folder\channel_name.mem
-dumpdata=true
-xmlfilename=C:\destination_folder\file_name.xml
-starteid=10 -endeid=30
ExportEventsFromOfflineMemFile
-memfileloc=C:\source_folder\mixed_channel_name231859db942796.mem
-xmlfilename=C:\destination_folder\file_name.xml
-selector="EVENTDATA.AS-STRING(0, 8) = 'data2702'"
-batchsize=1000
Required arguments:
memfileloc :
Required parameter specifying the absolute path for the location of the
memory file. The path can also be the location of a folder that contains
multiple mem files.
A folder with mem files can be specified only for multi-file storage.
A single memory file can be specified only for mixed/persistent store.
xmlfilename :
Required parameter specifying XML file path to export events to.
Optional Parameters:
selector :
Optional parameter specifying the selector to filter the events.
dumpdata :
Optional parameter, when set to true the tool will dump event data (base64 encoded).
Default value is true.
starteid :
Optional parameter specifying the startEID of event from mem file
to start filtering/dumping from (default = 0).
endeid :
Optional parameter specifying the endEID of event from mem file to filter/dump to
(if not specified, filtering/dumping will be done till the last storage event id).
protobufdescriptor:
Optional parameter specifying the path to protocol buffer file descriptor.
Specified protocol buffer file descriptor will be exported to XML format file
to ExportDetails section.
batchsize :
Optional parameter specifying the events batch size to read from mem file
and dump to output file, default value is 100.
ModifyInterfaceOffline
Tool name:
ModifyInterfaceOffline
Description:
Modifies and interface of an offline realm.
Usage:
runUMTool ModifyInterfaceOffline -dirname=<dirname> -interface=<interface>
[optional_args]
Examples:
ModifyInterfaceOffline -dirname=~/realmDirectories/realm0/data/
-interface=nhp0 -port=11000
Required arguments:
dirname :
Data directory of the realm to dump interfaces for.
interface :
Name of the interface to be modified.
Optional Parameters:
adapter :
Adapter the interface wants setting to.
port :
Port that the interface will be set to.
autostart :
Whether or not the interface should be autostarted when the
realm starts.
canadvertise :
Whether or not the interface will be advertised.
authtimeout :
Number of milliseconds for authorisation timeout.
interrealm :
Whether or not this interface should be used for inter-realm
communication.
clientconnections :
Whether or not this interface should be used for client
connections.
username :
Your Universal Messaging server username.
password :
Your Universal Messaging server password.
ModifyPrimeFlagOffline
Tool name:
ModifyPrimeFlagOffline
Description:
Modifies the prime flag of a site while a realm is offline.
Usage:
runUMTool ModifyPrimeFlagOffline -datadirectory=<datadirectory> [optional_args]
Examples:
ModifyPrimeFlagOffline -datadirectory=~/realmDirectories/realm0/data/
(This will show current state of prime flag per cluster sites)
ModifyPrimeFlagOffline -datadirectory=~/realmDirectories/realm0/data/
-Site1=true -Site2=false
(This will set prime flag to true on site1 and to false on site 2 in
directory ~/realmDirectories/realm0/data/ )
Required arguments:
datadirectory :
Data directory of the realm to be modified.
Optional Parameters:
force :
Skip confirmation step before modifying cluster sites.
NOTE - if you want to edit the prime flag for sites inside a cluster you need to
specify it like an optional parameter :
-<site_name>=<new_value>.
You need to specify the value of the flag for all sites inside the cluster.
For example, if you want to set the prime flag to true on Site1 and you have
another site called Site2, the optional parameter will look like :
-Site1=true -Site2=false
username :
Your Universal Messaging server username.
password :
Your Universal Messaging server password.
RepublishEventsFromOfflineFile
Tool Name:
RepublishEventsFromOfflineFile
Description:
Imports events from an XML or .mem file, optionally using selector based filter,
and republishes events to specified store.
Usage:
runUMTool RepublishEventsFromOfflineFile -realm=<realm>
-channelname=<channelname>
-memfileloc/xmlfilename=<source_file_path> [optional_args]
Examples:
RepublishEventsFromOfflineFile
-memfileloc=C:\source_folder\proto_channelb31238f42a49b
-selector="EVENTDATA.AS-STRING(0, 8) = 'data2702'"
-realm="nhp://0.0.0.0:11000"
-channelname="destination_queue_name" -starteid=0 -endeid=90
RepublishEventsFromOfflineFile
-xmlfilename=C:\source_folder\filename.xml
-selector="EVENTDATA.TAG = '3' or EVENTDATA.TAG = '33'"
-realm="nhp://0.0.0.0:11000" -channelname="destination_channel_name"
-endeid=50 -batchsize=1000
Required arguments:
realm :
Required parameter specifying realm server name/address for republishing events.
channelname :
Required parameter specifying destination store name for republishing events.
memfileloc :
Parameter specifying absolute path for the memory file location.
The path can also be the location of a folder that contains
multiple mem files.
A folder with mem files can be specified only for multi-file storage,
and a single memory file can be specified only for mixed/persistent store.
One source file should be specified: memfileloc or xmlfilename.
xmlfilename :
Parameter specifying an XML file path to import events from.
One source file should be specified: memfileloc or xmlfilename.
Optional Parameters:
protobufdescriptor:
Optional parameter specifying the path to protocol buffer file descriptor.
When specified then republish tool will check if destination channel has
the same protocol buffer file descriptor.
No event filtering based on protobuf event data will be performed in
versions earlier than 10.3.
selector :
Optional parameter specifying the selector to filter the events.
started :
Optional parameter specifying the startEID of event from source file
to start filtering/importing from (default = 0).
endeid :
Optional parameter specifying the endEID of event from source file to filter/import to.
If not specified, filtering/importing will be done till last storage event id).
batchsize :
Optional parameter specifying the event batch size used for import and republishing events
to the store (default = 100).