Cisco PGW 2200 Softswitch Release 9.8 Operations, Maintenance, and Troubleshooting Guide
Configuring Cisco PGW 2200 Softswitch Log Files
Downloads: This chapterpdf (PDF - 163.0KB) The complete bookPDF (PDF - 6.01MB) | Feedback

Configuring Cisco PGW 2200 Softswitch Log Files

Table Of Contents

Configuring Cisco PGW 2200 Softswitch Log Files

Understanding Logging Files

Configuring the Data Dumper

Configuring the Data Dumper to Support BAMS

Understanding the Format of Log Files Archived Using Data Dumper


Configuring Cisco PGW 2200 Softswitch Log Files


Revised: March 7, 2011, OL-0800-14

This appendix describes the Cisco PGW 2200 Softswitch log files and the associated procedures for setting up the data dumper. The data dumper controls how files are processed for three of the log-file types. The logs records statistical information about the calls that the system processed. The logs also record network events, such as delays or service-affecting conditions.

Understanding Logging Files

A log message consists of several fields. See Cisco PGW 2200 Softswitch Release 9 Messages Reference for detailed information on specific fields and valid values in log files.

Table A-1 lists the log file types for the Cisco PGW 2200 Softswitch software. The Cisco PGW 2200 Softswitch creates these log files and stores them in the $BASEDIR/var/log directory, unless otherwise noted.

Table A-1 Log File Types

Log File Type
Active Name
Archived Name
Description

System

platform.log

platform_yyyymmddhhmmss.log

Contains log messages of varying severity that the system generates.

Command

mml.log

MML_yyyymmddhhmmss.log

Man-Machine Language (MML) command category log messages.

Alarms

alm.csv

alm_yyyymmddhhmmss_seq#.csv

Alarm category log messages. Archived files are stored in the $BASEDIR/var/spool directory.

Measurements

meas.csv

meas_yyyymmddhhmmss_seq#.csv

Measurement category log messages. Archived files are stored in the $BASEDIR/var/spool directory.

Call Detail Records (CDRs)

cdr.bin

cdr_yyyymmddhhmmss_seq#.bin

CDRs rotated on a regular basis. Archived files are stored in the $BASEDIR/var/spool directory.



Note The time stamps that are added to the archived filenames (yyyymmddhhmmss) are in system time.


Configuring the Data Dumper

The Cisco PGW 2200 Softswitch software contains a function that is called the data dumper. The data dumper controls the destinations for active and archived log files for CDRs, measurements, and alarms. It also controls when the active files are archived. The data dumper runs automatically and works correctly with a default configuration. However, you can customize the dumper settings by editing the dmprSink.dat file. Here is an example of the contents of the dmprSink.dat file:

"callDetail" bin "cdr" "../var/log" "../var/spool" 1000 0 15
"measReport" csv "meas" "../var/log" "../var/spool" 500 0 15
"almState" csv "alm" "../var/log" "../var/spool" 500 0 15

The contents of the dmprSink.dat file displays the log file setup data for each of these three log-file types. There are eight fields for each log file type in the file. You can modify the last three fields in each line to manage the creation of these three log-file types.


Caution Do not modify any of the first five fields in each line.

The first field in each line identifies the log file type, such as callDetail for the CDR log files. The second field in each line identifies the storage format that is used in the log file. The storage format is either bin for binary, or csv for comma-separated-value. The third field identifies the filename that is used to identify the file type, such as meas for system measurements. The fourth field identifies the directory in which the active log file is stored. The fifth field identifies the directory in which the archived log files are stored.

Table A-2 describes the last three fields in each line, which you can modify, depending on your needs.


Note You must set at least one of the last three fields in each line to a value other than zero (0) to enable logging to function properly.


Table A-2 Dumper Sink Log File Parameters 

Field Number
Default Value
Description

6

1000

Defines the maximum number of records a file can contain before it is flushed or moved to the spool directory. If this value is set to 0, the number of records is unlimited. You can improve system performance by increasing the value of this field to a larger value, such as 50000. The larger value causes the generation of fewer log files during periods of high call volume.

