Storing SDRs Locally on the Device

You can enable the device to store generated SDRs locally on the device (hard disk of server platform).

The SDR files are stored in the /sdr folder. New SDRs are stored in a file called "Current". Once this file meets a user-defined criteria—either the maximum file size or the rotation period (whichever first occurs)—a file is created of all the SDRs and saved in a comma-separated values file (*.csv), where each SDR is on a dedicated line, as shown in the example below:

If configured, the file is compressed into a ZIP or GZIP file. To view the SDR's field titles (names), use the CLI command sdr-format show-title.

Each SDR file is assigned a unique sequence number, which by default, is appended at the end of the filename. You can configure the filename using format specifiers, as listed in the following table. For example, if a file is created on 25 August 2020 at 14:20:02 and the default format is used ("SDR_%y.%m.%d-%H.%M.%S_%qqqqq.csv"), the filename will be SDR_20.08.25-14.20.02_00010.csv. Whenever you modify the file format, the new format is applied to all existing files (not only future files).

SDR Filename Format Specifiers

Specifier

Replaced by

Example

%a

Abbreviated weekday name

Thu

%A

Full weekday name

Thursday

%b

Abbreviated month name

Aug

%B

Full month name

August

%c

Date and time

Thu Aug 23 14:55:02 2020

%C

Year divided by 100 and truncated to integer (00-99)

20

%d

Day of the month (01-31)

23

%D

Short MM/DD/YY date, equivalent to %m/%d/%y

08/23/20

%e

Day of the month (1-31)

23

%F

Short YYYY-MM-DD date, equivalent to %Y-%m-%d

2020-08-23

%g

Week-based year, last two digits (00-99)

01

%G

Week-based year

2001

%h

Abbreviated month name (same as %b)

Aug

%H

Hour in 24h format (00-23)

14

%I

Hour in 12h format (01-12)

02

%j

Day of the year (001-366)

235

%m

Month as a decimal number (01-12)

08

%M

Minute (00-59)

55

%n

New-line character ('\n')

 

%p

AM or PM designation

PM

%q

The sequence number, where each q represents a digit. The number of digits ('q's) should accommodate the configured maximum number of files.

%qqqqq is 00023

%r

12-hour clock time

02:55:02 pm

%R

24-hour HH:MM time, equivalent to %H:%M

14:55

%S

Seconds (00-61)

02

%t

Horizontal-tab character ('\t')

 

%T

ISO 8601 time format (HH:MM:SS), equivalent to %H:%M:%S

14:55:02

%u

ISO 8601 weekday as number with Monday as 1 (1-7)

4

%U

Week number with the first Sunday as the first day of week one (00-53)

33

%V

ISO 8601 week number (01-53)

34

%w

Weekday as a decimal number with Sunday as 0 (0-6)

4

%W

Week number with the first Monday as the first day of week one (00-53)

34

%x

Date

08/23/20

%X

Time*

14:55:02

%y

Year, short representation using last two digits (00-99)

20

%Y

Year, full representation

2020

%z

ISO 8601 offset from UTC in timezone (1 minute=1, 1 hour=100)

If timezone cannot be determined, no characters are shown

+100

%Z

Timezone name or abbreviation *

If timezone cannot be determined, no characters are shown

CDT

%%

A % sign

%

%<hostname>

Device's hostname ( configured in Configuring a Hostname for the Device)

MyHostDR_.062121-11.21.26_00000.csv.zip

The device's SDR file storage capacity depends on various user-defined settings:

■ Maximum number of stored files
■ Maximum file size
■ Interval (rotation period) after which a file is created for the SDRs in the Current file
■ File compression
● When the device operates in High-Availability (HA) mode, active and redundant devices maintain their own stored SDRs. In other words, upon an HA switchover, the stored SDRs on the active device are not copied to the redundant device (which becomes the new active device). However, you can view the stored SDRs on the redundant device without performing a switchover, by accessing the redundant device from the active device through SSH (or SFTP), as described in Accessing Files on Redundant Device from Active through SSH.
● To customize the SDR fields for local storage, see Customizing SDR Fields.
● To send locally stored SDR files to a remote server, see Sending Locally Stored SDR Files to Remote Server.
● To download locally stored SDRs through SFTP, see Downloading Locally Stored SDRs through SFTP.
● To delete locally stored SDR files, see Deleting Locally Stored CDRs and SDRs.
➢ To store SDRs locally on device:
1. Open the Session Detail Record Settings page (Troubleshoot menu > Troubleshoot tab > Session Detail Record folder > Session Detail Record Settings), and then scroll down to the SDR Local Storage group:

2. Select the 'Local Storage' check box to enable local storage of SDRs.
3. In the 'File Size' field [SDRLocalMaxFileSize], enter the maximum size (in kilobytes) of the SDR file. When the Current file reaches this size, the device creates an SDR file. However, if the 'Rotation Period' is reached before the file has reached this maximum size, the file is created.
4. In the 'Number of Files' field [SDRLocalMaxNumOfFiles], enter the maximum number of SDR files that can be locally stored. If this maximum is reached, any new file replaces the oldest file (i.e., FIFO).
5. In the 'File Name' field [SDRLocalFileName], configure the filename using the format specifiers (as discussed earlier in this section).

 

 

new row

 

new row

 

This is merged row

New row

 
6. In the 'Rotation Period' field [SDRLocalInterval], configure the periodic duration (in minutes) of how often an SDR file is created from the Current file (even if empty). For example, if configured to 60, a file is created every hour (or before, if the maximum file size has been reached).
7. From the 'Compression Format' drop-down list [SDRLocalCompression], select the file compression type.
8. Click Apply.