SS7 Support for WebSphere Voice Response

SS7 Users Guide

Version 4.2

GC34-6613-03

Note Before using this information and the product it supports, read the general information under Notices on page 119.

Fourth edition (August 2008)

This edition applies to Version 4, Release 2 of IBM SS7 Support for WebSphereVoice Response (program numbers 5799-GZL, 5799-GZQ), and to all subsequent releases and modifications until otherwise indicated in new editions. Make sure you are using the correct edition for the level of the product.

Copyright International Business Machines Corporation 2001, 2008. All rights reserved. US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

Copyright SS8 Networks Inc. 1997, 2004.

Contents

Figures . . . . . . . . . . . . . vii

Tables . . . . . . . . . . . . . . ix

About this book . . . . . . . . . . xi Who should use this book . . . . . . . xi Typographic conventions . . . . . . . . xi Accessibility . . . . . . . . . . . . xii Notes on terminology . . . . . . . . . xii Where to find more information . . . . . xiii

Useful Web sites . . . . . . . . . xiii Making comments on this book . . . . . xiii

Chapter 1. Introducing SS7 Support for WebSphere Voice Response . . . . . . 1 What is SS7? . . . . . . . . . . . . 1 SS7 links and network components . . . . . 1 The SS7 protocol stack . . . . . . . . . 1 Using SS7 with IBM WebSphere Voice Response . . . . . . . . . . . . . 5 Example configurations . . . . . . . . 6

A minimum configuration using one pSeries computer . . . . . . . . . . . . 7 A configuration using one SS7 Server and two SS7 Clients . . . . . . . . . . 7 A configuration using two SS7 Servers and two SS7 Clients with some redundancy . . 9 A maximum configuration with full redundancy . . . . . . . . . . . 10

Chapter 2. Planning . . . . . . . . . 13 Software . . . . . . . . . . . . . 13 Hardware . . . . . . . . . . . . . 13

SS7 adapter (mandatory) . . . . . . . 13 Supported pSeries computers . . . . . 13

Configuration considerations . . . . . . 14 Licensing the Distributed7 package . . . . 14 Call capacity . . . . . . . . . . . . 15 Preparing for installation . . . . . . . . 15 Collecting System Parameters . . . . . . 16

SS7 interconnection information . . . . 16 Physical Connections . . . . . . . . 17 Grouping Connection and Addressing SS7 18 Additional Routing . . . . . . . . 18

Connecting the Voice Bearers . . . . . 18

Chapter 3. Installing SS7 Support for WebSphere Voice Response . . . . . . 21 Pre-installation checking . . . . . . . . 21 Locating the required files . . . . . . . 21 Installation on an SSI server . . . . . . . 22

Pre-installation . . . . . . . . . . 22 Installing the D7 Enablement package . . 22 Configuring the SS7 Cluster . . . . . . 23 Configuring the AIX machine for SSI Server usage . . . . . . . . . . . 23 Installation and configuration complete . . 23

Installation of SS7 Adapters . . . . . . . 23 Installation on an SS7 Server . . . . . . 23

Pre-installation . . . . . . . . . . 24 Installing the D7 and the D7 Enablement packages . . . . . . . . . . . . 24 Configuring the SS7 cluster . . . . . . 24 Configuring the AIX machine for SS7 Server Usage . . . . . . . . . . . 25 Installation and configuration complete . . 28

Installation on a WebSphere Voice Response client . . . . . . . . . . . . . . 28

Pre-installation . . . . . . . . . . 28 Installing the D7 and the D7 Enablement packages . . . . . . . . . . . . 28 Configuring the SS7 cluster . . . . . . 29 Configuring the AIX machine for WebSphere Voice Response client usage . . 29 Installation and configuration complete . . 32

Installation of a combined SS7 Server and WebSphere Voice Response client . . . . . 32

Pre-installation . . . . . . . . . . 32 Installing the D7 and the D7 Enablement packages . . . . . . . . . . . . 32 Configuring for combined WebSphere Voice Response client and SS7 Cluster . . 33 Configuring the AIX machine for WebSphere Voice Response client and SS7 Server usage . . . . . . . . . . . 34 Installation and configuration Complete . . 39

Putting into production . . . . . . . . 39 Custom servers . . . . . . . . . . 39 D7 package . . . . . . . . . . . 39

Copyright IBM Corp. 2001, 2008 iii

D7 Alarm Logging . . . . . . . . . 40

Chapter 4. Configuration using SS7itty . . 43 Preparation . . . . . . . . . . . . 43 Running SS7itty . . . . . . . . . . . 43

Configure Environmental Conditions . . . 44 Configure AIX Systems . . . . . . . 45

