Bay Networks Voice Gateway Installation guide

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

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.

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

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,

fred@acme.com,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

•32MB RAM

• 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.

Page is loading ...

Bay Networks Voice Gateway Installation guide

Bay Networks Voice Gateway Installation guide

Related papers

Other documents