Bay Networks Voice Gateway User manual

Part No. 303143-A Rev. 00
July 1998
Voice Services Software
Installation Guide

ii 303143-A Rev. 00
4401 Great America Parkway 8 Federal Street
Santa Clara, CA 95054 Billerica, MA 01821
Copyright © 1998 Bay Networks, Inc.
All rights reserved. Printed in the USA. July 1998.
The information in this document is subject to change without notice. The statements, configurations, technical data,
and recommendations in this document are believed to be accurate and reliable, but are presented without express or
implied warranty. Users must take full responsibility for their applications of any products specified in this document.
The information in this document is proprietary to Bay Networks, Inc.
The software described in this document is furnished under a license agreement and may only be used in accordance
with the terms of that license. A summary of the Software License is included in this document.
Trademarks
Bay Networks is a registered trademark and Bay Networks Press and the Bay Networks logo are trademarks of Bay
Networks, Inc.
NetSpeak is a registered trademark of NetSpeak Corporation.
Microsoft, Windows, Windows NT, and SQL Server are registered trademarks of Microsoft Corporation.
Intel and Pentium are registered trademarks of Intel Corporation.
Oracle is a registered trademark of Oracle Corporation.
RSA and RSA Public Key Cryptosystem are trademarks of RSA Data Security, Inc.
The NetSpeak service products described in this document incorporate security technology from RSA Data Security,
Inc.
NetSpeak Corporation is a certified POS-port application developer and a member of the POS-port Ready program.
All other trademarks and registered trademarks are the property of their respective owners.
Restricted Rights Legend
Use, duplication, or disclosure by the United States Government is subject to restrictions as set forth in subparagraph
(c)(1)(ii) of the Rights in Technical Data and Computer Software clause at DFARS 252.227-7013.
Notwithstanding any other license agreement that may pertain to, or accompany the delivery of, this computer
software, the rights of the United States Government regarding its use, reproduction, and disclosure are as set forth in
the Commercial Computer Software-Restricted Rights clause at FAR 52.227-19.
Statement of Conditions
In the interest of improving internal design, operational function, and/or reliability, Bay Networks, Inc. reserves the
right to make changes to the products described in this document without notice.
Bay Networks, Inc. does not assume any liability that may occur due to the use or application of the product(s) or
circuit layout(s) described herein.
Portions of the code in this software product may be Copyright © 1988, Regents of the University of California. All
rights reserved. Redistribution and use in source and binary forms of such portions are permitted, provided that the
above copyright notice and this paragraph are duplicated in all such forms and that any documentation, advertising

303143-A Rev. 00 iii
materials, and other materials related to such distribution and use acknowledge that such portions of the software were
developed by the University of California, Berkeley. The name of the University may not be used to endorse or
promote products derived from such portions of the software without specific prior written permission.
SUCH PORTIONS OF THE SOFTWARE ARE PROVIDED “AS IS” AND WITHOUT ANY EXPRESS OR
IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
In addition, the program and information contained herein are licensed only pursuant to a license agreement that
contains restrictions on use and disclosure (that may incorporate by reference certain limitations and notices imposed
by third parties).

303143-A Rev. 00 v
Contents
About This Guide
Conventions ......................................................................................................................xii
Bay Networks Technical Publications ...............................................................................xii
Bay Networks Customer Service .....................................................................................xiii
How to Get Help ..............................................................................................................xiii
Bay Networks Educational Services ................................................................................xiv
Chapter 1
Getting Started
Software Components ....................................................................................................1-1
For More Information ......................................................................................................1-2
Overviews ................................................................................................................1-2
Instructions ...............................................................................................................1-2
System Requirements ....................................................................................................1-3
Before You Install ............................................................................................................1-4
SQL Database Licenses .................................................................................................1-5
Hard and Soft License Limits ...................................................................................1-5
Managing Licenses ............................................................................................1-5
SQL Database License Limits ..................................................................................1-5
Gateway Routing Manager Licenses .......................................................................1-6
Configuring Oracle System Identification .......................................................................1-7
Adding Database Alias .............................................................................................1-7
Editing the listener.ora File .......................................................................................1-9
Chapter 2
Starting the Installation Process
Installing the Hardware Key ............................................................................................2-1
Software Serial Number ...........................................................................................2-2
Registration File .......................................................................................................2-2
Starting the Server Installation Program .........................................................................2-2