Configure SS7 Server . . . . . . . . . 46 Configure WebSphere Voice Response client 46 Configure SS7 Links . . . . . . . . . 47 Configure SS7 Link sets . . . . . . . . 48 Configure SS7 Route Sets . . . . . . . 49 Configure SS7 trunks to WebSphere Voice Response trunks . . . . . . . . . . 50 Generate SS7 Configuration Files . . . . . 51 Importing or exporting an SS7 configuration 52 Pack Configuration . . . . . . . . . . 52

Chapter 5. Managing and Monitoring SS7 Support for WebSphere Voice Response . 55 SS7_MAINT the general maintenance utility 55

Enablement Operation . . . . . . . 56 D7 Operation . . . . . . . . . . 56 MML Configuration Loader . . . . . . 57 HouseKeeping . . . . . . . . . . 57 D7 Maintenance programs . . . . . . 58 SS7 Server/WebSphere Voice Response client . . . . . . . . . . . . . 58 iFix Loading . . . . . . . . . . . 59 Fault Finding . . . . . . . . . . 59 D7 software release . . . . . . . . 59

ss7view D7 Enablement monitoring tool . . 60 ss7view help options . . . . . . . 60 ss7view monitor circuits . . . . . . 60 ss7view event . . . . . . . . . . 62 ss7view message . . . . . . . . . 62 ss7view trigger . . . . . . . . . . 63 ss7view -trace . . . . . . . . . . 64 ss7view stat . . . . . . . . . . . 64 ss7view info . . . . . . . . . . 65 ss7view cause . . . . . 66

SS8 commands . . . . . . . . . . . 66 AccessMonitor . . . . . . . . . . 66 AccessStatus . . . . . . . . . . . 67 ebs_showlink . . . . . . . . . . 67

D7WVRErrorReport . . . . . . . . . 68 Startup parameters . . . . . . . . . 68

Collecting event and trace information . . . 69 Event information . . . . . . . . . 69 Trace information . . . . . . . . . 69

Chapter 6. Information elements passed to WebSphere Voice Response . . . . . . 71 Tag presentation and omissions . . . . . 71 Country and network variants . . . . . . 72 Tags types and descriptions . . . . . . . 72

User-to-user information [USR2USR] . . . 72 Called Number [CLDN] . . . . . . . 72 Calling Number [CLGP] . . . . . . . 73 Original Number [ORIGIN] . . . . . . 73 Redirecting Number [REDIRN] . . . . 73 Redirecting Information [REDINFO] . . . 74 User Teleservices Information [UTI] (ITU Only) . . . . . . . . . . . . . 75 User Services Information [USI] . . . . 75 Generic Address [GENERICADDR] . . . 75 Service Activation Parameter [SERVICEACTIVATION] . . . . . . . 76 Jurisdiction Information Parameter [JINFO] 76 Party Information Parameter [PINFO] . . 77 Release Cause Codes [CAUSE] . . . . . 77 Protocol Type [PROTOCOL] . . . . . 78 Switching SS7 Default values [ISUPPARM] 78

Special case tags . . . . . . . . . . 79 Release with new Called Party Number[NEWCLDN] . . . . . . . . 79

System variables . . . . . . . . . . 79

Chapter 7. Problem determination . . . . 81 Stage 1: Is the SS7 Server working? . . . . 81

Stage 1a: Machine is not a Server . . . . 82 Stage 1b: D7 package is not running . . . 82 Stage 1c: D7 system configured for SS7 Server . . . . . . . . . . . . . 82 Stage 1d: MTP-3(upmd) / ISUP(isupd) is not running . . . . . . . . . . . 82

Stage 2: Which other machines are present? 82 Stage 2a : A machine is missing from the cluster . . . . . . . . . . . . . 83 Stage 2b: The named machine in RMTHOST has been part of the SS7 cluster but has since failed . . . . . . . . 83 Stage 2c: A machine containing an SS7 adapter card is present in the SS7 cluster, but is not activated . . . . . . . . . 83 Stage 2d: The machines within the SS7 cluster appear to be in order . . . . . 83

Stage 3: Is D7 working on a WebSphere Voice Response Client? . . . . . . . . . . 84

Stage 3a: The machine is not a WebSphere Voice Response client . . . . . . . . 84

iv SS7 Users Guide

Stage 3b: The machine is correctly running as a WebSphere Voice Response client. . . 85 Stage 3c: D7 package is not running . . . 85

Stage 4: Machine has been present in the SS7 cluster but is not now? . . . . . . . . 85

Stage 4a: The machine has been configured for SS7 Server . . . . . . . . . . 86 Stage 4b: The machine has been configured as a WebSphere Voice Response client . . 86 Stage 4c: D7 package is not running . . . 86 Stage 4d: There is a problem starting this machine as an SS7 Server . . . . . . 86

Stage 5: Two machines are not communicating . . . . . . . .