Important: The commands or keywords/variables that are available are dependent on platform type, product version, and installed license(s).
cdr [ push-interval value ] [ push-trigger space-usage-percent trigger_percentage ] [ remove-file-after-transfer ] [ transfer-mode { pull | push primary { encrypted-url enc_url | url url } [ via local-context ] [ secondary { encrypted-secondary-url enc_sec_url | url sec_url } ] } ] + | use-harddisk ]default cdr [ push-interval | push-trigger space-usage-percent | remove-file-after-transfer | transfer-mode [ push via ] | use-harddisk ] +
• remove-file-after-transfer: Retains a copy of the file even after it has been pushed or pulled to another server.
• use-harddisk: Disables data storage on the SMC harddisk.
• push-interval: 300 seconds
• push-trigger: 80 percent
• remove-file-after-transfer: Disabled
• transfer mode: Pull
• push via: LC is used for push
• use-harddisk: Disabledpush-interval valuevalue must be an integer from 60 through 3600.push-trigger space-usage-percent trigger_percentagetrigger_percentage specifies the EDR/UDR disk utilization percentage for triggering push, and must be an integer from 10 through 80.transfer-mode { pull | push primary { encrypted-url enc_url | url url } [ via local-context ] [ secondary { encrypted-secondary-url enc_sec_url | secondary-url sec_url } ] }
• pull: Specifies that the L-ESS is to pull the CDR files.
• push: Specifies that the system is to push CDR files to the configured L-ESS.
• primary encrypted-url enc_url: Specifies the primary URL location in encrypted format to which the system pushes the CDR files. enc_url must be the location name in an encrypted format, and must be an alpha and/or numeric string of 1 through 1024 characters in length.
• primary url url: Specifies the primary URL location to which the system pushes the CDR files. url must be an alpha and/or numeric string of 1 through 1024 characters in the //user:password@host:[port]/directory format.
• via local-context: Configuration to select LC/SPIO for transfer of CDRs. The system pushes the UDR files via SPIO in the local context.
• encrypted-secondary-url enc_sec_url: Specifies the secondary URL location in encrypted format to which the system pushes the CDR files when the primary location is unreachable or fails. enc_sec_url must be the location name in an encrypted format, and must be an alpha and/or numeric string of 1 through 1024 characters in length.
• secondary-url sec_url: Specifies the secondary URL location to which the system pushes the CDR files when the primary location is unreachable or fails. sec_url must be an alpha and/or numeric string of 1 through 1024 characters in //user:password@host:[port]/directory format.The use-harddisk keyword is only available on the ASR 5000 system. This command can be run only in a context where CDRMOD is running. Configuring in any other context will result in failure with the message “Failure: Please Check if CDRMOD is running in this context or not.”When changing transfer-mode from pull to push, disable the PULL from L-ESS and then change the transfer mode to push. Make sure that the push server URL configured is accessible from the local context. Also, make sure that the base directory that is mentioned contains udr directory created within it.When changing transfer-mode from push to pull, after changing, enable PULL on the L-ESS. Any of the ongoing PUSH activity will continue till all the scheduled file transfers are completed. If there is no PUSH activity going on at the time of this configuration change, all the PUSH related configuration is nullified immediately.
• include: Sets this command to include the Charging service name in UDR file name.
• omit: Sets this command to exclude or omit the Charging service name from UDR file name.
• gzip: Enables GNU zip compression of the UDR file at approximately 10:1 ratio.
• none: Disables Gzip compression.current-prefix stringSpecifies a string to add to the beginning of the UDR file that is currently being used to store UDR records. string must be an alpha and/or numeric string of 1 through 31 characters in length.delete-timeout secondsSpecifies a time period, in seconds, when completed UDR files are deleted. By default, files are never deleted. seconds must be an integer from 3600 through 31536000.directory dir_nameSpecifies a subdirectory in the default directory in which to store UDR files. dir_name must be an alpha and/or numeric string of 1 through 191 characters in length.
• hyphen: specifies the field separator as ‘-’ (hyphen) symbol between two fields.
• omit: removes or omits the field separator between two fields.
• underscore: specifies the field separator as ‘_’ (underscore) symbol between two fields.name file_namefile_name must be an alpha and/or numeric string of 1 through 31 characters in length. The file name format is as follows:
• format: Specifies the name of the UDR format if single-udr-format is specified else the format field (and the trailing underscore) is omitted from the file name.File name for a closed xDR file in CSV format that contains information for ECS system xyz_city1 and charging service name preapaid2 with timestamp 12311969190000, and file sequence number counter reset indicator to 002 for file sequence number 034939002 appears as follows:File name for a running xDR file in CSV format that contains information for the same parameters for file sequence number 034939003 prefixed with curr_ and appears as follows:Defaults: num-records: 1024time: 3600 secondsvolume: 102400 bytesnum-records records: Specifies the number of records that should be added to the file. When the number of records in the file reaches the specified value, the file is complete. records must be an integer from 100 through 10240.time seconds: Specifies the period of time to wait before closing the UDR file and creating a new one. seconds must be an integer from 30 through 86400.volume bytes: Specifies the maximum size of the UDR file before closing it and creating a new one. bytes must be an integer from 51200 through 62914560. Note: Higher sets may provide the best compression ratio when the compression keyword is set to gzip.Default: padded
• length length: Includes the sequence number with the specified length. length must be the file sequence number length with preceding zeroes in the file name, and must be an integer from 1 through 9.Important: The length configuration is applicable in both EDR and UDR modules. When applied in both modules without the file udr-seq-num configuration, the minimum among the two values will come into effect for both the modules. With the file udr-seq-num config, each module will use its own value of length.
• omit: Excludes the sequence number from the file name.
• padded: Includes the padded sequence number with preceding zeros in the file name. This is the default setting.
• padded-six-length: Includes the padded sequence number with six preceding zeros in the file name.
• unpadded: Includes the unpadded sequence number in the file name.storage-limit limitOn ASR 5000 chassis, limit is an integer from 10485760 through 536870912.Important: On ASR 5000 chassis, the total storage limit is 536870912 bytes (512 MB). This limit is for both UDR and EDR files combined.
• expanded-format: Specifies the UTC MMDDYYYYHHMMSS format.
• rotated-format: Specifies the YYYYMMDDHHMMSS format.
• unix-format: Specifies the UNIX format of x.y, where x is the number of seconds since 1/1/1970 and y is the fractional portion of the current second that has elapsed.trailing-text stringstring must be an alpha and/or numeric string of 1 through 30 characters in length.Specifies inserting an xor checksum (in place of the CRC checksum) into the UDR file header if the exclude-checksum-record keyword is left at its default setting.file current-prefix currentfile name UDRfile
![]() |
Cisco Systems Inc. |
Tel: 408-526-4000 |
Fax: 408-527-0883 |