File Management

You can manage system files from the Web GUI on the File Management page.

The following table describes the files that you can manage under File Management on the Oracle® Enterprise Session Border Controller (E-SBC).

File Type Format Description
Backup configuration .gz File that contains a backup of the E-SBC software configuration. You can apply this file to restore a previous configuration if required.
Local route table (LRT) .xml, .gz Local routing table (LRT) file that you can apply to theE-SBC. The LRT is an in-memory table that contains IP addresses that the local router recognizes. It calculates the destinations of messages it is responsible for forwarding.
Fraud protection table .gz, .gzip, .xml Lists fraud protection files that you can upload, download, delete, or open to modify.
Log Text

Log files that contain information about the various aspects of the E-SBC. For example, information logged about the ACLI, SIP, or H323.

Note: Only the Download and Delete functions are applicable to log files on the E-SBC.

Playback media Any media format valid in an RTP audio stream

Call progress playback files. The E-SBC can use these files in generated media streams if required.

Note: The media files are raw binary files that contain data for the codec that a user wants to have played in the media stream. The E-SBC plays the data on the first audio flow in the Session Description Protocol (SDP).

Software Image .gz, .bz These files are bootable images.
SPL Plug-in .lua Session Plug-in Language (SPL) file that you can apply to the E-SBC to incorporate additional functionality. The SPL file contains a programming language that is capable of performing various tasks by utilizing APIs and callbacks in the E-SBC.

The following table describes the file management buttons.

Button Description
Refresh Updates the screen to display the latest data.
Upload Uploads a file type from your server or PC to the E-SBC. The LRT, SPL, and backup configuration upload process provide the option of dynamically applying these files to the E-SBC.
Download Downloads the file type from the E-SBC to your local server or PC (typically to the download directory on your system). Note: Download All applies only to log files.
Backup Creates a file that contains a backup of the device software configuration. You can apply this file to restore a previous configuration.
Restore

(Applicable to the “Backup configuration” file type only.)

Restores and applies a Backup configuration file to the E-SBC.
Delete Deletes the file type from the E-SBC. Note: Delete All applies only to log files.

Manage Files

You can manage system files from the Web GUI on the File Management page.

Note:

You can activate an LRT file or an SPL file dynamically during an upload. You can also immediately apply a backup configuration file during the upload process.
  1. From the Web GUI, click System.
  2. On the System page, in the navigation pane, click File management.
  3. On the File management page, select a file to view from the File type drop-down list.
    The system displays the file.
  4. Use the controls on the tool bar to manage the file.

Group By Field

To customize the display of the File Management page on the System tab, you can group the elements by column head.

  1. From the Web GUI, click System.
  2. On the System page, under File management, select a file type from the drop-down list to group by field.
  3. On the File Management page, click the column title by which you want to group the items.
    The system displays an arrow control to the right of the column title.
  4. Click the arrow control, and click Group By This Field on the menu.
    The system displays the data by the selected group.

Upload a File

You can upload the following file types from your local server or PC to the Oracle® Enterprise Session Border Controller (E-SBC).

File Type File Format Directory
Backup Configuration .gz /code/bkups
Local route table (LRT) .xml, .gz /code/gzConfig
Fraud protection table .gz, .gzip, .xml /code/fpe
Playback media Any media format valid in an RTP audio stream /code/media
Software image .bz /code/images
SPL Plug-on (SPL) .lua /code/spl

The file extension must be applicable to the file type you select. For example, an SPL Plug-in file requires the .lua extension

You can dynamically activate the Local route table and SPL Plug-in during the upload process.

You can immediately restore a backup configuration file after an upload is complete.

Note:

You cannot upload log files.
  1. From the Web GUI, click System, File management.
  2. On the File management page, from the File type drop down list, select the type of file you want to upload.
  3. In the Name column, select the file you want to upload.
  4. Click Upload.
  5. In the Upload file dialog, do the following:
    1. Click Browse.
    2. Select the file that you want to upload.
    3. Optional. For the Backup configuration file, select Restore the configuration after upload to apply a previous backed up configuration file immediately to the after the upload is complete.
    4. Optional. For the Local route table file type, select Activate the LRT file after upload to apply the LRT upon upload.
    5. Optional. For a Fraud protection file, select Activate the file after upload to apply the file upon upload.
    6. Optional. For the SPL Plug-in file type, select Activate the SPL file after upload to apply the SPL file upon upload.
    7. Click Upload.

Download a File

Procedure and conditions for downloading from the Oracle® Enterprise Session Border Controller (E-SBC).

You can download any of the following file types from your local server or PC to the E-SBC:

  • Backup configuration
  • Local route table (LRT)
  • Fraud protection table
  • Log
  • Playback media
  • Software image
  • SPL Plug-in (SPL)
  1. From the Web GUI, click System, File management.
  2. On the File Management page, select the type of file you want to download from the File type drop down list.
  3. In the Name column, select the file you want to download.

    Note:

    For Log file types, you can select multiple log files to download, or place a checkmark in the box to the left of the Name column heading to select all log files to download. When downloading multiple log files, the File Management GUI compresses the files into one .tar file and downloads that file to your local server or PC.
  4. Click Download.
  5. Do one of the following:
    • Click Open with and select the application to open the file.
    • Click Save file to save the file to your local server or PC.
  6. Click OK.
    The system downloads the file to the folder on your local server or PC where your Browser sends all downloads (typically your “Download” folder) or opens (decompresses) the file type on your local server or PC (typically in the “Download” folder).

Delete a File

Procedure and conditions for deleting a file from the Oracle® Enterprise Session Border Controller (E-SBC).

You can delete any of the following file types from your local server, PC, and E-SBC:

  • Backup configuration Software image
  • Local route table (LRT)
  • Fraud protection table
  • Log
  • Playback media
  • Software image
  • SPL Plug-in (SPL)

Note:

You can select a single or multiple files to delete.
  1. On the System tab, in the File type drop down list, select the type of file that you want to delete.
  2. In the Name column, select one or more files you want to delete.

    Note:

    For Log file types, place a checkmark in the box to the left of the Name column heading to select all log files to delete.
  3. Click Delete. The system displays following message.
    Are you sure you want to delete the file?
  4. Click Yes.

Back up a File

You can backup a configuration file from the Oracle® Enterprise Session Border Controller (E-SBC) to your local server or PC. Backup allows you to save configurations that you can restore to the E-SBC at a later time.

  1. From the Web GUI, click System.
  2. In the Select the file type field, select Backup configuration.
  3. Select one or more configuration files to backup to your server or PC.
  4. Click Backup.
  5. Click OK to backup the configuration.
    The system downloads the file to your server or PC, typically into the download directory.

Restore a File

You can restore a backed up configuration file to the Oracle® Enterprise Session Border Controller (E-SBC).

  1. In the Select the file type field, select Backup configuration.
  2. Select a backup file to restore to the E-SBC.

    Note:

    Restore activates only when you select a backup file.
  3. Click Restore.
  4. Click Yes.
    The system downloads the backup file to the E-SBC. The E-SBC re-boots and restores the configuration from the backup file.