Lucent Technologies AP-3, AP-4, AP-5, AP-6 User Manual
APS (Application Plus Server) 4.1
Users Guide
101-1830-001
Issue 1.0
June 1999
Copyright 1999, Lucent Technologies
All Rights Reserved, Printed in U.S.A.
Notice
Every effort was made to ensure that the information in this book was
complete and accurate at the time of printing. Howev er, information is
subject to change.
Your Responsibility for Y our System’s Security
Toll fraud is the unauthorized use of you r te lecommunications system by
an unauthori zed party, for exampl e, persons othe r than your company’s
employees, agents, subcont ra ctors, or persons working on your com pany’s behalf. Note that th ere may be a risk of toll fraud associat ed with
your telecommunications system and, if toll fraud occurs, it can result in
substantial additional charges for yo ur te le c om munications services.
Y ou and your system manager are responsible for the security of your system, such as programming and configuring your equipm ent to prevent
unauthorized use. The system ma nager is also responsible for reading all
installation, instruction, and system admi nist ra ti on documents provided
with this product in order to f ully understand the features tha t c an int roduce risk of toll fraud and the steps th at can be t ake n t o r ed uce that risk.
Lucent Technologies does not warrant that this product is immune from or
will prevent unauthorized use of common-carrie r te le communication services or facilities accessed through or connected to it. Lucent Technologies will not be responsible for any charges th at resul t from such
unauthorized use.
Lucent Technologies Fraud Intervention
If you suspect you are being victimized by toll fraud and you need technical support or assistance, call the appropriate BCS National Custom er
Care Center telephone number. Users of the MERLIN®, PARTNER®,
and System 25 products should call 1 800 628 2888 . Users of the System
75, System 85, DEFINITY® Generic 1, 2 and 3, and DEFINITY® ECS
products should call 1 800 643 2353 . Cu stome rs outside the continental
United States should contact their local Lucent rep resentative, or call one
of the above numbers in the fol lowi n g manner:
• Dial the International Access Code; for example, 011.
• Dial the country code for the U.S., that is, 01.
• Lastly, dial eithe r of th e telephone numbers pr ovided above.
Lucent Technologies W eb Page
The world wide web home page for Lucent Technologies is:
http://www .lucent.com
Federal Communications Commission Statement
Part 15: Class A S t atement. This equipme nt has bee n tested a nd found
to comply with the limits for a Class A digital device, pursuant to Part 15
of the FCC Rules. These limits are designed to provide reasonable protection against harmful interference when the equipment is operated in a
commercial environment. This equipment generates, uses, and can radiate
radio-frequency energy an d, if not inst al le d and used in accordance with
the instructio ns, may cause h armful inter ference to ra dio comm unicat ions.
Operation of this equipment in a residential area is likely to cause harmful
interference, in whic h case the use r will be requir ed to corr ect th e inte rfe rence at his own expense.
Industry Canada (IC) Interference Information
This digital apparatus does not exc e ed t he Cla ss A lim its for ra dio noise
emissions set out in the radio interference regulations of Industry Canada.
Le Présent Appareil Nom
érique n’é
met pas de bruits radioélectriques
dépassant les limites app lic ables aux appareils numériques de la class A
préscrites dans le reglement sur le brouillage radioélectrique édicté par le
Industri e Canada.
Trademarks
See the preface of this document.
Ordering Information
Call: Lucent Technologies BCS Publications Cent er
Voice 1 800 457-1235 International Voice 317 322-6791
Fax 1 800 457-1764 International Fax 317 322-6699
Write: Lucent Technologies BCS Publications Center
2855 N. Franklin Road
Indianapolis, IN 46219
Order: Document No. 101-183 0-001
Issue 1, June 1999
For additional document s, re fe r to th e sec ti on in “About This Document”
entitled “Rel ated Resources.”
You can be placed on a standing order li st fo r thi s and other documents
you may need. For more information on standing orders, or to be put on a
list to receive future issues of th is document, contact the Luc en t Technologies Publications Center.
Obtaining Products
To learn more about Lucent Technologies products and to order products,
contact Lucent Direct, the direct-market organization of Lucent Technologies Business Communications Systems. Access their web site at
www.lucentdirect.com. Or call the following numbers: customers 1 800
451 2100, account executives 1 888 778 1880 (voice) or 1 888 778 1881
(fax).
Warranty
Lucent Technologies provides a limited warranty on this product. Refer to
the “Limited Use Software License Agreement” card provided with your
package.
European Union Declaration of Conformity
The “CE” mark affixed to the equipment means that it conforms to the
above directives. Lucent Technologies Business Communications Systems declares tha t APS equi pmen t spec ifi ed in this do cumen t conf orms to
the referenced European Union(EU) Directives and Harmonized Standards listed below:
EMC Directive 89/336/EEC
Low-Voltage Directive 73/23/EEC
Comments
To comment on this docu ment, retur n the co mment car d at t he back of thi s
document.
Acknowledgment
This document was prepared by the Product Documentation Development, Lucent Technologies, Denver, CO and Columbus, OH Middletown,
NJ.
101-1830-001 Issue 1.0 iii101-1830-001 Issue 1.0
About This Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Audience Statement. . . . . . . . . . . . . . . . . . . . . . . . . . . . .17
Purpose Statement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18
Help and Technical Support. . . . . . . . . . . . . . . . . . . . . . .19
Conventions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20
Related Documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21
Electronic Version. . . . . . . . . . . . . . . . . . . . . . . . . . .21
Other Manuals. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21
Informix Manuals . . . . . . . . . . . . . . . . . . . . . . . . . . .21
Sun Manuals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21
NewNet Manual . . . . . . . . . . . . . . . . . . . . . . . . . . . .21
ISSG Manuals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21
Lucent and Octel Manuals . . . . . . . . . . . . . . . . . . . .21
Commenting on This Document . . . . . . . . . . . . . . . . . . .22
Trademarks and Registered Trademarks . . . . . . . . . . . . .22
Chapter 1 Overview
Overview of the APS Environment . . . . . . . . . . . . . . . . . . . .25
Components. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .25
Software Constructs. . . . . . . . . . . . . . . . . . . . . . . . . . . . .27
APS 4.1 Environment . . . . . . . . . . . . . . . . . . . . . . . . . . .28
APS 4.1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .28
ERP 2.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .28
APS 4.1 New Features. . . . . . . . . . . . . . . . . . . . . . . . . . .29
Upgrade to Informix 7.3 . . . . . . . . . . . . . . . . . . . . . .29
TCP/IP Interface to Sierra/CA . . . . . . . . . . . . . . . . .29
TCP/IP Alarm Functionality. . . . . . . . . . . . . . . . . . .29
TCP/IP Connectivity Check . . . . . . . . . . . . . . . . . . .29
ERP 2.0 New Features. . . . . . . . . . . . . . . . . . . . . . . . . . .30
Inclusion of ERP as a Custom Application. . . . . . . .30
ERP Supports Multiple APSs . . . . . . . . . . . . . . . . . .30
Initialization on Reboot . . . . . . . . . . . . . . . . . . . . .30
APS 4.0 Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .32
SS7 Interface to HLR . . . . . . . . . . . . . . . . . . . . . . . .32
Upgrade to Solaris 2.6 . . . . . . . . . . . . . . . . . . . . . . .32
Software Packaging Improvements. . . . . . . . . . . . . .32
Initialization on Reboot . . . . . . . . . . . . . . . . . . . . .32
APS (Application Plus Server) 4.1 Users Guide
iv 101-1830-001 Issue 1.0101-1830-001 Issue 1.0
Passive Alarm Monitoring Interface . . . . . . . . . . . . 32
System Heartbeat. . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Communication Protocols. . . . . . . . . . . . . . . . . . . . . . . . . . . 34
OCL Versions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
SMPP Protocol . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
SS7, IS-41C, TCAP. . . . . . . . . . . . . . . . . . . . . . . . . 34
SMTP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
TCP/IP Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
PPP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Description of APS Hardware . . . . . . . . . . . . . . . . . . . . . . . 36
APS Sun System. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
APS System Hardware Configuration. . . . . . . . . . . 36
ERP System Hardware Configuration. . . . . . . . . . . 37
Hardware Base for Small ERP Configuration. . . . . 38
Hardware Base for Large ERP Configur ation. . . . . 38
Description of APS Software . . . . . . . . . . . . . . . . . . . . . . . . 39
APS Software. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
ERP Software. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
VPM Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
License Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
Chapter 2 Installing APS
Getting Started . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Routine Operations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Required Items and Information. . . . . . . . . . . . . . . . . . . . . . 43
Installing New Hardware Systems . . . . . . . . . . . . . . . . . . . . 45
Assembling the Sun Hardware. . . . . . . . . . . . . . . . . . . . 45
Setting Up APS Hardware . . . . . . . . . . . . . . . . . . . . . . . 45
Installing Circuit Cards . . . . . . . . . . . . . . . . . . . . . . 46
Installing the Second Hard Disk . . . . . . . . . . . . . . . 46
Installing the External Disks . . . . . . . . . . . . . . . . . . 46
Powering Up the A1000 . . . . . . . . . . . . . . . . . . . . . 47
Modem Connections . . . . . . . . . . . . . . . . . . . . . . . . 47
Assembling the ERP Hardware . . . . . . . . . . . . . . . . . . . 48
Cabling the ERP System . . . . . . . . . . . . . . . . . . . . . . . . 48
Setting Up the LAN Switch . . . . . . . . . . . . . . . . . . . . . . 48
Installing the Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
APS (Application Plus Server) 4.1 Users Guide
v 101-1830-001 Issue 1.0101-1830-001 Issue 1.0
Installing the APS Tape . . . . . . . . . . . . . . . . . . . . . . . . . 50
Installing the ERP Tape . . . . . . . . . . . . . . . . . . . . . . . . . 54
Installing the Application. . . . . . . . . . . . . . . . . . . . . . . . 54
Configuring the System Heartbeat File . . . . . . . . . . . . . 54
Configuring Communications . . . . . . . . . . . . . . . . . . . . 54
Cabling and Configuring TCP/IP
from the Sierra/CA Side . . . . . . . . . . . . . . . . . . . . . 55
Cabling and Configuring TCP/IP
from the APS Side. . . . . . . . . . . . . . . . . . . . . . . . . . 58
Cabling and Configuring
X.25 Links on the Sierra/CA Side. . . . . . . . . . . . . . 58
Cabling and Configuring
X.25 Links on the APS Side . . . . . . . . . . . . . . . . . . 61
Starting the X.25 Tool . . . . . . . . . . . . . . . . . . . . . . . 62
Using the Link Editor . . . . . . . . . . . . . . . . . . . . . . . 64
LAPB/WAN Parameters . . . . . . . . . . . . . . . . . . . . . 66
Addressing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
CUG and Facilities . . . . . . . . . . . . . . . . . . . . . . . . . 68
Link Modes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
Throughput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
Timers and Counters . . . . . . . . . . . . . . . . . . . . . . . . 71
Special . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
X32 Authentication . . . . . . . . . . . . . . . . . . . . . . . . . 73
Routing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
Modifying the Profiles . . . . . . . . . . . . . . . . . . . . . . . . . . 76
Placing Test Calls. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
Generating Test Reports. . . . . . . . . . . . . . . . . . . . . . . . . 76
Soaking. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
Software Upgrades . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Upgrading from APS 3.x to APS 4.1. . . . . . . . . . . . . . . 77
Upgrading from APS 4.0 to APS 4.1 . . . . . . . . . . . . . . 77
Required Items. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Check the External Disk Array . . . . . . . . . . . . . . . . 77
Procedure to Upgrade to APS 4.1 . . . . . . . . . . . . . . 79
Chapter 3 Menu Interface
Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
APS Menu Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
APS (Application Plus Server) 4.1 Users Guide
vi 101-1830-001 Issue 1.0101-1830-001 Issue 1.0
Main Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
Script Menu. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
New, Open, and Delete Items. . . . . . . . . . . . . . . . . . . . . 86
Print . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
Quit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
View Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
Gen Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
Debug Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
Script Information Log. . . . . . . . . . . . . . . . . . . . . . . . . . 89
Status Log. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
Application. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
System Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
Script Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
The Profile Window. . . . . . . . . . . . . . . . . . . . . . . . . 91
Parts of the Profile Window. . . . . . . . . . . . . . . . . . . 92
Server/Protocol Enable Options . . . . . . . . . . . . . . . 94
TCP/IP Enable Option. . . . . . . . . . . . . . . . . . . . . . . 95
SMPP Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
OSA Server Options . . . . . . . . . . . . . . . . . . . . . . . . 97
HLR Server Options . . . . . . . . . . . . . . . . . . . . . . . . 98
SS7 Enable Options. . . . . . . . . . . . . . . . . . . . . . . . . 99
Disable Option. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
Auto Restart Option. . . . . . . . . . . . . . . . . . . . . . . . . 101
Type 40 Mailbox Number . . . . . . . . . . . . . . . . . . . . 101
Script Type Option. . . . . . . . . . . . . . . . . . . . . . . . . . 101
Buttons. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
Scripts Control Manager . . . . . . . . . . . . . . . . . . . . . . . . 103
Configurable Parameters . . . . . . . . . . . . . . . . . . . . . . . . 103
Runtime Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
Application Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
Logger Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
Script Tracer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
RMPP Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
SS7 Gateway . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
Utility Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
Export. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
Import. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
Wizard Backup. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
APS (Application Plus Server) 4.1 Users Guide
vii 101-1830-001 Issue 1.0101-1830-001 Issue 1.0
Printer Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
System Performance. . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
Cron Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
License . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
Application. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
Database Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
Dynamic SQL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
Select SQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
Chapter 4 Procedures
APS System-wide Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
Starting the APS Interface . . . . . . . . . . . . . . . . . . . . . . . 112
Quitting the APS Interface. . . . . . . . . . . . . . . . . . . . 113
Starting the Informix Database . . . . . . . . . . . . . . . . 113
Closing an Informix Session . . . . . . . . . . . . . . . . . . 113
Setting the Status Log File Size. . . . . . . . . . . . . . . . 114
Stopping the Volume Manager . . . . . . . . . . . . . . . . 114
Using Sun’s X.25 Tool . . . . . . . . . . . . . . . . . . . . . . 114
Monitoring System Performance. . . . . . . . . . . . . . . 115
Administering Hostnames and TCP/IP Addresses . 115
Replacing a Hard Disk. . . . . . . . . . . . . . . . . . . . . . . 116
Application-specific Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . 117
Working with Scripts, Script Groups,
and Applications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
Managing Scripts, Script Groups, and Applications . . . 118
Creating Script Groups or Applications . . . . . . . . . 119
Starting an Application Automatically . . . . . . . . . . 121
Starting a Script Group or Application Manually . . 122
Stopping a Script Group or Application . . . . . . . . . 122
Starting a Single Script . . . . . . . . . . . . . . . . . . . . . . 123
Stopping a Single Script . . . . . . . . . . . . . . . . . . . . . 124
Deleting a Script from a Script Group. . . . . . . . . . . 125
Deleting a Script Group. . . . . . . . . . . . . . . . . . . . . . 125
Shutting Down All Active Sessions . . . . . . . . . . . . 126
Shutting Down a Script Group . . . . . . . . . . . . . . . . 126
Monitoring Scripts, Script Groups, and Applications . . 127
Creating, Opening, and Deleting Scripts. . . . . . . . . 127
Starting Scripts in Test Mode . . . . . . . . . . . . . . . . . 128
APS (Application Plus Server) 4.1 Users Guide
viii 101-1830-001 Issue 1.0101-1830-001 Issue 1.0
Stopping a Script in Test Mode . . . . . . . . . . . . . . . . 128
Monitoring a Script Session. . . . . . . . . . . . . . . . . . . 129
Monitoring a Script with the X.25 Trace Tool. . . . . 129
Checking an Application’s Runtime Status. . . . . . . 129
Checking an Application’s Runtime Status
by Process Level . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
Checking an Application’s Runtime Status
by Usage Level . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
Debugging Scripts . . . . . . . . . . . . . . . . . . . . . . . . . . 133
Working with Profiles. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
Viewing the Profile Window . . . . . . . . . . . . . . . . . . 134
Renaming Profiles . . . . . . . . . . . . . . . . . . . . . . . . . . 134
Modifying Profiles. . . . . . . . . . . . . . . . . . . . . . . . . . 135
Creating New Profiles . . . . . . . . . . . . . . . . . . . . . . . 136
Importing and Exporting Data . . . . . . . . . . . . . . . . . . . . . . . 138
Importing Application-specific Utilities . . . . . . . . . 138
Importing Scripts. . . . . . . . . . . . . . . . . . . . . . . . . . . 138
Copying Scripts to a Diskette . . . . . . . . . . . . . . . . . 139
Backing Up Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
Backing Up APS Files. . . . . . . . . . . . . . . . . . . . . . . 140
Regular Backup of APS. . . . . . . . . . . . . . . . . . . . . . 140
Registration and Licensing Tasks . . . . . . . . . . . . . . . . . . . . . 141
Registering APS Software. . . . . . . . . . . . . . . . . . . . 141
Checking the License. . . . . . . . . . . . . . . . . . . . . . . . 142
SS7 Gateway Tasks. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
Changing an SS7 Configuration File. . . . . . . . . . . . 145
Configuring the SS7 Gateway. . . . . . . . . . . . . . . . . 146
Starting and Stopping the SS7 Gateway . . . . . . . . . 147
Administering the Signaling Point Code. . . . . . . . . 148
Monitoring SS7 Gateway . . . . . . . . . . . . . . . . . . . . 150
Displaying the State of the SS7 Links. . . . . . . . . . . 151
Changing the State of the SS7 Links. . . . . . . . . . . . 151
Application Manager Tasks . . . . . . . . . . . . . . . . . . . . . . . . . 156
Starting and Stopping the Application Manager . . . 156
Checking the Application Manager’s
Runtime Status. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
Logger Manager Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
Starting and Stopping the Logger Manager. . . . . . . 159
Checking Logger Manager Status. . . . . . . . . . . . . . 159
101-1830-001 Issue 1.0 ix101-1830-001 Issue 1.0
Cron Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .161
Starting and Stopping Cron Tasks. . . . . . . . . . . . . . .161
Modifying Cron Tasks. . . . . . . . . . . . . . . . . . . . . . . .161
Monitoring Cron Task Status . . . . . . . . . . . . . . . . . .163
Using SQL Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .164
Executing SQL Commands Without Output. . . . . . .164
Executing SQL Queries With Output . . . . . . . . . . . .165
Printing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .167
Configuring Printers . . . . . . . . . . . . . . . . . . . . . . . . .167
Printing a Script . . . . . . . . . . . . . . . . . . . . . . . . . . . .168
Viewing Logs and Script Information . . . . . . . . . . . . . . . . . .169
Viewing the Status Log File . . . . . . . . . . . . . . . . . . .169
Viewing Script Information. . . . . . . . . . . . . . . . . . . .171
Viewing the Debug Log . . . . . . . . . . . . . . . . . . . . . .173
Chapter 5 Troubleshooting
Starting and Stopping the Sun System. . . . . . . . . . . . . . . . . .176
Starting the APS Sun System . . . . . . . . . . . . . . . . . . . . .176
Starting the ERP Sun System . . . . . . . . . . . . . . . . . . . . .177
Rebooting the Sun System. . . . . . . . . . . . . . . . . . . . . . . .177
Graceful Reboot . . . . . . . . . . . . . . . . . . . . . . . . . . . .178
Hard or Emergency Reboot. . . . . . . . . . . . . . . . . . . .178
Shutting Down the APS Sun System. . . . . . . . . . . . . . . .179
Shutting Down the ERP Sun System. . . . . . . . . . . . . . . .180
Shutting Down the X.25 Links . . . . . . . . . . . . . . . . . . . .180
Tracking APS Problems. . . . . . . . . . . . . . . . . . . . . . . . . . . . .181
General Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . .181
Keeping Records . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .181
Checking Connectivity . . . . . . . . . . . . . . . . . . . . . . . . . .181
Starting Two APS Sessions . . . . . . . . . . . . . . . . . . . . . . .182
Troubleshooting Connectivity Problems . . . . . . . . . . . . . . . .183
No Connectivity Between APS Machine and Sierra/CA 184
For Sites That Use X.25. . . . . . . . . . . . . . . . . . . . . . . . . .186
Check the X.25 Physical Connectivity . . . . . . . . . . .186
From the APS, Check the Link. . . . . . . . . . . . . . . . .186
From the Sierra/CA, Check the Link . . . . . . . . . . . .187
Place a Test Call Over the X.25 Link . . . . . . . . . . . .188
APS (Application Plus Server) 4.1 Users Guide
x 101-1830-001 Issue 1.0101-1830-001 Issue 1.0
Escalate the Problem . . . . . . . . . . . . . . . . . . . . . . . . 189
For Sites That Use TCP/IP. . . . . . . . . . . . . . . . . . . . . . . 190
Check TCP/IP Physical Connectivity . . . . . . . . . . . 190
From the Sierra/CA, Check TCP/IP . . . . . . . . . . . . 190
From the APS, Check the TCP/IP. . . . . . . . . . . . . . 190
Check the Application’s Profiles . . . . . . . . . . . . . . . 191
Place a Test Call Over the TCP/IP Link . . . . . . . . . 191
Escalate the Problem . . . . . . . . . . . . . . . . . . . . . . . . 192
Remote User Cannot Connect to APS Machine. . . . . . . 193
APS Cannot Connect to LAN/WAN . . . . . . . . . . . . . . . 195
APS Cannot Communicate With HLR. . . . . . . . . . . . . . 196
No Prompt When Accessing APS Over the Modem . . . 198
Troubleshooting Software Problems. . . . . . . . . . . . . . . . . . . 200
Loss of System Heartbeat. . . . . . . . . . . . . . . . . . . . . . . . 200
Call Tracing TCAP Messages . . . . . . . . . . . . . . . . . . . . 201
Cannot Start Application Manager. . . . . . . . . . . . . . . . . 203
Cannot Load SS7 Drivers. . . . . . . . . . . . . . . . . . . . . . . . 205
Troubleshooting Hardware Problems. . . . . . . . . . . . . . . . . . 206
Sun Reboots Without Warning. . . . . . . . . . . . . . . . . . . . 206
Common Procedures. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207
General Notes about Replacing Cards . . . . . . . . . . . . . . 207
Replacing the NewNet Card. . . . . . . . . . . . . . . . . . . . . . 209
Replacing the X.25 Card . . . . . . . . . . . . . . . . . . . . . . . . 210
Replacing the TCP/IP Card . . . . . . . . . . . . . . . . . . . . . . 210
Cleaning the Tape Drive. . . . . . . . . . . . . . . . . . . . . . . . . 211
Chapter 6 Backing Up and Restoring Data
Backing Up and Restoring the Sun System . . . . . . . . . . 213
Automatic Backups . . . . . . . . . . . . . . . . . . . . . . . . . 214
Making Manual Backups. . . . . . . . . . . . . . . . . . . . . 214
Restoring a Full or Partial Image . . . . . . . . . . . . . . . . . 215
Full System Installation and Setup . . . . . . . . . . . . . 215
Full System Recovery (no setup). . . . . . . . . . . . . . . 216
Partial System Recovery and Setup. . . . . . . . . . . . . 216
Partial System Recovery (no setup). . . . . . . . . . . . . 216
APS Backup and Restore. . . . . . . . . . . . . . . . . . . . . . . . 216
Backing Up Only APS 4.1. . . . . . . . . . . . . . . . . . . . 216
101-1830-001 Issue 1.0 xi101-1830-001 Issue 1.0
Restoring Only APS 4.1 Data . . . . . . . . . . . . . . . . .216
Informix Software Backup and Restore . . . . . . . . . . . . .217
Informix Database Backup and Restore . . . . . . . . . . . . .217
Example Output of a Database Restore . . . . . . . . . .217
Example Output of
install_fs:full recovery, (setup) . . . . . . . . . . . . . . . . .218
Example Output of
install_fs:full recovery (no setup) . . . . . . . . . . . . . . .221
Example Output of
install_fs:partial recovery (setup) . . . . . . . . . . . . . . .223
Example Output of
install_fs, partial recovery (no setup) . . . . . . . . . . . .226
Chapter 7 Errors
The Status Log File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .229
Description of the Status Log File. . . . . . . . . . . . . . . . . .229
File Formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .230
Specifying an ASCII Format. . . . . . . . . . . . . . . . . . .230
What Makes Up an Alarm . . . . . . . . . . . . . . . . . . . . . . . . . . .231
Message Syntax for Alarms. . . . . . . . . . . . . . . . . . . . . . .231
Interpreting an Error with Status Log File Codes . . . . . .232
Status Types. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .233
Module Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .233
Error Code Ranges. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .235
Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .237
Development Alarms . . . . . . . . . . . . . . . . . . . . . . . .238
Error Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . .239
200001. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .243
200005. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .244
200008. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .245
400000. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .246
501001. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .247
501002. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .250
501006. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .251
501012. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .252
501013. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .253
501020. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .254
503001. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .255
APS (Application Plus Server) 4.1 Users Guide
xii 101-1830-001 Issue 1.0101-1830-001 Issue 1.0
505001 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256
505002 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257
505005 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258
505011 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259
506002 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260
506003 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261
506004 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262
506005 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263
506006 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264
506007 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265
506011 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266
508001 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267
508002 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268
508003 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269
508004 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270
508005 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271
517003 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272
518003 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273
518004 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274
518005 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275
518006 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276
518007 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277
518010 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278
523000 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279
5230002 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280
5230003 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282
5230005 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283
5230008 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284
5230012 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285
524027 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286
600000 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288
600001 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289
600002 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291
600003 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293
600004 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294
600010 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295
600011 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296
600012 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297
101-1830-001 Issue 1.0 xiii101-1830-001 Issue 1.0
600013. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .299
600014. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .300
600015. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .301
600016. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .302
600017. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .303
600018. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .304
600019. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .305
600020. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .306
600021. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .307
600022. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .308
600023. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .309
600024. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .310
600025. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .311
600026. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .312
600027. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .313
600028. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .314
600029. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .315
600030. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .316
600031. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .317
600032. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .318
600033. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .319
600034. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .320
600035. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .321
600037. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .322
600038. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .323
600039. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .324
600040. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .325
600041. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .326
600042. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .327
700001. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .329
700002. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .330
700003. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .331
700004. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .332
700005. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .333
700006. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .334
700007. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .335
700008. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .336
Passive Alarm Monitoring . . . . . . . . . . . . . . . . . . . . . . . . . . .337
APS (Application Plus Server) 4.1 Users Guide
xiv 101-1830-001 Issue 1.0101-1830-001 Issue 1.0
EAP-related Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338
Interpreting EAP Errors . . . . . . . . . . . . . . . . . . . . . . . . . 338
Resolving EAP-related Errors . . . . . . . . . . . . . . . . . . . . 343
TCAP Errors. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345
TCAP Return Error Codes. . . . . . . . . . . . . . . . . . . . 345
TCAP Access Denied Reasons . . . . . . . . . . . . . . . . 346
TCAP Non-requested Specific Errors . . . . . . . . . . . 346
Appendix A Enhanced Reporting Platform
Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347
Advantages of ERP . . . . . . . . . . . . . . . . . . . . . . . . . 348
Connectivity. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348
Processing Cycle . . . . . . . . . . . . . . . . . . . . . . . . . . . 348
Administration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349
Assembling the ERP Hardware . . . . . . . . . . . . . . . . . . . . . . 350
Cabling the ERP System. . . . . . . . . . . . . . . . . . . . . . . . . . . . 351
Installing and Administering ERP . . . . . . . . . . . . . . . . . . . . 352
Phase I Installation Procedures . . . . . . . . . . . . . . . . . . . 352
Required Items and Information . . . . . . . . . . . . . . . 352
Loading the ERP System. . . . . . . . . . . . . . . . . . . . . 353
Loading ERP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353
Installing the License Information. . . . . . . . . . . . . . 355
Phase II Installation Procedures. . . . . . . . . . . . . . . . . . . 358
Phase III Installation Procedures . . . . . . . . . . . . . . . . . . 360
Configuration File Description . . . . . . . . . . . . . . . . 360
Report Executables . . . . . . . . . . . . . . . . . . . . . . . . . 364
Administering Reports. . . . . . . . . . . . . . . . . . . . . . . 366
Uninstall Procedures . . . . . . . . . . . . . . . . . . . . . . . . . . . 368
Executing ERP Software . . . . . . . . . . . . . . . . . . . . . . . . . . . 369
Error Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 370
Backup and Restore Procedures . . . . . . . . . . . . . . . . . . . . . . 372
Backing Up ERP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372
Full Backup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372
Restoring ERP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372
Partial Restore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372
Full Restore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372
Troubleshooting ERP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 375
101-1830-001 Issue 1.0 xv101-1830-001 Issue 1.0
Developing Custom Reports . . . . . . . . . . . . . . . . . . . . . . . . .377
Relinking with Logging Stub . . . . . . . . . . . . . . . . . .377
Indexing on hr_int. . . . . . . . . . . . . . . . . . . . . . . . . . .377
Glossary, Abbreviations, and Acronyms . . . . . . . . . . . . . . . . . 379
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 389
APS (Application Plus Server) 4.1 Users Guide
xvi 101-1830-001 Issue 1.0101-1830-001 Issue 1.0
101-1830-001 Issue 1.0 17
About This Book
This manual describes the Application Plus Server (APS) 4.1 software
platform. Use this manual with applications such as Inbound Call
Completion (ICC) 1.1.
Audience Statement
This documentation is written for the following audiences:
This guide is not intended for programmers developing custom
applications or fo r the end custo mer with th e exceptio n of the customer as
maintainer.
Software support staff Both onsite and remote. This
audience is familiar with
programming wizards, may or
may not be familiar with the
C programming language, and
has an intermediate un derstanding
of UNIX or SunOS. Specifically,
this audience incl udes appli cation
programmers, application
maintainers, and member s of RSC
(Regional S ervice Center).
Platform maintainers Lucent employees or customers
who mainta in the APS platform
software at APS sites
Lucent’s applications sales force Lucent employees who market
APS (Application Plus Server)
software and its applications
APS (Application Plus Server) 4.1 Users Guide
18 101-1830-001 Issue 1.0
In general, the audience for this book should have the following
experience and expertise:
n Sun system administration
n Beginning-level Sierra and CA (Caller Applications)
maintenance knowledge
n X.25 networking experience
n TCP/IP networking experience
n Knowledge of SS7 (Signali ng System 7) pro tocol, inclu ding HLR
(Home Location Register)
n Beginning understanding of relational database commands
n Beginning understanding of C programming language
n Basic techniques for handling hardware and electrical
components
Purpose Statement
The purpose of this document is to:
n Help the onsite work force, syst em admi nis tr at or, or programmer
to use the AP S platform software
n Instruct an installer how to load new versions and upgrade
previous versions of APS in 2 hours or less
n Provide a reference to alarms generated by the APS platform
software
n Provide fault isolation and problem-solving procedures for
troubleshooting errors
This guide does not discuss the Sun hardware components of the APS
system. Please refer to the documentation that came with your hardware.
101-1830-001 Issue 1.0 19
Help and Technical Support
You can reach Lucent Octel Messaging Division (OMD) by phone, fax,
e-mail, and the Internet.
For telephone assistance about APS software:
Call 408-922-1822.
This is the Lucent Technologies OMD help line.
Press 1 (Sierra menu option ) and then 4 (Direct Support menu
option) to navigate the phone menu.
Have ready:
n The serial number of the Sierra/CA
n Which Sierra/CA you are calling on
n The APS system’s serial number
For specific training information:
Call 1-800-OCTEL92 (1-800-628-3592), or 1-408-324-6572
To reach us by e-mail:
Address us at educational.services@octel.com
For documentation:
Call 1-800-41-OCTEL (US only)
Call 1-303-294-3735 (International)
To fax an order:
Dial 1-303-294-3737 (US and International)
If you have world wide web access go to:
http://merchant.hibbertco.com/octel/
To return to the APS help system, use the Back button in the
browser interface, or cl ick on the Company Stor e book icon in the
help system navigation pane.
APS (Application Plus Server) 4.1 Users Guide
20 101-1830-001 Issue 1.0
Conventions
This book uses the following conventions:
n The term Sierra refers to a Sierra VPM (voice processing
module).
n The term CA stands for Caller Applications VPM and was
formerly known as IMA-CA (Intelligent Messaging
Architecture-Caller Applications).
n The term Sierra/CA means either a Sierra VPM or CA VPM.
n Keys on the keyboard are all capitals:
ENTER.
n When you must press two keys at th e same time, it looks like th is:
STOP+a
n When you are told to enter a command, it means type the
command on the command line and then press the ENTER key.
n Commands are bold, regular typeface, variables in a command
line are bold and italicized:
snoop -d hme0 -x 0 > /export/home0/issg/issg_main/test.ossg
n Menu names are capitalized
n Menu items are capitalized
n Field names use Courier type:
...the Script Name field...
n Menu selections look like this:
Utility
Export
101-1830-001 Issue 1.0 21
Related Documents
Electronic Version An electronic version of this document is located inside the Lucent fire
wall in Adobe Acrobat format. Go to
http://info.dr.lucent.com/~bfthomas/aps/APS.html
Other Manuals In this manual, we may refer you to other documents. You may want to
locate them and have them at your site.
These documents are available from their vendors. You should have
received them with your hardware and software:
Informix Manuals
n Informix Error Messages, published by Informix Press
Sun Manuals
n Sun hardware docume nts
NewNet Manual This document comes with your hardware and additional copies are
available from ADC NewNet, Inc., 2 Enterprise Drive, Shelton, CT
06484:
n Connect7 Release Notes, Part No. D-0116-RN-110-001
ISSG Manuals These manuals are available from ISSG, Inc., ISSG 1580 Oakland Rc,
SWT #C210 San Jose, CA - 95131:
n Wizard Staging Guide, Volume 1, Version 1.0
n Wiz ard Sof tware 4.0
n Wizard Developer’s Guide
Lucent and Octel
Manuals
These documents are available through Lucent Technologies OMD:
n APS 4.1 Users Guide. You are reading it now.
n APS Config Note
n OCL Programmers Guide, by Octel, P/N 101-1069-001
n Release VIS 2.0 System Manager Manual
n Sierra/CA Peripheral Equipment Manual
n Sierra Enhanced Services Administrator Guide
n Sierra Octel Command Language Reference Manual
n Sierra Service Manual, Edition 5
n VIS Release 2.0 Release Guide
APS (Application Plus Server) 4.1 Users Guide
22 101-1830-001 Issue 1.0
Commenting on This Document
To comment on this manual, please direct communications to:
Lucent Technologies
Octel Messaging Division
MS C5-04
1001 Murphy Ranch Road
Milpitas, California 95035-3912
email: octeltechpubs@lucent.com
telephone: 408-384-2000
Trademarks and Registered Trademarks
Adobe is a trademark of the Adobe Systems Incorporated, which may be
registered in certain jurisdictions.
APS 4.1 is copyrighted by Lucent Technologies and Innovative Systems
Services Group, Inc.
ICC 1.1 is a copyright of Lucent Technologies.
NewNet is a trademark of ADC New Net.
OpenWindows is a trademark of Sun Micro Systems, Inc.
Sierra is a trademar k of Octe l Mes saging Divisi on, a subsi diary o f Lucent
T ech nol ogies.
CA is a trademark of Octel Messaging Division, a subsidiary of Lucent
Technologies.
SMC is a registered trademark of Standard Microsystems Corporation.
Solaris is a trademark of Sun Micro Systems, Inc.
Solstice is a trademark of Sun Micro Systems, Inc.
ST is a registered trademark of Lucent Technologies.
StorEdge A1000 is a trademark of Sun Micro Systems, Inc.
SPA RC is a tradem ark of SPARC International, I nc.
Sun is a trademark of Sun Micro Systems, Inc.
SunOS is a trademark of Sun Micro Systems, Inc.
UNIX is a registered trademark in the United States and other countries,
licensed exclusively through X OPEN Company Limited.
101-1830-001 Issue 1.0 23
Wizard is a copyright if ISSG, Inc.
x25tool is a trademark of Sun Micro Systems, Inc.
APS (Application Plus Server) 4.1 Users Guide
24 101-1830-001 Issue 1.0
101-1830-001 Issue 1.0 25
1
Overview
This chapter provides a high-level description of the APS 4.1
(Application Plus Server) environment, software, and hardware.
Overview of the APS Environment
The APS 4.1 platform software is the b ase software upon which other
APS application software resides. Currently, the APS 4.1 platform, the
ERP 2.0 report handling software, and the ICC 1.1 application are
designed to work with each other, but may be ordered separately.
APS 4.1 is backwardly compatible with APS 3.x and APS 4.0.
Components
The APS processing environment consists of:
n Sierra/CA (Caller Application) voice processing module
n Sun system, Ultra 2, for each APS machine
n NewNet card for each APS machine running SS7
n Sun system, Ultra 2, for large ERP configurations (optional)
or
Sun workstation, Ultra 5, for small ERP configurations (optional)
APS (Application Plus Server) 4.1 Users Guide
26 101-1830-001 Issue 1.0
n Disk array - Sun A1000 disk array
or
Disk array - Sun MultiPack array
n HSI card for X.25 links, if X.25 protocol is used
n LAN switch to connect th e ERP system, APS system, and
Sierra/CAs
Figure 1 shows an example of hardware components at an APS site.
Figure 1. Example Topology of an APS/ERP Site
Lan Switch
PDN
(WAN)
Sierra/CA
APS
Ultra 2
Sierra/CA
Sierra/CA
Sierra/CA
APS
Ultra 2
APS
Ultra 2
ERP
Ultra 2
LAN/WAN
Alarm
OSS
SMSC
Sendmail
Sierra/CA
Other Sierra/CA’s
APS
Ultra 2
Overview
101-1830-001 Issue 1.0 27
Software Constructs
APS 4.1 platform software uses the following softw are construc ts:
n Functional wizards
n Scripts
n Profiles
n Applications
n Cron tasks
n Sessions
Figure 2 shows how software constructs are used together to form an
application.
Figure 2. APS Programming Constructs
Script A Script B Script C
fccvwiz LJK 010699
Functional
wizard
Functional
wizard
Functional
wizard
Functional
wizard
Functional
wizard
Functional
wizard
Functional
wizard
Functional
wizard
Functional
wizard
Functional
wizard
Functional
wizard
Functional
wizard
Functional
wizard
Script A Script B Script C
Application
Profile
1
Profile
9
Profile
2
Profile
10
Profile
5
APS (Application Plus Server) 4.1 Users Guide
28 101-1830-001 Issue 1.0
APS 4.1 Environment
The APS environment consists of:
n 1 to 4 Sun systems running APS 4.1 and any APS application
n 1 Sun system running ERP 2.0 (optional)
APS 4.1 APS is a Sun-based Service Creation Environment (SCE) system. APS
was created to provide an in frast ructu re for qu ic k creat ion of val ue-ad ded
applications. Applications are developed and run from the APS in
cooperation with a Sierra/CA voice processing module.
APS 4.1 connects to internal components and external systems via
n X.25
n Modems
n SS7
n TCP/IP
APS 4.1 uses an OCL (Octel command language) in terface to control the
actions performed by the Sierra/CA. APS can sign on to a VIS 2.0
machine, but does not use any of the newer 2.0 functionality. (The term
VIS 2.0 refers to Voice Information Software version 2.0 running on a
Sierra/CA hardware platform.)
In addition to providing call flow programming, APS also acts as a
gateway to external systems and networks requiring special signaling,
such as IS-41C (Interim Standard 41, version C).
ERP 2.0 ERP runs on a Sun system apart from the APS systems. ERP off-loads
billing and reporting functions from the APS to the ERP Sun system. In
order to run reports, an ERP system is required to compliment the APS
system.
ERP releases are tied to APS releases. In APS 4.1, the current ERP
version is 2.0 and, when ordered, is provided as part of the platform.
The ERP component supports one to four APS systems.
Reports currently running from APS will be moved to the ERP system.
New reports, as needed, will run from ERP.
ERP is installed with the standard ICC application reports.
Overview
101-1830-001 Issue 1.0 29
APS 4.1 New Features
APS 4.1 introduces the following new features:
n Upgrade to Informix 7.3
n TCP/IP interface to Sierra/CA providing 432 virtual circuits
when using HLR
n TCP/IP alarm functionality
n TCP/IP connectivity checks
Upgrade to
Informix 7.3
APS 4.1 platform software uses Informix 7.3 database. This upgrade
provides the following advantages:
n New performance enhancements to its core server equates to
improved performance on key transactions
n Support for advanced data analysis
n Improved application migration
n Improved support from Informix for being on a current release
n Multithreaded architecture helps to improve performance of the
platform
TCP/IP Interface to
Sierra/CA
APS 4.1 platform software offers the option of using TCP/I P connectivi ty
between the APS Sun systems and the Sierra/CAs. When using HLR,
TCP/IP connectivity provides a maximum of 432 virtual circuits (144
virtual circuits per Sierra/CA).
TCP/IP Alarm
Functionality
In addition to TCP/ IP conne ctivity, APS 4.1 monitors the TCP/IP net work
and reports an error if con nectivity is lost.
TCP/IP Connectivity
Check
Connectivity of the TCP/IP network is checked every 15 minutes.
Connectivity checks are also performed during every reboot and at every
heartbeat measurement.
APS (Application Plus Server) 4.1 Users Guide
30 101-1830-001 Issue 1.0
ERP 2.0 New Features
ERP 2.0 introduces the following new features:
n Compatibility of ERP 2.0 with the APS 4.1 platform
n ERP support of up to 4 APSs
n Capability to handle 2 mil li on re cor ds per APS, 8 million for one
ERP
Inclusion of ERP as
a Custom
Application
Prior to APS 4.1, ERP was considered a custom application for an
APS-based application. ERP currently provides reporting capabilities for
only the ICC application.
The advantages of using ERP are to:
n Minimize the potential performance impact on call processing
that may arise if reports are generated during a heavy call load
n Shorten the processing time requir ed for generating data-
intensive reports
n Allows the APS to dedicate its resources to application
processing
n Maximizes processing of its billing reports
ERP Supports
Multiple APSs
The APS 4.1/ERP 2.0 platform supports up to four APS systems.
Initialization on
Reboot
With the inclusion of TCP/IP, initialization on reboot occurs slightly
differently from APS 4.0. When the APS Sun system is rebooted, either
by hard boot or soft boot, all nec essary APS proce sses star t automatic ally.
Briefly, initialization on reboot operates as follows:
1. Checks that the logger manager is started.
2. Performs a file system check t o make sure of the drive s’ integr ity.
3. Checks the capacity of the file systems to make sure that there is
space enough to run.
4. Checks that the X.25 links are up, if X.25 is being used.
5. Starts I nformix and then makes su re it is online.
6. Checks that the cron process is running.
7. Checks to see if an SS7 card is present, then:
Loading...