vi 303143-A Rev. 00
Chapter 3
Installing the Control Center
Application Installation ....................................................................................................3-1
Starting the Control Center .............................................................................................3-4
Chapter 4
Installing the Gateway Routing Manager
Before You Install ............................................................................................................4-1
Database Implications ....................................................................................................4-2
Server Installation ...........................................................................................................4-2
Using Microsoft SQL Server ...................................................................................4-10
Using Oracle Workgroup Server ............................................................................4-11
Continuing Server Installation ................................................................................4-13
Configuring Account Authorization ...............................................................................4-14
Modify the SQL Database ............................................................................................4-14
Inserting Sample Code into the SQL Database .....................................................4-14
Customizing the Sample Code for One Customer .................................................4-15
Customizing the Sample Code for Multiple Customers ..........................................4-15
Entering the Customers in the Database ...............................................................4-16
Entering the Correct Customer Name and Address ..............................................4-16
Viewing the Database Containing the Customer Account Numbers and PINs ......4-17
Starting the Server .......................................................................................................4-17
Chapter 5
Installing the Event Manager
Before You Install ............................................................................................................5-1
Server Installation ...........................................................................................................5-2
Using Microsoft SQL Server .....................................................................................5-6
Using Oracle Workgroup Server ..............................................................................5-8
Continuing Server Installation ..................................................................................5-9
Starting the Server .........................................................................................................5-9

303143-A Rev. 00 vii
Figures
Figure 1-1. Choose Database Alias Dialog Box .........................................................1-8
Figure 1-2. Confirm Adding Database Alias Dialog Box .............................................1-8
Figure 2-1. Server Selection Dialog Box ....................................................................2-3
Figure 2-2. Serial Number Dialog Box ........................................................................2-4
Figure 2-3. Ready to Install Dialog Box ......................................................................2-5
Figure 2-4. Welcome Dialog Box ................................................................................2-6
Figure 3-1. Destination Directory Dialog Box .............................................................3-2
Figure 3-2. System Identification Dialog Box .............................................................3-3
Figure 4-1. Select Destination Directory Dialog Box ..................................................4-3
Figure 4-2. Select Subcomponent Option Dialog Box ................................................4-4
Figure 4-3. System Identification Dialog Box .............................................................4-5
Figure 4-4. Select System Information Dialog box .....................................................4-6
Figure 4-5. Control Center Initialization Login Information Dialog Box .......................4-7
Figure 4-6. Select Database Type Dialog Box ............................................................4-8
Figure 4-7. Select Routing Option Dialog Box ............................................................4-9
Figure 4-8. Database Login Information Dialog Box ................................................4-10
Figure 4-9. CS Database Size Dialog Box ...............................................................4-11
Figure 4-10. CS Database Table Size Dialog Box ......................................................4-12
Figure 4-11. Overwrite Existing File Dialog Box .........................................................4-13
Figure 4-12. Information for the SQL Database Script ...............................................4-15
Figure 5-1. Select Destination Directory Dialog Box ..................................................5-2
Figure 5-2. Database Installation Options Dialog Box ................................................5-3
Figure 5-3. Select Usage Components Dialog Box ....................................................5-4
Figure 5-4. System Identification Dialog Box .............................................................5-5
Figure 5-5. Database Login Information Dialog Box ..................................................5-7
Figure 5-6. DBS Database Size Dialog Box ...............................................................5-8

303143-A Rev. 00 ix
Tables
Table 1-1. Voice Services Components ....................................................................1-1
Table 1-2. Control Center (CC) System Requirements .............................................1-3
Table 1-3. Gateway Routing Manager (CS) System Requirements ..........................1-3
Table 1-4. Event Manager (EMS) System Requirements .........................................1-4
Table 1-5. Database License Limit Definitions ..........................................................1-5

