Nortel Agent Greeting NTVQ09AB, Agent Greeting NTVQ09BA Maintenance Manual

Nortel Networks Agent Greeting
NTVQ09AB & NTVQ09BA Maintenance and Troubleshooting Guide
Document Release: 3.01 Date: February 2006
Year Publish FCC TM
© 2006 Nortel Networks Corporation All rights reserved
Meridian 1 is a trademark of Nortel Networks Corporation.
Page 8 of 66
NTPH13AA_maint 3.01 February 2006
10
Page 9 of 66
Revision history
February 27th, 2006
Release of version 3.01 of this document
Sept 30th,2002
Release of version 2.05 of this document
May 5th, 2002
Draft 2.0.5 Update for 2.05 loadware release
May 5th, 2001
April 9th, 2001
October 13th, 2000
August 28th, 2000
July 19th, 2000
Draft 2.0.1 Added t rouble-shooting sec tion.
Draft 2.0. Added description of upgradePCMCIA and Multicard upgrade.
Release 1.1. Added warnings on push button reset and more CLI debug options.
Release 1.0.
Issue Draft 1.0 updates after final technical review.
Agent Greeting Card Maintenance and Troubleshooting Guide
Page 10 of 66
NTPH13AA_maint 3.01 February 2006
12
Page 11 of 66
Contents
About this guide . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Agent Greeting Card Test and Debug Capabilities 17
Self Test Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Factory Test Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
HEX Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Status LED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Reset Switch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Debug Terminal Access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Debug Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
The VxWorks Shell . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
VxWorks Shell Debug Utilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Fatal Error Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Agent Greeting Application Upgrades . . . . . . . . . 29
Single Card/Common Card Group Upgrade . . . . . . . . . . . . . . . . . . . . 32
Loadware Upgrade from PC Card (PCMCIA) . . . . . . . . . . . . . . . . 32
Loadware Upgrade from an FTP Server . . . . . . . . . . . . . . . . . . . . . 34
Mixed Card Group Upgrade . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Loadware Upgrade from PC Card (PCMCIA) . . . . . . . . . . . . . . . . 36
Loadware Upgrade from an FTP Server . . . . . . . . . . . . . . . . . . . . . 39
Card Specific Loadware Upgrades . . . . . . . . . . . . 43
VPS(NTVQ09AB) Card DSP Loadware Upgrade . . . . . . . . . . . . . . . 44
DSP Loadware upgrade from PC Card (PCMCIA) . . . . . . . . . . . . 44
DSP Loadware upgrade from an FTP Server . . . . . . . . . . . . . . . . . 45
Agent Greeting Card Maintenance and Troubleshooting Guide
Page 12 of 66 Contents
Media Card (NTVQ09BA) XA Firmware Upgrade . . . . . . . . . . . . . . 47
XA Upgrade from Compact Flash Card . . . . . . . . . . . . . . . . . . . . . 47
XA Upgrade from an external FTP Server . . . . . . . . . . . . . . . . . . . 48
Media Card (NTVQ09BA) BootROM Loadware Upgrade . . . . . . . . 49
BootROM loadware upgrade from Compact Flash Card. . . . . . . . . 49
BootROM loadware upgrade from an external FTP Server . . . . . . 50
Troubleshooting Agent Greeting . . . . . . . . . . . . . 51
Network Interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Greetings not being played . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Debugging Skillset name issues . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Telephony User Interface becoming disabled . . . . . . . . . . . . . . . . . . . 54
Multi-Card operation across routers . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Changing Multi-cast parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Agent Greeting card spontaneous reboots . . . . . . . . . . . . . . . . . . . . . . 55
Restarts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
How to change the role of a card . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
How to upgrade PC Card from 48Mb to 64MB . . . . . . . . . . . . . . . . . 57
NTPH13AA_maint version 3.01 February 2006
14
Page 13 of 66
List of tables
Table 1: Agent Greeting Hardware Platform Details . . . . . . . . . . . . . . 15
Table 1: Hex Display codes during normal operation . . . . . . . . . . . . . 18
Table 2: HEX Display codes during bootup . . . . . . . . . . . . . . . . . . . . 20
Table 3: IXP1200 Initialisation hex display error codes . . . . . . . . . . . 22
Table 4: Faceplate Mini-DIN Connector pinout . . . . . . . . . . . . . . . . . 22
Table 5: Debug Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Table 6: Multi-card specific debug commands . . . . . . . . . . . . . . . . . . 25
Table 7: Maintenance Task Fatal Errors . . . . . . . . . . . . . . . . . . . . . . . 59
Table 8: Server Task Fatal Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Table 9: VP Application Task Fatal Errors . . . . . . . . . . . . . . . . . . . . . 59
Table 10: Aries Task Fatal Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
Table 11: Client Task Fatal Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Agent Greeting Card Maintenance and Troubleshooting Guide
Page 14 of 66 List of tables
NTPH13AA_maint version 3.01 Februrary 2006
16
Page 15 of 66
About this guide
This document describes the maintenance procedures related to the Nortel Networks Agent Greeting hardware and software.
Nortel Networks Agent Greeting
Nortel Networks Agent Greeting is referred to as Agent Greeting for the remainder of this document.
Table 1 below shows the hardware platforms on which Agent Greeting operates.
Table 1: Agent Greeting Hardware Platform Details
Hardware NT Number Faceplate Label
VPS Card NTVQ09AB Agent Greeting
Media Card NTVQ09BA MC
Note: The Media Card hardware platform has an NT Number of NTVQ01BB/NTVQ01BC, but the Agent Greeting compact flash card placed in the Media Card has an NT number of NTVQ09BA and it is this number that is used throughout this document to refer to Media Card Agent Greeting.
For new orders of the Agent Greeting product, Media Card (NTVQ09BA) will be issued rather than VPS (NTVQ09AB).
However, the Agent Greeting Functionality is identical on both platforms.
Agent Greeting Card Maintenance and Troubleshooting Guide
Page 16 of 66
Also, both platforms are interoperable in an Agent Greeting Multicard Group. i.e. VPS (NTVQ09AB) and Media Card (NTVQ09BA) can be used together in the same Agent Greeting group.
NTPH13AA_maint 3.01 February 2006
66
Page 17 of 66
Agent Greeting Card Test and Debug Capabilities
The Agent Greeting Card provides maintenance and diagnostic features at various technical levels to identify and clear fault conditions. Also included are upgrade features which require the user to have access to VxWorks. The Agent Greeting Card features include:
Self Test Features
Factory Test Features
Debug Features (user name and password required)
VxWorks Shell Debug Utilities
Agent Greeting Card Maintenance and Troubleshooting Guide
Page 18 of 66 Agent Greeting Card Test and Debug Capabilities
Self Test Features
The Agent Greeting Card runs various diagnostics to detect hardware faults and ensure correct operation. The test coverage breaks down into the following categories:
8051 co-processor power up self tests
•BIOS diagnostics
Base code self tests Progress information of self tests is available through the serial port on the
Agent Greeting Card.
Factory Test Features
Factory test features include the HEX Display, Status LED and Reset Switch.
HEX Display
The Agent Greeting base card includes a HEX LED display to pro vide status information duri ng maintenance op erations. During power-up an d diagnosti c tests, this display provides a visual progress indication, and information on the first failure detected. The HEX LED display codes are indicated in Table 2, “: HEX Display codes during bootup,” on page 20.
During normal operation the display cycles through the number of enabled M2616 (Aries) ports, the number of booted DSP ports, the number of channels authorised by a keycod e, and the total channel capacity of the card. For example the HEX display could contain:
Table 1: Hex Display codes during normal operation
Display Field
A:XX Number of enabled Agent Greeting Ports D:XX Number of installed DSP ports K:XX Capacity of card enabled via Keycode C:XX Current capacity of card (smallest of A,D & K)
Meaning
NTPH13AA_maint 3.01 February 2006
66
Page 19 of 66
Table 1: Hex Display codes during normal operation
The RS—232 port may also be used to monitor the progress of self tests. Messages indicating the completion of each self test phase, as well as any detected faults will be printed to this port. Support for boundary scan and access to the boundary scan interface on the FPGAs is provided.
Status LED
A single red LED is provided on the faceplate to indicate the enabled / disabled status of the Agent Greeting Card, as well as providing an indication of the status of the power on self test.
The LED is OFF if:
the channel capacity of the Agent Greeting Card is non-zero.
Display Field
MAIN The card is in mai ntenan ce mode (Al l port s ar e
Meaning
disabled)
The card is in the normal mode of operation. The LED is ON if:
the channel capacity of the Agent Greeting Card is zero.
The card is in maintenance mode.
and
or
Agent Greeting Card Maintenance and Troubleshooting Guide
Page 20 of 66 Agent Greeting Card Test and Debug Capabilities
!
Reset Switch
A reset switch is provided on the faceplate to allow an operator to manually
CAUTION
Before using the Reset switch ensure that the Agent Greeting card has been disabled in LD 32 using the DISC command. Otherwise some of the ports may cause an OVD error on the Meridian CPU and become disabled when the card resets. Once the card is active again (the HEX display has passed T:21 on a VPS(NTVQ09AB) Card or T:22 on a Media Card (NTVQ09BA)) re-enable the card in LD 32 using the ENLC command.
reset the card without having to power down. This switch is normally used to clear a fault condition during setup or during non-traffic periods.
Table 2: HEX Display codes during bootup
Display Code VPS (NTVQ09AB) Definition
T:00 Initialization Initialization T:01 Testing Internal RAM Testing Internal RAM T:02 Testing ALU Testing ALU T:03 Testing address modes Testing address modes T:04 Testing Boot ROM Testing watchdog T:05 Testing timers Testing 8051 co-processor T:06 Testing watchdog Testing timers T:07 Testing external RAM Testing external RAM T:08 Testing Host DPRA M Testing done T:09 Testing DS30 DPRAM Programming timeswitch FPGA T:10 Testing for presence of dongle
(see note below) T:11 T e sti ng flas h memory Testing host DPRAM T:12 Program ming PCI FPGA Testing DS30 DPRAM T:13 Programming DS30 FPGA Testing SEEPROM
Media Card (NTVQ09BA) Definition
Programming ISPDI FPGA
NTPH13AA_maint 3.01 February 2006
Agent Greeting Card Test and Debug Capabilities Page 21 of 66
Table 2: HEX Display codes during bootup
Display Code VPS (NTVQ09AB) Definition
T:14 Programming CEMUX FPGA Booting IXP1200, waiting for
T:15 Programming DSP FPGA Not used at present T:16 Testing CEMUX interface Not used at present T:17 Testing EEPROM Not used at present T:18 Booting 486, waiting for response
with self test information
T:19 Waiting for application start-up
message from 486
T:20 CardLAN enabled, waiting for
Request Config. Message
T:21 CardLAN operational, A07
enabled, display now under host control
T:22 Not used at present CardLAN operational, A07
Media Card (NTVQ09BA) Definition
response from selftest information.
Not used at present
Not used at present
Waiting for application start-up message from IXP1200
CardLAN enabled, waiting for Request Config. Message
enabled, display now under host control
Note: The security dongle is required for normal Agent Greeting Card operation. A keycode is supplied during installation, which is matched to the dongle, and authorises a number of channels for use.
The Agent Greeting Card reports a missing dongle during boot up via a message on the serial connection. Once a dongle is inserted, the serial number is report ed during boot up.
On Media Card Agent Greeting (NTVQ09BA), if the internal RAM test, ALU test, address mode test, boot ROM test, timer test or external RAM test fails, the pack goes into a maintenance loop as no further processing is possible. If a test fails, “F:XX” appears on the hex display for three seconds after the “T:13” message, with the “XX” indicating the test that failed. For example, if the 8051 co-processor test failed, “F:05” is displayed. IF more than one test fails, the message indicates the first failure.
Agent Greeting Card Maintenance and Troubleshooting Guide
Page 22 of 66 Agent Greeting Card Test and Debug Capabilities
In addition on Medi a Card Agen t Greeting (NTVQ09BA), if the IXP1200 encounters any failures during it’ s initialisation, a “H:XX” error code appears on the hex display. The list of error codes are as follows:
Table 3: IXP1200 Initialisation hex display error codes
Display Code Description
H:00 IXP1200 not booting H:01 SDRAM test failure H:02 SRAM test failure H:04 PCMCIA device failure H:08 Network interface failure H:10 Meridian interface failure H:20 D SP interface failure H:40 NVRAM /EEPROM interface failure H:80 PCM connector failure
Debug Terminal Access
The Agent Greeting Card Debug Terminal access is provided via an RS-232 port. This is accessible via the NTAG81CA faceplate serial cable. Messages indicating the completion of each self test phase, as well as any detected fau lts will be logged to this serial port.
The pinouts for the Mini-DIN Connector, to which the faceplate serial (aka maintenance) cable connects, are given in
The terminal connected to the serial port requires these settings: 9600bps, 8 data bits, 1 stop bit, no parity, and no flow control.
Table 4: Faceplate Mini-DIN Connector pinout
Pin No. Signal Dir Description
1 BDTRB- O Port B Data Terminal Ready
Table 4 on page 22.
NTPH13AA_maint 3.01 February 2006
Agent Greeting Card Test and Debug Capabilities Page 23 of 66
Table 4: Faceplate Mini-DIN Connector pinout
Pin No. Signal Dir Description
2 BSOUTB- O Port B Serial Data Out 3 BSINB- I Port B Serial Data In 4 SGND C Signal Ground 5 BSINA- I Port A Serial Data In 6 BCTSA- I Port A Clear To Send 7 BSOUTA- O Port A Serial Data Out 8 BDTRA- O Port A Data Terminal Ready
Debug Features
While the Agent Greeting Card is booting, the 8051 auxiliary pro cessor has control of the serial port, and uses it to provide debug information, progress of self tests, etc. Once the 8051 releases the main processor (i486 on VPS(NTVQ09AB), IXP1200 on Media Card (NTVQ09BA)) from re set, the main processor by default grants VxW orks sh ell access through this port. The Agent Greeting Card also supports remote access to the shell via telnet.
Once the card is operational, the RS—232 port may be used to monitor CardLAN and Time Compression Multiplexing (TCM) signaling between the card and the Meridian 1 system.
Agent Greeting Card Maintenance and Troubleshooting Guide
Page 24 of 66 Agent Greeting Card Test and Debug Capabilities
The VxWorks Shell
The VxWorks shell, which is used for doing some basic OA&M (the most important of which is loadware upgrade), can be accessed via a serial connection to COM1 or via a telnet connection. The shell is protected from unauthorized access by a username and pas sword. This pas sword is common across FTP, telnet and the serial port. If the shell is idle for a period of time the password and username must be reentered to gain access. This timeout defaults to 10 minutes, but can be set to any value between 30 seconds and 4095 seconds (1 hour 8 minutes 15 seconds) using the shell function shellTimeoutSet n where n is the desired timeout in seconds. The current value of the shell timeout in seconds is returned by the shell f unc tion
shellTimeoutGet.
-> shellTimeoutSet 600
-> shellTimeoutGet
The shell (and FTP) password can be changed using the shell function shellPasswordSet. Invoking this command will prompt you for the current username, current password, new username, new password and a final confirmation of the new password.
-> shellPasswordSet Enter current username: username1 Enter current password: password1 Enter new username: username2 Enter new password: password2 Enter new password again to confirm : pass wor d2
The shell timeout, username and passw ord are stored in NVRAM, so changes are maintained across a reboot. The default username and password are “vpsdseuser” and “welcome2vp” respectively.
Note: Once the shell username and password have been successfully entered the user has complete access to all the VxWorks commands. Incorrect usage of some shell commands will cause the VP to reboot and may change operati onal beha vior.
NTPH13AA_maint 3.01 February 2006
Agent Greeting Card Test and Debug Capabilities Page 25 of 66
VxWorks Shell Debug Utilities
Several debug utilities are available from the VxWorks shell which can be used to print the state of certain global variables. A list of available debug commands is provide in
Table 5: Debug Commands
Command Description
clientDebugOn Enable debugging information on TTY interface clientDebugOff Disable debugging information on TTY interface printAllErrors Prints logged fatal errors getAriesState Prints current st a te of all 32 M26 16 (Arie s) sets printAriesState x Prints globals assoc ia ted w ith M2 616 (Aries) set ‘x’ printVpGlobs Prints all VP globals printVpChannel x Prints globals assoc ia ted w ith VP chan nel ‘x’ tr “tMaint” Resumes suspended task ‘tMaint’ swInfoGet Prints the loadware, DSP and 8051XA firmwa re
ifShow Prints the IP and Ethernet addresses inetstatShow Prints the status of all network links ping “10.85.15.60”,x Pings IP address 10.85.15.60 ‘x’ number of times.
Table 5.
versions
Press Ctrl-C to stop to return to vxWorks shell.
Table 6: Multi-card specific debug commands
Command Description
mcHelp list of multi-card debug and maintenance
commands
mcStatus status of the Agent Greeting applicat ion and of the
status of the cards in the group
mcShellMCCheckUp runs a seri es of diagnostic tests. If trouble is
reported about missing tasks, or multicast, or memory allocation, try to recover in using mcShellMCRestart
mcShellPrintLastLog display the LOG info of previous sessions (before
command
reboot). May contain the reason of previous reboot.
mcShellPrintCurrentLog display the current LOG file (last dbLog_xxx file in
"/A:DEBUG" directory)
Agent Greeting Card Maintenance and Troubleshooting Guide
Loading...
+ 43 hidden pages