Managing a network of nodes (plex) with the dtjplex command

When you had a single voice response node, you used commands such as dtjstart and dtjstop to manage it locally. When you manage a network of nodes, you can manage them from a central point using the dtjplex command, which allows you to specify host names, node names, and so on. You can create your own scripts, command, or batch files that issue dtjplex commands for common tasks. Here is a quick overview of the dtjplex commands. Full syntax is given in dtjplex script.

If your configuration node is not AIX, you will have to implement equivalent scripts using the PlexManagerImpl command.

You must issue all these commands from the system management console, because the configuration database (config.cfd) must be accessible.

Starting the entire plex

To start all nodes in all hosts, on the host where config.cfd is located, enter the following command:

dtjplex -action startAll

Starting all the nodes in a host

On the host where config.cfd is located, enter the following command:

dtjplex -host hostname -action startHost

Starting a specific node only

On the host where config.cfd is located, enter the following command:

dtjplex -host hostname -node nodename -action startNode

Starting a specific application in a node

On the host where config.cfd is located, enter the following command:

dtjplex -host host_name -node nodename -application applicationname 
-copies number -action startApplication

Shutting down the entire plex

To prevent new telephone calls from starting, allow telephone calls to complete, and shut down all the nodes on all the hosts, on the host where config.cfd is located, enter the following command:

dtjplex -action stopAll

To shut down all applications running in the entire complex immediately, on the host where config.cfd is located, enter the following command:

dtjplex -action terminateAll

Shutting down all the nodes in a host

To prevent new telephone calls from starting, allow telephone calls to complete, and shut down the host, on the command line on any of the hosts defined in the config.cfd, enter the following command:

dtjplex -host hostname -action stopHost

To shut down all applications running on the host immediately, on the command line of any of the hosts defined in the config.cfd, enter the following command:

dtjplex -host hostname -action terminateHost

Shutting down a particular node only

To prevent new telephone calls from starting, allow telephone calls to complete, and shut down the node, on the command line on any of the hosts defined in the config.cfd, enter the following command:

dtjplex -host hostname -node nodename -action stopNode

To immediately shut down the node and all applications running on it, on the command line of any of the hosts defined in the config.cfd, enter the following command:

dtjplex -host hostname -node nodename -action terminateNode

Querying the status of all hosts

On the host where config.cfd is located, enter the following command:

dtjplex -action queryHosts

Querying the status of all the nodes in a host

On the host where config.cfd is located, enter the following command:

dtjplex -action queryNodes -host hostname

Querying the status of all the applications in a node

To query the status of all the applications in a node (excluding CCXML applications), on the host where config.cfd is located, type the following command:

dtjplex -action queryApplications -host hostname -node nodename

For the status of CCXML applications, on the host where config.cfd is located, type the following command :

dtjplex -action queryCCXML -host hostname -node nodename

Changing the port for communication between nodes

The voice response nodes and the application nodes communicate using TCP/IP. The default for such communication (RMIport) is on port 26924. You can change the default RMIport by using the dtjit configuration tool as described in Updating the configuration database, or by manually editing default.cff as follows:
  1. In default.cff, go to the section for Host definitions that starts with HostName= .
  2. In the line that contains RMIPortNumber=, change the value of the entry to another valid TCP port number.
  3. Run the dtjconf command.