Universal Messaging 9.9 | Installation Guide | Universal Messaging Instance Manager
 
Universal Messaging Instance Manager
During the installation of webMethods Universal Messaging, you have the option of creating a default instance (called "umserver" by default) for all the components installed. If you need to create additional instances, this can be done using the ninstancemanager command line tool, which can be found under <Software_AG_directory>/UniversalMessaging/tools/InstanceManager/.
Note: The Instance Manager is available if you have installed Universal Messaging using the Software AG Installer; it is not available if you installed Universal Messaging using the standalone installation.
Components
The ninstancemanager tool can create instances of realm servers (RS), Enterprise Manager (EM) and template applications (TA). In order to create an instance of a component, this needs to have been installed first.
Usage Message
Executing the ninstancemanager tool without any arguments provides a usage message as follows:

ninstancemanager <Action> <Instance Name> <Component> <Host> <Port> [Data directory]
*<Action> can be either create, delete, query or deleteAll (followed directly by a component).
*<Instance Name> can be any instance name.
*<Component> is the component the action applies on, namely RS (for Realm Server), EM (for Enterprise Manager), TA (for Template Application) or ALL (for everything installed).
*<Host> is the hostname or IP that the template apps & Enterprise manager will point to, and the adapter the realm will bind to.
*<Port> is the TCP port that the template apps & Enterprise Manager will point to, and the adapter the realm will bind to.
*<Data directory> is the realm server working directory. This parameter is optional, and the default value is "UniversalMessaging/server/<Instance Name>".
Example 1: To create a new instance called umserver2 and listening to all IPs on port 9001, you would run:

ninstancemanager create umserver2 all 0.0.0.0 9001
Example 2: To create a new EM instance called umserver2 and pointing to a realm on 192.168.1.100 port 9001 you would run:

ninstancemanager create umserver2 all 192.168.1.100 9001
Example 3: To delete all instances called umserver2 you would run:

ninstancemanager delete umserver2 all
Example 4: To delete an EM instance called umserver2 you would run:

ninstancemanager delete umserver2 em
Example 5: To query installed instances you would run:

ninstancemanager query
Example 6: To delete all realm server instances you would run:

ninstancemanager deleteAll rs
Querying Installed Instances
Running the ninstancemanager tool with the query action displays a list of currently installed instances. For example:

ninstancemanager query
will display an output similar to the following in a default installation (taking release 9.8.0 as an example):

webMethods Universal Messaging installation query
-------------------------------------------------

Realm Server Installed Version:
e2ei/11/NUM_9.8.0.0.13321/UniversalMessaging/NUMRealmServer
Instances: umserver

Enterprise Manager Installed Version:
e2ei/11/NUM_9.8.0.0.13321/UniversalMessaging/NUMEnterpriseManager
Instances: umserver

Template Applications Installed Version:
e2ei/11/NUM_9.8.0.0.13321/UniversalMessaging/NUMTemplateApplications
Instances: umserver

Creating Instances
Running the ninstancemanager tool with the create action allows you to create instances of all the installed components or a subset. In order to create an instance, you need to run the ninstancemanager as follows:

ninstancemanager create <Instance Name> <Component> <Host> <Port>
Where:
*<Instance Name> is a logical name for the instance which needs to be unique for each installation.
*<Component> is the component you wish to create an instance of. The possible values are ALL (for all components installed), RS (for a realm server instance), TA (for template applications instance) or EM (for enterprise manager instance).
Example: If we wanted to create an instance of all components installed called testinstance, bound to all IPs of the machine and listening on port 9002 you would enter:

ninstancemanager create testinstance all 0.0.0.0 9002
Output:

Created RS instance testinstance
Created TA instance testinstance
Created EM instance testinstance
You can then verify the instance's presence by issuing a query action:

ninstancemanager query
Output:

webMethods Universal Messaging installation query
-------------------------------------------------

Realm Server Installed Version:
e2ei/11/NUM_9.8.0.0.13321/UniversalMessaging/NUMRealmServer
Instances: testinstance , umserver

Enterprise Manager Installed Version:
e2ei/11/NUM_9.8.0.0.13321/UniversalMessaging/NUMEnterpriseManager
Instances: testinstance , umserver

Template Applications Installed Version:
e2ei/11/NUM_9.8.0.0.13321/UniversalMessaging/NUMTemplateApplications
Instances: testinstance , umserver
Deleting Instances
The ninstancemanager tool can be used to delete any instances created, including the default instance created using the installer. The components specified allow you to remove an instance for one component while keeping it for the others.
In order to delete an instance, you need to run the ninstancemanager as follows:

ninstancemanager delete <Instance Name> <Component>
Where:
*<Instance Name> is a logical name for the instance which needs to be unique for each installation.
*<Component> is the component you wish to create an instance of. The possible values are ALL (for all components installed), RS (for a realm server instance), TA (for template applications instance) or EM (for enterprise manager instance).
Example: If we wanted to delete a previously created instance of all components called testinstance, you would enter:

ninstancemanager delete testinstance all
Output:

RS instance testinstance has been deleted
TA instance testinstance has been deleted
EM instance testinstance has been deleted
You can then verify the instance's presence by issuing a query action:

ninstancemanager query
Output:

webMethods Universal Messaging installation query
-------------------------------------------------

Realm Server Installed Version:
e2ei/11/NUM_9.8.0.0.13321/UniversalMessaging/NUMRealmServer
Instances: umserver

Enterprise Manager Installed Version:
e2ei/11/NUM_9.8.0.0.13321/UniversalMessaging/NUMEnterpriseManager
Instances: umserver

Template Applications Installed Version:
e2ei/11/NUM_9.8.0.0.13321/UniversalMessaging/NUMTemplateApplications
Instances: umserver
Deleting All Instances of a Component
You can delete all instances of a component (RS, EM, TA or ALL) by using the "deleteAll" action and passing the component:
Example: If we wanted to delete all previously created instances of the component type "template application" (TA), you would enter:
ninstancemanager deleteAll ta
Output:

TA instance umserver has been deleted
You can then verify that the instance(s) have been deleted by issuing a query action:
ninstancemanager query
Output:

webMethods Universal Messaging installation query
-------------------------------------------------

Realm Server Installed Version:
e2ei/11/NUM_9.8.0.0.13321/UniversalMessaging/NUMRealmServer
Instances: umserver

Enterprise Manager Installed Version:
e2ei/11/NUM_9.8.0.0.13321/UniversalMessaging/NUMEnterpriseManager
Instances: umserver

Template Applications Installed Version:
e2ei/11/NUM_9.8.0.0.13321/UniversalMessaging/NUMTemplateApplications
Instances:


Copyright © 2013-2015 | Software AG, Darmstadt, Germany and/or Software AG USA, Inc., Reston, VA, USA, and/or its subsidiaries and/or its affiliates and/or their licensors.
Innovation Release