Note For CDRs, the value in this field refers to the maximum number of call detail blocks (CDBs), which make up CDRs. The system can create multiple CDBs for each call. For more information on individual CDBs, see Cisco PGW 2200 Softswitch Release 9 Billing Interface Guide.

7

0

Defines the maximum size of the log file in bytes before it is moved to the spool directory. If this value is set to 0, the available disk space is the only factor that limits the size of the file.

8

15

Defines the maximum time, in minutes, the file is allowed to remain open, before it is flushed or moved to the spool directory. If there is no data in the file, it is not flushed when the time limit expires. If you set this value to 0, there is no time limit.



Note Starting with Release 9.3(2), empty alarm log files are no longer archived, and CDR log files are not archived to the standby Cisco PGW 2200 Softswitch. In prior releases, empty alarm log files and CDR log files would be archived on both Cisco PGW 2200 Softswitches.


To configure the dmprSink.dat file fields, use this procedure:


Step 1 Log in to the active Cisco PGW 2200 Softswitch and change to the /opt/CiscoMGC/etc directory by entering the following UNIX command:

cd /opt/CiscoMGC/etc

Step 2 Use a text editor, such as vi, to open and edit the dmprSink.dat file fields that you want to change.


Note If you intend to use the BAMS to collect CDRs, proceed to the "Configuring the Data Dumper to Support BAMS" section, for information on how to configure the data dumper to support BAMS.


Step 3 Save your changes and exit the text editor.

Step 4 Change to the /opt/CiscoMGC/etc/active_link directory by entering the following UNIX command:

cd /opt/CiscoMGC/etc/active_link/

Step 5 Repeat steps 2 and 3 for the version of dmprSink.dat stored in this directory.

Step 6 If your system uses a continuous service configuration (including an active and standby Cisco PGW 2200 Softswitch), perform Step 9, Step 10, and Step 11 to update the settings on the standby Cisco PGW 2200 Softswitch and to load the new dmprSink.dat settings.

If your system uses a simplex configuration (a single Cisco PGW 2200 Softswitch), perform steps 7 and 8 to load the new dmprSink.dat settings.

Step 7 Stop the Cisco PGW 2200 Softswitch software by using the procedure that is described in the "Shutting Down the Cisco PGW 2200 Softswitch Software Manually" section on page 2-4.


Caution Stop the Cisco PGW 2200 Softswitch software only while in contact with Cisco Technical Assistance Center (TAC) personnel. See the "Obtaining Documentation and Submitting a Service Request" section on page xviii for information on contacting the Cisco TAC.

Step 8 Restart the Cisco PGW 2200 Softswitch software by using the procedure that is described in the "Starting the Cisco PGW 2200 Softswitch Software" section on page 2-2. The procedure is complete.

Step 9 Repeat Step 1 through Step 5 on your standby Cisco PGW 2200 Softswitch.

Step 10 Log on to the active Cisco PGW 2200 Softswitch, start an MML session and perform a manual switchover as described in the "Performing a Manual Switchover" section on page 3-96.


Warning Switchover operations cause the loss of all SS7 messages that are transmitted to the Cisco PGW 2200 Softswitch for approximately 3 seconds. This switchover affects in-progress as well as new calls.


Step 11 Once the manual switchover is complete, repeat Step 10 on the newly active Cisco PGW 2200 Softswitch. The procedure is complete.


Configuring the Data Dumper to Support BAMS

If you intend to use the Billing and Measurements Server (BAMS) to retrieve CDRs from the Cisco PGW 2200 Softswitch, perform the following procedure to configure the data dumper to support the BAMS:


Step 1 Log into the active Cisco PGW 2200 Softswitch and change to the /opt/CiscoMGC/etc directory by entering the following UNIX command:

cd /opt/CiscoMGC/etc

Step 2 Use a text editor, such as vi, to open the dmprSink.dat file.

Step 3 In the callDetail line of the file, find the following directory path:

"../var/spool"

Step 4 Modify that directory path to point to the /opt/CiscoMGC/var/bam directory, as shown by the following directory path:

"../var/bam"

Step 5 Save your changes and exit the text editor.

Step 6 Change to the /opt/CiscoMGC/etc/active_link directory by entering the following UNIX command:

cd /opt/CiscoMGC/etc/active_link/

