Installation on a Blueworx Voice Response client

This section tells you how to install SS7 Support for Blueworx Voice Response onto a standard WebSphere Voice Response with or without SSI support. There are five stages to installing and configuring the Blueworx Voice Response client:

  1. Pre-installation
  2. Installing the D7 and the D7 Enablement packages
  3. Configuring the SS7 Cluster
  4. Configuring for Blueworx Voice Response client usage
  5. Installation and configuration complete.

Pre-installation

Before installing these software packages, read the README.TXT file on the CD-ROM to see if there are any special instructions. Ensure that the Blueworx Voice Response base packages have already been installed on this client machine, and that any SSI configuration (if relevant) has been completed.

You should configure the SS7 Server first and, if relevant, install the D7 Enablement package on the SSI Server before starting this client installation.

Installing the D7 and the D7 Enablement packages

Use the following procedure to install the D7 and the D7 Enablement packages on your AIX machine:
  1. Logon as root.
  2. Using smitty, install the following file sets:
    • dirTalk.SS7_D7_Enablement (D7 Enablement, from the base Blueworx Voice Response package)
    • D7.isup (D7, from the SS7 Support for Blueworx Voice Response CD). Refer to the readme file located in /usr/lpp/dirTalk/readme/SS7README, as this stipulates which level of D7 is required. If more than one level is required, install the packages in chronological order, then refer to D7 software release to select the relevant package, before proceeding.
  3. Now copy the relevant Distributed7 license for this machine (see Licensing the Distributed7 package) into /usr/ss8/d7/access/etc/license.dat .
The D7 package is installed into the /usr/ss8/d7 directory, and the D7 Enablement package is installed into /usr/lpp/dirTalk.

Configuring the SS7 cluster

This section describes how to locate the necessary configuration for D7. It is assumed that the guidance provided in Pre-installation has been followed and one of the following two scenarios will apply:
  1. SS7 Cluster with SSI support.

    The D7 Enablement package is already loaded onto the SSI machine and the SS7itty configuration has been performed. No additional work is required as the SSI will make all relevant files available to the Blueworx Voice Response machines.

  2. SS7 Cluster without SSI support
    The D7 and the D7 Enablement packages are already loaded onto one or more SS7 Servers and the SS7itty configuration is complete. In this scenario, follow the instructions below to copy the relevant configuration files for this machine:
    1. Logon as dtuser.
    2. Change directory to /usr/lpp/dirTalk/db/current_dir/ca/SS7_D7_cfg, then use the mkdir command to create a directory with the same name as this machine (the name returned if you enter the hostname –s command).
      Note: If the /usr/lpp/dirTalk/db/current_dir/ca/SS7_D7_cfg directory does not exist, create it by running the ss7itty command, followed by exit.
    3. Using ftp, connect to the original SS7 Server on which the SS7itty command was entered.
    4. Using the ftp commands cd and lcd, change both the local and remote directories to /usr/lpp/dirTalk/db/current_dir/ca/SS7_D7_cfg/AnyMachine.
    5. Using the ftp command mget *, copy all the files in this directory.
    6. Change both local and remote directories to /usr/lpp/dirTalk/db/current_dir/ca/SS7_D7_cfg/hostname.
    7. Using the ftp command mget *, copy all files in this directory.
    8. Exit from ftp.

Configuring the AIX machine for Blueworx Voice Response client usage

This section describes how to configure the machine for Blueworx Voice Response client operation:

  1. Login using the dtuser userid. If you are already logged in, logoff and then login again, because the login profiles will have changed.
  2. Start Blueworx Voice Response by entering the command vaeinit. Wait for the startup process to complete.
  3. Returning to the original command prompt window, enter the command SS7_MAINT, selecting the following options:
    S
    SS7 Server/Blueworx Voice Response client
    W
    Configure machine as a Blueworx Voice Response client.

    Once completed, the AIX machine is configured for Blueworx Voice Response client operation. Two custom servers (SS7_D7 and D7WVRErrorReport) will have been installed into Blueworx Voice Response and can be viewed in the Custom Server Manager GUI.

    R
    Return to top level menu
    D
    D7 Operation (Start/Stop)
    M
    Start the D7 package with Alarm Message to screen. The following text appears: 
    Starting D7 package
Application Process Manager - Version v1.3.1
Copyright (c) 1991-2004, SS8 Networks, Inc.
All Rights Reserved
D7 Status - [init] : D7 core starting
Select an option :
Master Event Log Daemon - Version v1.3.1
Copyright (c) 1991-2004, SS8 Networks, Inc.
All Rights Reserved	
Signalling Point Manager - Version v1.3.1
Copyright (c) 1991-2004, SS8 Networks, Inc.
All Rights Reserved
Network Manager - Version v1.3.1
Copyright (c) 1991-2004, SS8 Networks, Inc.
All Rights Reserved
+++++++++++++++++++++++++++++++++++++++++++++++++++
+                                                 +
+              <<< IMPORTANT NOTE >>>             +
+                                                 +
+  Operations of the Application Process Manager  +
+  are now suspended indefinitely !!!             +
+                                                 +
+  To continue, use either MMI/MML or AccessMOB   +
+  interface to set the product operation mode    +
+  (i.e., stand-alone vs. distributed) and        +
+  introduce any remote host machines involved.   +
+                                                 +
+  It is only after you perform these tasks,      +
+  Application Process Manager will resume its    +
+  normal operations & proceed with its routine   +
+  system software initialization/start-up ...    +
+                                                 +
+++++++++++++++++++++++++++++++++++++++++++++++++++
    Ignore the message in the "Important Note" and press Enter to recover the command prompt.
    R
    Return to top level menu
    C
    MML configuration loader
    H
    Load Host MML configuration for this machine. The following text appears: 
    *** Script loading operation - completed
Loading the script has been successful
The log output can be reviewed in /usr/lpp/dirTalk/sw/ss7/log/mml-host.log
    After about 30-60 seconds the following text appears: 
    Alarm Daemon - Version v1.3.1
Copyright (c) 1991-2004, SS8 Networks, Inc.
All Rights Reserved
Distributed Shared Memory Manager - Version v1.3.1
Copyright (c) 1991-2004, SS8 Networks, Inc.
All Rights Reserved
Distributed Kernel Memory Manager - Version v1.3.1
Copyright (c) 1991-2004, SS8 Networks, Inc.
All Rights Reserved

Installation and configuration complete

All the necessary actions to install and configure the Blueworx Voice Response client are now complete. Now continue with any remaining installations and configurations for other machines in this SS7 cluster. If error messages are still being generated once all machines have been configured, refer to Problem determination for assistance. Once the complete installation of the SS7 cluster has been validated, refer to Putting into production to ensure that all operations have been set to automatic mode.

Parent topic: Installing SS7 Support for Blueworx Voice Response