Configuring an application node

Important: Do not configure more than 30 applications to run on the same application node.
In the configuration database on the voice response node:
  1. Create a NodeName entry for the application node.

    The NodeName configuration entry for an application node does not have as many other keywords as a NodeName entry for a voice response node, for the simple reason that it does not provide services to the applications. However, there are two keywords that apply to application nodes but not to voice response nodes: the NodeDefVRNode and the NodeDefHost, which define the default voice response node and its host, for applications running on the application node.

  2. If the application node is on a different host from the voice response node, create a HostName entry for the host on which the application node is located.
  3. Ensure that the HostName entry for the host on which the voice response node is located specifies the fully qualified TCP/IP address in the IPName keyword. This enables the application node to locate the voice response node.

To start applications on an application node, create a GroupName entry in the configuration database and refer to it using the Group keyword in the NodeName entry for the application node. If you want to be sure that the application node is set up correctly, make sure you do not start the same application on the voice response node.

The following example shows a configuration file including NodeName entries and GroupName entries:
# Definition of a banking application
AppName=myapp
  AppClass=test.banking
;
# Definition of a pizza-ordering application
AppName=pizzas
  AppClass=production.pizzaOrdering
;
# A group that contains the myapp application
GroupName=CurrentTest
  Application=myapp
  Application=myapp
;
# A group that contains the pizzas application
GroupName=Pizzas
  Application=pizzas
  Application=pizzas
  Application=pizzas
;
# Application node running a group of applications called CurrentTest
# Using a NodeClassPath because there is a production version 
of the
# application in mybeans.jar in use on another node.
# The myapp application is run in this node.
NodeName=Test
  VRNode=no
  NodeDefVRNode=Node1
  NodeDefHost=lucky7
  NodeClassPath=/j/test/mybeans.jar
  Group=CurrentTest
;
# Voice response node running on AIX
# Using a NodeClassPath because there is a test version of the
# application in mybeans.jar in use on another node.
# The pizzas application is run in this node,
# but the myapp application is not.
NodeName=VRNode1
  VRNode=yes
  NodeDefLocale=en_US
  NumToApp=*,welcome
  NumToApp=123456,pizzas
  NumToApp=123457,myapp
  NodeClassPath=/j/prod/mybeans.jar:/j/prod/pizzas.jar
  ;
# Host of test system
HostName=legs11
  IPName=legs11.hursley.ibm.com
  Node=Test
;
# Host of production system
HostName=lucky7
  IPName=lucky7.hursley.ibm.com
  Node=VRNode1
 ;
After using the dtjit configuration tool as described in Updating the configuration database, or by manually editing the default.cff file to make the changes, run dtjconf to import them into the configuration database. You now have a network of nodes, or plex. To ensure that your changes have taken effect:
  1. Start the HostManager on each host, by running the dtjshost command.
  2. Start the plex by running the following command:
    dtjplex -action startAll
  3. Make a call to one of the applications you have started on the application node.
Figure 1. How configuration entries refer to each other: application running in application node
This picture shows how configuration entries refer to each other. The application is running in .

Figure 1 shows how the voice response node is identified when the application is started in an application node. Starting an application in an application node is exactly the same as starting an application in a voice response node: the node name you specify is the application node, not the voice response node. If the application node is correctly configured, the NodeDefHost and NodeDefVRNode keywords are used to identify the voice response node.