303143-A Rev. 00 xi
About This Guide
This document contains the procedures to install and set up the Bay Networks
Control Center and Voice Services components.
You should be familiar with the systems (hardware and software) required to
operate in this environment. This includes knowledge of the Microsoft® Windows
NT® operating system, Oracle® or Microsoft SQL Server™ database, and TCP/
IP networking concepts.
If you want to Go to
Familiarize yourself with the Voice Gateway components before
starting the installation process Chapter 1
Learn how to begin the Voice Services installation process Chapter 2
Install the Control Center application Chapter 3
Install the Gateway Routing Manager (CS), and review information
about prerequisite software products Chapter 4
Install the Event Manager (EMS) and review information about
prerequisite hardware and software products Chapter 5
Note: This document contains examples of windows displayed by Voice
Services applications. These are included to give you a point of reference
while reading about features and procedures. Most of these windows match or
closely resemble those displayed by the applications. However, some windows
displayed by the version of the application you are using may differ from those
included in this document. Some fields and options might appear dimmed,
which indicates that they are unavailable.

Voice Services Software Installation Guide
xii 303143-A Rev. 00
Conventions
bold text Indicates text that you need to enter in menu paths and
fields, as well as indicates the names of buttons, tabs,
check boxes, menu commands, and keyboard functions
which should be selected or pressed.
Example: Enter NSINST on the command line.
Example: Use the dinfo command.
Example: Click on the Next button.
Example: Enter a new user name in the Database User
Name field.
Example: Click on the Database tab.
Example: Select the Use Defaults check box.
Example: 1. Choose New from the File menu.
Example: Press the Alt key.
italic text Indicates variable values in command syntax
descriptions, new terms, file and directory names, and
book titles.
quotation marks (“ ”) Indicates the title of a chapter or section within a book.
screen text Indicates data that appears on the screen.
Example: ,,,Friendly/Fred, fred,
[e-mail],199.999.9.99,,,
Bay Networks Technical Publications
You can now print technical manuals and release notes free, directly from the
Internet. Go to support.baynetworks.com/library/tpubs. Find the Bay Networks
products for which you need documentation. Then locate the specific category and
model or version for your hardware or software product. Using Adobe Acrobat
Reader, you can open the manuals and release notes, search for the sections you
need, and print them on most standard printers. You can download Acrobat
Reader free from the Adobe Systems Web site, www.adobe.com.
Documentation sets and CDs are available through your local Bay Networks sales
office or account representative.

About This Guide
303143-A Rev. 00 xiii
Bay Networks Customer Service
You can purchase a support contract from your Bay Networks distributor or
authorized reseller, or directly from Bay Networks Customer Service. For
information or to purchase a Bay Networks service contract, either call your local
Bay Networks field sales office or one of the following numbers:
Information about customer service is also available on the World Wide Web at
support.baynetworks.com.
How to Get Help
If you purchased a service contract for your Bay Networks product from a
distributor or authorized reseller, contact the technical support staff for that
distributor or reseller for assistance.
If you purchased a Bay Networks service program, call one of the following Bay
Networks Technical Solutions Centers:
Region Telephone number Fax number
United States and
Canada 800-2LANWAN; then enter Express Routing Code (ERC) 322, when prompted, to
purchase or renew a service contract
978-916-8880 (direct)
978-916-3514
Europe 33-4-92-96-69-66 33-4-92-96-69-96
Asia/Pacific 61-2-9927-8888 61-2-9927-8899
Latin America 561-988-7661 561-988-7550
Technical Solutions Center Telephone number Fax number
Billerica, MA 800-2LANWAN 978-916-3514
Santa Clara, CA 800-2LANWAN 408-495-1188
Valbonne, France 33-4-92-96-69-68 33-4-92-96-69-98
Sydney, Australia 61-2-9927-8800 61-2-9927-8811
Tokyo, Japan 81-3-5402-0180 81-3-5402-0173

Voice Services Software Installation Guide
xiv 303143-A Rev. 00
Bay Networks Educational Services
Through Bay Networks Educational Services, you can attend classes and purchase
CDs, videos, and computer-based training programs about Bay Networks
products. Training programs can take place at your site or at a Bay Networks
location. For more information about training programs, call one of the following
numbers:
Region Telephone number
United States and Canada 800-2LANWAN; then enter Express Routing Code (ERC)
282 when prompted
978-916-3460 (direct)
Europe, Middle East, and
Africa 33-4-92-96-15-83
Asia/Pacific 61-2-9927-8822
Tokyo and Japan 81-3-5402-7041

