-
Cisco H.323 Signaling Interface User Guide, Release 4.2
-
Cisco H.323 Signaling Interface
-
Installing and Configuring Cisco HSI Software
-
Provisioning the Cisco HSI
-
Managing the Cisco HSI
-
Troubleshooting Cisco HSI Alarms
-
Cisco HSI Backup and Restore Procedures
-
MML User Interface and Command Reference
-
Skeleton Configuration File
-
Example of an HSI Configuration File
-
E-ISUP Cause Value-to-Name Lookup
-
E-ISUP Name-to-Cause Value Lookup
-
H.323 Name-to-Cause Value Lookup
-
H.323 Cause Value-to-Name Lookup
-
Table Of Contents
Restarting the Cisco HSI Application
Stopping the Call Processing Application
Starting the Call Processing Application
Reporting the Cisco HSI Status
Convention for Naming the Log File
Service Packages That Log Messages
Managing the Cisco HSI
Introduction
This chapter provides information about operation and management tasks for the Cisco H.323 Signaling Interface (HSI) application. This chapter contains the following sections:
•
Restarting the Cisco HSI Application
•
•
•
Restarting the Cisco HSI Application
To restart the Cisco HSI at the MML command prompt, use the restart-softw MML command. For more information about this command, see Appendix A, "MML User Interface and Command Reference."
To start the Cisco HSI application, see the "Installing the Cisco HSI" section on page 2-2.
Stopping Call Processing
To stop call processing, use the stp-callproc MML command. This command causes the handling of new call requests to cease immediately, and, if no timeout period is specified, all existing calls are released immediately. If a timeout period is specified, existing calls are released after the specified amount of time has elapsed. For more information about the stp-callproc command, see Appendix A, "MML User Interface and Command Reference."
Starting Call Processing
To start call processing, use the sta-callproc MML command. For more information about this command, see Appendix A, "MML User Interface and Command Reference."
Stopping the Call Processing Application
To stop the call processing application, use the stp-softw MML command. For more information about this command, see Appendix A, "MML User Interface and Command Reference."
Starting the Call Processing Application
To start the call processing application, use the sta-softw MML command. For more information about this command, see Appendix A, "MML User Interface and Command Reference."
Reporting the Cisco HSI Status
To display the status of the Cisco HSI, use the rtrv-softw MML command. For more information about this command, see Appendix A, "MML User Interface and Command Reference."
Measurements
The following sections describe two measurement categories:
•
•
System-Related Measurements
The CIagent is a Simple Network Management Protocol (SNMP) subagent. It handles the collection and storage of the following system performance measurements:
•
•
•
•
Use the CIAGENTSCANPERIOD parameter to define the period that the CIagent polls the CPU for utilization (see Chapter 3, "Provisioning the Cisco HSI").
Call-Related Measurements
The Cisco HSI application handles all call-related measurements. An SNMP MIB handles the collection of call-related measurement data.
The call-related measurements are organized into counter groups. The following MML counter groups are required:
•
•
•
The measurements in these groups are written to a file on disk every 30 minutes. The file name includes the date and time that measurements were written to disk.
Resetting Measurements
The clr-meas MML command resets the measurement counters. This command resets an individual counter or all counters in a counter group. The following are valid counter groups:
•
•
•
For more information about the clr-meas command, see Appendix A, "MML User Interface and Command Reference."
Retrieving Counters
Use the rtrv-ctr MML command to retrieve measurement counters. This command displays the measurements for a counter group. Valid counter groups are RAS, Q.931, and H.245. For more information about the rtrv-ctr command, see Appendix A, "MML User Interface and Command Reference."
Overload
The system continuously checks call totals and CPU utilization. Each of these values is compared to predefined limits. Three call total limits are available. Each limit has a hysteresis value and an alarm associated with it. When the call total reaches the limit, an alarm is raised. When the call total falls below the limit minus the hysteresis value, the alarm is cleared after the appropriate recovery action is taken.
Cisco HSI supports the following three levels of overload:
•
•
•
The following factors can trigger any one of the overload levels:
•
•
Disk usage can trigger a LOW_DISK_SPACE alarm. For more information about this alarm, see Chapter 5, "Troubleshooting Cisco HSI Alarms."
Overload Level 1
Use the following configuration parameters for overload level 1 (see Chapter 3, "Provisioning the Cisco HSI"):
•
•
•
•
•
•
Overload Level 2
Use the following configuration parameters for overload level 2 (see Chapter 3, "Provisioning the Cisco HSI"):
•
•
•
•
•
•
Overload Level 3
Use the following configuration parameters for overload level 3 (see Chapter 3, "Provisioning the Cisco HSI"):
•
•
•
•
•
•
Setting Overload Data
The following MML commands set overload data:
set-overload:level1|level2|level3:cpu, lower=number, upper=number
set-overload:level1|level2|level3:calls, lower=number, upper=number
set-overload:level1|level2|level3:gap, filter=normal|all, percent=number
The upper parameter specifies the threshold for overload detection, and the lower parameter specifies the hysteresis point at which the overload condition is removed.
The lower value should be greater than the upper value of the next lower severity level.
For example:
set-overload:level1:cpu, lower=45, upper=50
set-overload:level1:gap, filter=normal, percent=50
set-overload:level2:cpu, lower=63, upper=70
set-overload:level2:gap, filter=normal, percent=75
set-overload:level3:cpu, lower=81, upper=90
set-overload:level3:gap, filter=normal, percent=95
These values mean that:
•
•
•
•
•
Note
Refer to the Cisco Media Gateway Controller Software Release 9 Provisioning Guide for further information.
Retrieving Overload Data
Use the rtrv-overload MML command to display the overload status and related overload data. For information about this command, see Appendix A, "MML User Interface and Command Reference."
Logging
To set the logging level of one or more service packages, use the set-log MML command. For more information about this command, see Appendix A, "MML User Interface and Command Reference."
Rotating Log Files
Log files are rotated at system startup or when either of the following conditions occurs:
•
•
Convention for Naming the Log File
Log rotation occurs when the system ceases to write to the current log file and commences to write to a new log file. The LOGFILENAMEPREFIX parameter defines the name of the active log file (see Chapter 3, "Provisioning the Cisco HSI"). The default is platform.log.
When log rotation is triggered, the existing file (for example, platform.log) is renamed with the format platform_yyyymmddhhmmss.log (see Table 4-4). For example, a platform error file rotated on September 30, 1999 at 12:36:24 is renamed platform_19990930123624.
Table 4-4 Log Filename Format
LOGFILENAMEPREFIX
Provisioned filename (default is platform.log)
yyyy
Year
mm
Month
dd
Day
hh
Hour
mm
Minute
ss
Second
Note
Log File Location
The LOGDIRECTORY parameter defines the directory for active log files and rotated log files (see Chapter 3, "Provisioning the Cisco HSI"). The default is $GWHOME/var/log/.
Log Messages
Log messages have the following format:
Date and timestamp, Package Name, <log level>, LogID:<text of the message>.
The following are examples of log messages:
Thu Dec 7 03:55:32:837 2000, Infrastructure, <DEBUG>, 205: GWModule Registration - shutdownList() - NbOfItems 10 - Item 8Thu Dec 7 03:55:32:837 2000, Infrastructure, <DEBUG>, 206 : GWModuleRegistration - shutdownList() - NbOfItems 10 - Item 9Thu Dec 7 03:55:32:838 2000, Infrastructure, <DEBUG>, 207 : GWReactor::thdId() returns 6.Thu Dec 7 03:55:32:838 2000, Infrastructure, <DEBUG>, 208 : GWReactorModule::shutdown() - Thread has joined.Service Packages That Log Messages
The following service packages can log messages:
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
Logging Levels
Logging levels determine how much debug information is stored in the platform.log file for each package. Levels are set through use of a hexadecimal number between 0x0000 and 0xFFFF. 0x0000 is the lowest level and switches off logging for a particular package. 0xFFFF is the highest logging level.
Note
Setting Logging Levels
The set-log MML command dynamically alters the log level setting while the system is running. However, the set-log MML command does not affect the logging level of any current MML processes. For more information about the set-log command, see Appendix A, "MML User Interface and Command Reference."
Note
RADVision Logging
The Cisco HSI application provides the capability (through MML) to initiate RADVision logging. The contents of the resultant log file are not under the control of the Cisco HSI application.
Use the radlog MML command to start and stop RADVision logging. RADVision logging can be directed to a file or into the standard logging output. For information about this command, see Appendix A, "MML User Interface and Command Reference."
Gapping
The gapping level can be set from 0 to 100 percent. From 0 to 99 percent, the call type (normal or priority) is checked against the gapping level call status type. At 100 percent gapping, all calls are gapped, regardless of call type.
Setting Gapping
To activate call gapping, complete the following steps:
Step 1
•
•
•
Step 2
•
•
Step 3
Step 4
set-gapping:both:calltype=all,percent=60
Retrieving Call Gapping Data
To retrieve the current levels of call gapping for all gapping clients, enter the rtrv-gapping command. The command displays text similar to the following:
The output shows the gapping levels set by the overload function and the MML command set-gapping. The highest gapping level is used as the level to gap calls, which is indicated as Yes in the column titled Active. In this example, the MML levels for outgoing and incoming calls are active.
