Nirvana Instance Manager
During the installation of webMethods Nirvana Messaging, a default instance called nirvana (unless renamed during installation) is created for all the components installed. If the user needs to create additional instances this can be done using the ninstancemanager command line tool.
Requirements
In order to run the ninstancemanager command line tool, you need to open a Java Examples Command prompt or Realm Server Command prompt. These prepare a set of environment variables that allow the execution of the ninstancemanager tool.
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>
<Action> can be either create, delete or query
<Instance Name> can be any instance name
<Component> is the component the action applies on, namely RS, EM, TA or ALL for Realm Server, Enterprise Manager, Template Applications or 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
Example 1: To create a new instance called nirvana2 and listening to all IPs on port 9001, you would run:
ninstancemanager create nirvana2 all 0.0.0.0 9001
Example 2: To create a new EM instance called nirvana2 and pointing to a realm on 192.168.1.100 port 9001 you would run:
ninstancemanager create nirvana2 all 192.168.1.100 9001
Example 3: To delete all instances called nirvana2 you would run:
ninstancemanager delete nirvana2 all
Example 4: To delete an EM instance called nirvana2 you would run:
ninstancemanager delete nirvana2 em
Example 5: To query installed instances you would run:
ninstancemanager query
Querying Installed Instances
Running the ninstancemanager tool with the query action displays a list of currently installed instances. For example:
ninstancemanager query
will display the following in a default installation:
webMethods Nirvana Messaging installation query
-----------------------------------------------
Realm Server Installed Version: e2ei/11/NUM_9.0.1.0.11929/Nirvana/NUMRealmServer
Instances: nirvana
Enterprise Manager Installed Version:
e2ei/11/NUM_9.0.1.0.11929/Nirvana/NUMEnterpriseManager
Instances: nirvana
Template Applications Installed Version:
e2ei/11/NUM_9.0.1.0.11929/Nirvana/NUMTemplateApplications
Instances: nirvana
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 Nirvana Messaging installation query
-----------------------------------------------
Realm Server Installed Version: e2ei/11/NUM_9.0.1.0.11929/Nirvana/NUMRealmServer
Instances: nirvana , testinstance
Enterprise Manager Installed Version:
e2ei/11/NUM_9.0.1.0.11929/Nirvana/NUMEnterpriseManager
Instances: nirvana , testinstance
Template Applications Installed Version:
e2ei/11/NUM_9.0.1.0.11929/Nirvana/NUMTemplateApplications
Instances: nirvana , testinstance
Deleting Instances
The ninstancemanager tool can be used to delete any instances created apart from 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 Nirvana Messaging installation query
-----------------------------------------------
Realm Server Installed Version: e2ei/11/NUM_9.0.1.0.11929/Nirvana/NUMRealmServer
Instances: nirvana
Enterprise Manager Installed Version:
e2ei/11/NUM_9.0.1.0.11929/Nirvana/NUMEnterpriseManager
Instances: nirvana
Template Applications Installed Version:
e2ei/11/NUM_9.0.1.0.11929/Nirvana/NUMTemplateApplications
Instances: nirvana