Updating the configuration database

To update the configuration database, you first need to modify a text file called default.cff, which is located in the directory defined by $DTJ_DIR (usually /var/dirTalk/DTBE/native/aix). You can do this manually, but the easiest way to populate the configuration database initially or to modify it later is to use the configuration tool dtjit.

To run the configuration tool:

  1. As dtuser, type dtjit at any AIX command line prompt. The following window is displayed:
    Figure 1. VRBE Utilities Window VRBE Utilities Window
  2. With VRBE configuration selected, press the Enter key. The following window is displayed:
    Figure 2. VRBE Configuration windowVRBE Configuration window

    Before proceeding, you need to know:

    • The relative number of telephone calls that you expect to have processed by each application.
    • The details of any URIs that you need to specify. (The paths of file URIs must be absolute, not relative.)
    Note:
    • The names of applications must not contain the colon (:) character.
    • You can specify only one RecoService and one TTSService for each Java locale.
    • dtjit does not use an existing default.cff file as an input but instead uses an existing vrbecfg.ser file. You are advised to keep a back-up copy of this file.
  3. To configure the Blueworx Voice Response Java and VoiceXML Environment from scratch, select each of the menu choices in turn and press the Enter key to open the window for the selected section of the configuration. To update a particular section of the configuration, select it from the menu and press the Enter key.

    Follow the instructions and answer the questions displayed. If you need more information, press the F1 key to display help.

  4. When you have completed the configuration details that you need to specify, in the VRBE Configuration window select Generate vrbecfg.cff file and press the Enter key. A vrbecfg.cff file is created in the directory defined by $DTJ_DIR.
  5. Press the F10 key to exit.
  6. Copy the generated vrbecfg.cff file to default.cff in the same directory.

To update the configuration database, you need to import default.cff into the configuration database using the dtjconf command. This command replaces the default configuration completely. The dtjconf command can also be used to export the contents of the configuration database to a text file, and to list the configurations in the database.

Figure 3. Using dtjconf
This picture shows the use of dtjconf.

When you install Blueworx Voice Response for AIX, the default.cff file is located in directory /var/dirTalk/DTBE/native/aix. There is also a default.sample.cff file located in the same directory.

To update the default configuration in the configuration database, config.cfd manually rather than use the configuration tool:

  1. To be quite sure that the default.cff file is an accurate representation of the current default configuration in the configuration database, use the following command:
    dtjconf -action export  
  2. This creates a file called default.exp. Rename it to default.cff.
  3. Edit the default.cff file to add or change the entries as necessary.

    The format of the configuration file is as follows:

    • Each line can contain a keyword and a parameter, separated by an equals (=) sign.
    • A pound sign (#) in the first column means that the line is treated as a comment.
    • Blank lines are ignored.
    • There are entries identified by their primary keywords, specifying different resources defined in the file: AppName configuration entry, GroupName configuration entry, NodeName configuration entry, HostName configuration entry, and so on.
    • All references must point to something that has already been defined earlier in the file. This means that:
      • All AppName entries must precede all GroupName, RecoService and TTSService entries.
      • All CCXMLService, GroupName, RecoService, TelephonyService, and TTSService entries must precede all NodeName entries.
      • All NodeName entries must precede all HostName entries.
  4. Save the default.cff file.
  5. To import the new definitions into the configuration database, use the following command: dtjconf.
  6. When you start each node, the changes take effect.