ESP Tools

The ESP also provides some software tools that can be used in special circumstances. These tools are installed on the ESP in either the /opt/aps/tools or the /opt/aps/scripts UNIX-level directories. The tools include:

PNNI Show Commands used to troubleshoot PNNI routing problems.(The PNNI Show commands are executed by pncli and have been described in Appendix A in the section PNNI Show Commands.)
Display CDR File Utilities used to convert the ESP Call Detail Records in binary format to a readable flat file (ASCII) format. (The Display CDR File utilities are described in Appendix C in the section Billing Tools.)
ApsStart can be used to start and stop the EPS processes from the UNIX prompt.
ApsUninstall can be used to uninstall the ESP software.
ApsInstall can be used to install the ESP software.
ApsClearDb can be used to clear the ESP database.

The PNNI show commands and the display CDR file utilities are installed in the /opt/aps/tools directory. The ApsStart, ApsUninstall, ApsInstall, and ApsClearDb tools are installed in the /opt/aps/scripts directory.

Caution The tools described in this appendix should only be used by trained personnel, or under the direction of Cisco StrataCom Customer Service.

ApsStart

ApsStart is a UNIX-level command to start and stop the ESP processes. It is normally not needed by an ESP user and should be used with caution. ApsStart has the following syntax:

ApsStart {start | stop}

Where the start option starts the ESP processes and the stop option stops the ESP processes.

ApsUninstall

ApsUninstall is a UNIX-level command to uninstall the ESP software. It should only be used by trained Cisco field service engineers. To run ApsUninstall, change to the directory where the command is located and enter:

./ApsUninstall

When the command is executing it will produce output similar to the following:

###################################################################
Uninstalling APS System, Copyright (c) Cisco Systems Inc. 1996-1997
###################################################################
 
Checking if APS is under execution
 
Saving database files
Removing script files
Removing user entries
Removing system entries
Changing atmconfig entry
Restoring tftp entry
mv: cannot access /tmp/tmp.3631
sed: command garbled: s/
Deleting entries in aarconfig
Removing billing directory export entries
Removing associated files and directories
 
###################################################################
Uninstalled APS successfully
###################################################################

ApsInstall

ApsInstall is normally a factory-level command and is not needed in the field since the ESP software should be downloaded from a StrataView Plus Workstation as was described in Appendix F.

To use this command, ESP software must not be loaded on your ESP platform. Then you must transfer an ESP software file (ESP_BIN_8_5.Z) to a temporary directory on the ESP. Next uncompress (uncompress filename) and tar (tar xvf ESP_BIN_8_5) the uncompressed file.

Then you could run ApsInstall, by changing to the directory where the command is located and entering:

./ApsInstall

When the command is running it will produce an output (including some prompts) similar to the following:

#################################################################
Installing APS System, Copyright (c) Cisco Systems Inc. 1996-1997
#################################################################
 
Checking already installed executables...
 
All executables present
All directories present
ATM driver installed
 
Billing directory present
Billing directory exported
 
Daemon scripts being installed...
Daemon scripts installed
 
Updating System files...
System files updated
 
Adding Logins...
apsuser, apslog and apsadmin users added
Change  password  after installation
 
Is this ESP the (P)rimary or (S)econdary host [P] ? \c
P
Updated atmconfig file
 
Do you want to create the APS startup config file now [y] ? \c
y
 
APS startup configuration:
Enter startup state (0=SHUTDOWN, 1=OOS, 2=INSRVC) :[0] \c
2
Enter startup role (0=STANDALONE, 1=ACTIVE, 2=STANDBY) :[0] \c
1
Enter network peer ip addr :\c
192.168.4.130
Creating Config file
 
Config file  created
 
 
Changing tftp daemon entry in /etc/inetd.conf file...
Changed tftp daemon entry
Updating /etc/aarconfig file...
Added entries to aarconfig file
 
#################################################################
APS Installation Completed successfully
#################################################################

ApsClearDb

The ApsClearDb command can be used to clear the ESP database. This is an extremely dangerous command and should only be used by trained Cisco StrataCom field engineers.

Table of Contents

ESP Tools

ESP Tools

ApsStart

ApsUninstall

ApsInstall

ApsClearDb