Step 7 Repeat Step 2 through Step 5 for the version of dmprSink.dat stored in this directory.

Step 8 If your system uses a continuous service configuration (including an active and standby Cisco PGW 2200 Softswitch), perform Step 11, Step 12, and Step 13 to update the settings on the standby Cisco PGW 2200 Softswitch and to load the new dmprSink.dat settings.

If your system uses a simplex configuration (a single Cisco PGW 2200 Softswitch), perform Step 9 and Step 10 to load the new dmprSink.dat settings.

Step 9 Stop the Cisco PGW 2200 Softswitch software by using the procedure that is described in the "Shutting Down the Cisco PGW 2200 Softswitch Software Manually" section on page 2-4.


Caution Stop the Cisco PGW 2200 Softswitch software only while in contact with Cisco Technical Assistance Center (TAC) personnel. See the "Obtaining Documentation and Submitting a Service Request" section on page xviii for information on contacting the Cisco TAC.

Step 10 Restart the Cisco PGW 2200 Softswitch software using the procedure that is described in the "Starting the Cisco PGW 2200 Softswitch Software" section on page 2-2. The procedure is complete.

Step 11 Repeat Step 1 through Step 7 on your standby Cisco PGW 2200 Softswitch.

Step 12 Log on to the active Cisco PGW 2200 Softswitch, start an MML session and perform a manual switchover as described in the "Performing a Manual Switchover" section on page 3-96.


Caution Switchover operations cause the loss of all SS7 messages that are transmitted to the Cisco PGW 2200 Softswitch for approximately three seconds. This switchover affects in-progress as well as new calls.

Step 13 Once the manual switchover is complete, repeat Step 10 on the newly active Cisco PGW 2200 Softswitch. The procedure is complete.


Understanding the Format of Log Files Archived Using Data Dumper

Three log-file types are archived in the $BASEDIR/var/spool directory using the data dumper: alarms, measurements, and CDRs. The archive files for alarms and measurements are stored as ASCII text files. This section describes the format of these files. CDRs are stored as binary files and are not discussed here. For a description of the elements of CDR files, see
Cisco PGW 2200 Softswitch Release 9 Billing Interface Guide.

The following sample shows the content of an archived alarm file:

0,1012522984,761,1,0,"Failover daemon in INIT state","FOD-01","unknown"
0,1012522989,880,1,0,"Failover daemon in SLAVE state","FOD-01","unknown"
0,1012522991,893,1,1,"Warm Start Initiated","IOCM-01","IosChanMgr"
0,1012522992,932,0,0,"Excessive bit error ratio detected from frame alignment 
signal","enif1","IosChanMgr"
0,1012522992,936,0,0,"Excessive bit error ratio detected from frame alignment 
signal","enif2","IosChanMgr"
0,1012522992,939,0,0,"Reset Config Failed","dpc1","IosChanMgr"
0,1012522992,939,1,2,"Point Code Unavailable","dpc1","IosChanMgr"
0,1012522992,958,0,0,"Reset Config Failed","dpc2","IosChanMgr"
0,1012522992,958,1,2,"Point Code Unavailable","dpc2","IosChanMgr"
0,1012522992,975,0,0,"Reset Config Failed","dpc-11","IosChanMgr"
0,1012522992,975,1,2,"Point Code Unavailable","dpc-11","IosChanMgr"
0,1012522993,37,0,0,"Reset Config Failed","dpc-12","IosChanMgr"
0,1012522993,38,1,2,"Point Code Unavailable","dpc-12","IosChanMgr"
0,1012522993,83,0,0,"Reset Config Failed","dpc-13","IosChanMgr"
0,1012522993,83,1,2,"Point Code Unavailable","dpc-13","IosChanMgr"
0,1012522993,99,0,0,"Reset Config Failed","dpc-14","IosChanMgr"
0,1012522993,123,1,2,"Point Code Unavailable","dpc-14","IosChanMgr"
0,1012522993,139,0,0,"Reset Config Failed","dpc-15","IosChanMgr"
0,1012522993,139,1,2,"Point Code Unavailable","dpc-15","IosChanMgr"
0,1012522993,155,0,0,"Reset Config Failed","dpc-16","IosChanMgr"
0,1012522993,156,1,2,"Point Code Unavailable","dpc-16","IosChanMgr"