303143-A Rev. 00 1-1
Chapter 1
Getting Started
This chapter introduces the Voice Services software components and lists the
hardware and software required to install and use them. This chapter also lists any
prerequisites needed before starting the installation process.
Software Components
The Voice Services product package is made up of the following software
components:
The Voice Services Software and Documentation CD contains an installation
program that installs all the Voice Service components.
Table 1-1. Voice Services Components
Component Description
Control Center This application allows system administrators to configure, modify, and
manage the features of all Voice Services. It is the exclusive interface to all
Voice Services operations and runs on Windows 95 and Windows NT.
Gateway Routing Manager
(CS) This server allows organizations to set up connections internally and externally among users and customers.This server is managed using the Control Center
application.
Event Manager (EMS) This service logs transaction records into a database. It is a collection of
read-only database transactions collected over a long period of time. The CS
accesses the Event Manager (EMS) when logging transactions. One EMS
simultaneously supports different Voice Services. An EMS also supports
multiple Voice Services of the same type by using service e-mail.

Voice Services Software Installation Guide
1-2 303143-A Rev. 00
Bay Networks provides a hardware key that must be physically connected when
installing and operating Voice Services. Verify it is connected before starting the
installation.
For More Information
For more information about the features of each of the Voice Services
applications, refer to the following documentation on your Voice Services
Software and Documentation CD. All documentation is in Adobe Acrobat format
(.pdf files) and can be found in the manuals directory on this CD. Install Adobe
Acrobat Reader Version 3.01 to view these files.
Overviews
•Control Center Description (Control_Center.pdf)
•Gateway Routing Manager Description (Gateway_Routing_Manager.pdf)
•Call Detail Recording Description (Call_Detail.pdf)
•Event Manager Description (Event_Manager.pdf)
Instructions
•Voice Services Software Installation Guide (Services_Install.pdf)
•Control Center Administration Guide (Control_Center_Admin.pdf)

Getting Started
303143-A Rev. 00 1-3
System Requirements
Table 1-2, Table 1-3, and Table 1-4 show the items required to install and operate
each Voice Services component. Make sure these items are set up and operating
correctly before installing any Voice Services components. All items are required,
unless otherwise noted.
Table 1-2. Control Center (CC) System Requirements
Component Description
Hardware: • Intel Pentium 166 MHz processor
•32MBRAM
• 5MB available (free) hard disk space
• SVGA monitor using 1024 x 768 resolution with at least 256 colors
(recommended)
• CD-ROM drive
• Mouse or pointing device
• Network Interface Adapter
Operating System: One of the following:
• Microsoft Windows NT Server 4.0 (or later) with Service Pack 3
• Windows NT Workstation 4.0 (or later)
• Windows 95
NT Network Protocol: • TCP/IP connectivity to Voice Services
Recommended: • Power backup, uninterruptible power supply (UPS)
Table 1-3. Gateway Routing Manager (CS) System Requirements
Component Description
Hardware: • Intel Pentium 166 MHz processor (minimum)
• 64MB RAM (minimum)
• 25MB available (free) hard disk space
• CD-ROM drive
• Network Interface Adapter
• Working parallel port (LPT) on the computer system for hardware key
Operating System: • Microsoft Windows NT Server 4.0 (or later) with Service Pack 3

