Use the following configuration to create, configure, or delete the Cell Trace module for real time cell traffic tracing in
a context.
-
cell-trace-module : Creates the module for real time cell traffic tracing.
Once the realtime trace module is configured, the real time trace file transfer parameters can be configured.
Entering the cell-trace-module command results in the following prompt and changes to the Cell Trace Module Configuration mode:
[context_name]host_name(config-cell-trace)#
-
no : Removes the real time trace module configuration for the current context.
-
cell-trace { purge { { storage-limitstorage_limit | time-limit time_limit } [ max-files max_files ] } : Specifies to purge or delete the cell trace records based on "time" or "volume" to restrict hard-disk space usage for cell
trace records.
storage-limit storage_limit : Specifies the storage space for the record files, in megabytes. storage_limit must be an integer from 10 to 143360.
time-limit time_limit : Specifies the time to delete record files, in seconds. time_limit must be an integer from 600 to 2592000.
max-files max_files : Specifies the maximum number of records to purge per iteration. max_files must be an integer 0 or ranging from 1000 to 10000. When value is set to 0, it deletes all records until purge limit is reached.
By default, no purge operation is performed by the VPNMGR module.
-
cell-trace push-interval interval : Specifies the transfer interval in seconds to push cell traffic trace files to an external file server. interval must be an integer from 1 to 30.
Default: 1 second
-
cell-trace push-trigger { space-usage-percent usage_precent } : Configures the disk utilization trigger for cell traffic trace files.
space-usage-percent usage_precent : Specifies the disk utilization percentage for triggering PUSH. usage_precent must be an integer from 10 to 80.
-
cell-trace remove-file-after-transfer : Deletes the files from RAMFS after transfer to an external server. If the cell-trace use-harddisk command is not configured, it is recommended to use this command.
-
cell-trace transfer-mode { pull [ module-only ] | push primary { encrypted-url enc_url | url url } [ module-only ] } : Configures the transfer mode for cell trace record files. Only one TCE address configuration is required and all files will
be sent to this address irrespective of the TCE address received from eNodeB in S1AP cell tracing message. Both the addresses
must be the same mostly.
pull [ module-only ] : Specifies that L-ESS pulls the cell trace files.
push primary { encrypted-url enc_url | url url } [ module-only ] : Specifies that ST pushes the cell trace files onto the configured L-ESS server. enc_url specifies the location where the cell trace files will be transferred and must be entered in encrypted format. url specifies the location where the cell trace files will be transferred and must be entered in the server URL format scheme://user:password@host:[port]/directory - string of size 1 to 1024.
If the module-only keyword is set, then the given configuration is applied only for the specific record type. The administrator can configure
record transfer information for all record types separately or combined using the module-only keyword.
-
cell-trace use-harddisk : Moves the cell trace files from RAMFS to /hd-raid/ and then transferred to an external server. It is recommended to use this command to prevent space on RAMFS becoming full.
-
If multiple modules are configured, then the cell-trace use-harddisk option must be configured in only one of the modules. All other modules (which do not have the use-harddisk option configured) will use the hard disk by default. The other modules will also inherit the PUSH parameters of the module
with use-harddisk option configured. If these modules need different PUSH parameters like url and push-interval as compared to the module with
use-harddisk option, then the module-only keyword must be configured.
For cell-trace-module, the minimum value of push-interval is 1 second. For all other modules, the minimum value of push-interval
is 30 seconds. Hence, to avoid undesired behavior:
-
If use-harddisk is configured for cell-trace-module, then module-only option must be configured while configuring the file transfer URL for all other modules.
For example:
configure
context context_name
cell-trace-module
cell-trace use-harddisk
cell-trace transfer-mode push primary url sftp://user:password@host:[port]/directory
cell-trace push-interval 1
end
configure
context context_name
udr-module active-charging-service
cdr transfer-mode push primary url sftp://user:password@host:[port]/directory module-only
cdr push-interval 30
end
The above configuration will ensure that push-interval = 1 second is not inherited from cell-trace-module and the correct
push-interval = 30 seconds is used for udr-module.
-
If use-harddisk option is configured for any other module except cell-trace-module, then module-only option must be configured while configuring the file transfer URL for cell-trace-module.
For example:
configure
context context_name
udr-module active-charging-service
cdr use-harddisk
cdr transfer-mode push primary url sftp://user:password@host:[port]/directory
cdr push-interval 30
end
configure
context context_name
cell-trace-module
cell-trace use-harddisk
cell-trace transfer-mode push primary url sftp://user:password@host:[port]/directory module-only
cell-trace push-interval 1
end
The above configuration will ensure that push-interval = 30 sec is not inherited from udr-module and the correct push-interval
= 1 sec is used for cell-trace-module.
-
file delete-timeout seconds : Configures the time to delete the completed cell traffic trace files after specified number of seconds. seconds must be an integer from 3600 through 31536000.
-
file directory directory_name : Specifies a subdirectory to be generated in the default directory /records/celltrace in which to store EDR files. directory_name must be an alphanumeric string of 1 through 191 characters.
-
file field-separator { hyphen | omit | underscore } : Specifies the field inclusion/exclusion type of separators between two fields of cell trace files.
-
hyphen : Specifies to use "-" (hyphen) as the field separator between file format fields.
-
omit : Excludes the field separator.
-
underscore : Specifies to use "_" (underscore) as the field separator between file format fields.
-
file rotation { num-records num_records | time rotation_time } : Specifies the criteria to rotate the record file. CDRMOD will hold the cell trace records in buffer and write them to the
XML file only when the criteria configured by this command are met.
num-records num_records : Completes the file when the specified number of records are added. When the number of records in the buffer reaches the
specified value, records will be written to the XML file. num_records must be an integer from 100 to 2000. Default: 1000.
time rotation_time : Completes the file based on file duration, time after which records will be written to XML file. num_records must be an integer from 1 to 30. Default: 1 second.
-
file storage-limit storage_limit : Configures the total available storage space on RAMFS for cell trace files. storage_limit must be an integer from 10485760 to 134217728. When the storage space is full, the oldest files on RAMFS will be deleted
first to create space for new files.
-
file trap-on-file-delete : Instructs the system to send an SNMP notification (starCDRFileRemoved) when a cell trace file is deleted due to lack of
space.
-
default : Configures the default value(s) for the cell trace paramters.
Feedback