A comma separates each field. Table A-3 describes the content of each field.

Table A-3 Archived Alarm File Fields 

Field Name
Data Type
Maximum Length
Comments

Release level

Integer

3

Format of records (should be set to 0).

Timestamp (seconds)

Integer

10

Indicates the time, in seconds, since the start of the UNIX internal timer, time of epoch.

Timestamp (milliseconds)

Integer

5

Indicates the time, in milliseconds, since the start of the UNIX internal timer, time of epoch.

State

Integer

1

Used for informational alarms, either 0 for reset or 1 for set.

Severity

Integer

1

Indicates the severity of the alarm. There are four severity levels:

0—Informational

1—Minor

2—Major

3—Critical

Alarm category

String

80

Text that describes the nature of the alarm. For a list and description of the available alarms, see
Cisco PGW 2200 Softswitch Release 9 Messages Reference.

Component name

String

32

Identifies the component that is associated with the alarm. For more information on components, see
Cisco PGW 2200 Softswitch Release 9.8 Provisioning Guide.

Originator

String

32

Identifies the service that set or cleared this alarm.


The following sample shows the content of an archived measurement file:

0,1012013100,900,0,"messages","SP: cInit out","ss7svc11"
0,1012013100,900,0,"occurrances","ACC: CALL REJ","hcss3-118"
0,1012013100,900,0,"occurrances","ACC: CALL REJ","hcss3-119"
0,1012013100,900,0,"messages","SP: cInit out","ss7svc5"
0,1012013100,900,0,"messages","SP: cInit out","ss7svc8"
0,1012013100,900,0,"messages","SP: cInit out","ss7svc9"
0,1012013100,900,0,"messages","SP: cInit out","ss7svc10"
0,1012013100,900,0,"occurrances","ACC: CALL REJ","hcss4-2"
0,1012013100,900,0,"occurrances","ACC: CALL REJ","tg-4166"
0,1012013100,900,0,"occurrances","ACC: CALL REJ","hcss4-3"
0,1012013100,900,0,"occurrances","ACC: CALL REJ","tg-4165"
0,1012013100,900,0,"occurrances","ACC: CALL REJ","hcss4-4"
0,1012013100,900,0,"occurrances","ACC: CALL REJ","hcss4-5"
0,1012013100,900,0,"occurrances","ACC: CALL REJ","tg-4164"
0,1012013100,900,0,"occurrances","ACC: CALL REJ","tg-4162"
0,1012013100,900,0,"occurrances","ACC: CALL REJ","hcss4-6"
0,1012013100,900,0,"occurrances","ACC: CALL REJ","tg-4163"
0,1012013100,900,0,"occurrances","ACC: CALL REJ","hcss4-7"
0,1012013100,900,0,"occurrances","ACC: CALL REJ","hcss4-8"
0,1012013100,900,0,"occurrances","ACC: CALL REJ","hcss4-9"
0,1012013100,900,0,"occurrances","ACC: CALL REJ","hcss4-10"
0,1012013100,900,0,"occurrances","ACC: CALL REJ","hcss4-11"
0,1012013100,300,0,"occurrances","ISUP: CHAN MATE UNAVAILABLE","ss7svc4"

A comma separates each field. Table A-4 describes the content of each field.

Table A-4 Archived Measurement File Fields 

Field Name
Data Type
Maximum Length
Comments

Release level

Integer

3

Format of records (should be set to 0).

Timestamp (seconds)

Integer

10

Indicates the time, in seconds, since the start of the UNIX internal timer, time of epoch.

Time interval (seconds)

Integer

5

Duration of the collection interval.

Measurement value

Integer

10

Value of the measurement.

Measurement units

String

32

The type of measurement unit that is recorded.

Measurement category

String

32

Text that describes the nature of the measurement. For a list and description of the available measurement, see Appendix D, "Cisco PGW 2200 Softswitch Measurements."

Component name

String

32

Identifies the component that is associated with the alarm. For more information on components, see
Cisco PGW 2200 Softswitch Release 9.8 Provisioning Guide.