Voice Services Software Installation Guide
1-4 303143-A Rev. 00
Before You Install
Before installing the Voice Services software components, review any prerequisite
information contained in each chapter. This information describes the hardware,
software, and any miscellaneous items required before installing a component.
Make sure all prerequisites are installed, operating correctly, and available before
proceeding with the installation process.
Database Requirements: One of the following:
• Microsoft SQL Server 6.5 (with SQL Service Pack 3); select
• case-sensitivity
• Oracle Workgroup Server 7.3.2.2.1 with ODBC 2.5.3.1.3 for Windows NT
Server 4.0
NT Network Protocol: • TCP/IP connectivity to Voice Services
Recommended: • Power backup, uninterruptible power supply (UPS)
Table 1-4. Event Manager (EMS) System Requirements
Component Description
Hardware: • Intel Pentium 166 MHz processor (minimum)
• 64MB RAM (minimum)
• 300MB available (free) hard disk space
(includes space for SQL log and database files)
• CD-ROM drive
• Network Interface Adapter
• Working parallel port (LPT) on the computer system for hardware key
Operating System: Microsoft Windows NT Server 4.0 (or later) with Service Pack 3
Database Requirements: One of the following:
• Microsoft SQL Server 6.5 (with SQL Service Pack 3); select
case-sensitivity
• Oracle Workgroup Server 7.3.2.2.1 with ODBC 2.5.3.1.3 for Windows NT
Server 4.0
NT Network Protocol: • TCP/IP connectivity to Voice Services
Recommended: • Power backup, uninterruptible power supply (UPS)
Table 1-3. Gateway Routing Manager (CS) System Requirements
Component Description

Getting Started
303143-A Rev. 00 1-5
SQL Database Licenses
Voice Services applications, such as the Gateway Routing Manager (CS), require
one or more database licenses to connect to the appropriate SQL Server database.
The Microsoft SQL Server database controls the number of licenses or
connections to its database. Examples of applications using the Microsoft SQL
Server licenses include ISQL/w and the Enterprise Manager. ISQL/w is a
command line utility used for executing queries and administrating SQL Server
databases. The Enterprise Manager allows you to administer multiple servers and
develop databases.
Hard and Soft License Limits
Microsoft SQL Server imposes a hard license limit for the number of connections
to the SQL Server database. The Oracle Workgroup Server imposes a soft license
limit for the number of connections to the Oracle database. In addition, the
Gateway Routing Manager (CS) uses a variation of the soft limit for the number of
connections. The database license limit definitions are:
Managing Licenses
When the number of hard limit licenses are exceeded, the connect request is
queued in a first-in first-out (FIFO) list. When a license becomes available, the
first-in queue is granted a license to connect.
SQL Database License Limits
Database connection licenses are acquired and released on a per request or need
basis. The Control Center and Voice Gateway applications operate at a higher
priority and must have their license available in order to process their request
immediately rather than queuing up in a first-in first-out manner.
Table 1-5. Database License Limit Definitions
Term Definition
Hard Limit Microsoft SQL Server: When the number of licenses are exceeded, an
error is returned and the connection is refused.
Soft Limit Oracle: When the number of licenses are exceeded, an error is
returned and the connection is allowed.

Voice Services Software Installation Guide
1-6 303143-A Rev. 00
The SQL Server License error message is received when there are too few licenses
or when an application uses a license that is allocated to another application.
Suppose there are five licenses allocated to the CS and only one license is
available:
Allocated Used Available
541
If an ISQL/w process is started and connects to the database, it will take the
license allocated to the CS process. Then, all the licenses are being used. When
the CS tries to use its fifth license, an error message will be received when it tries
to connect to the database. However, if all the CS licenses are in use when the
ISQL/w process is started, an error message will be received when it tries to
connect to the databases.
None of the applications are aware of each other or aware of how many licenses
the other applications are using. Only the SQL Server database knows how many
licenses are being used. It is very important that each application has enough
licenses.
Gateway Routing Manager Licenses
The number of SQL database licenses required for the Gateway Routing Manager
(CS) is based on the following formula:
The number of licenses required for the CS is the result of the number of persistent
sockets, plus the number of active CS applications being run in a given time slice,
plus the number of CS children, plus one for the background cleanup process.
• The persistent sockets are for the Control Center application and the Voice
Gateway (WGX) application. Each Control Center and Voice Gateway server
will require one database license for each application.
• The number of children represents the number of child CSs that push data to
the parent CS. In this case, the CS represents a parent CS.
The Gateway Routing Manager (CS) can be configured to distribute services
over a hierarchical tree with CSs acting as parents to subordinate clients and
servers.
A child is the subordinate client or server of “parent” Gateway Routing
Managers in a distributed services system. For more information, refer to the
Control Center Administration Guide.