HMR Import-Export

Due to the complexity of SIP manipulations rules and the deep understanding of system syntax they require, it is often difficult to configure reliable rules. This feature provides support for importing and exporting pieces of SIP manipulation configuration in a reliable way so that they can be reused.

Exporting

The SIP manipulation configuration contains an export command which sends the previously selected configuration to the designated file. The syntax is export [FILENAME]. The system compresses the file with gzip and writes it to the /code/imports directory.

Note:

SIP manipulation configurations can only be exported one at a time.

Exported data will look like this:

<?xml version='1.0' standalone='yes'?>
<sipManipulation
        name='manip'
        description=''
        lastModifiedBy='admin@console'
        lastModifiedDate='2009-10-16 14:16:29'>
        <headerRule
                headerName='Foo'
                msgType='any'
                name='headerRule'
                action='manipulate'
                cmpType='boolean'
                matchValue='$REGEX("[bB][A-Za-z]{2}")'
                newValue='foo'
                methods='INVITE'>
        </headerRule>
</sipManipulation>

To avoid conflicts when importing, the key and object ID are not included as part of the exported XML.

Importing

The import command imports data from a previously exported file into the currently-selected configuration. If no configuration was selected, a new one is created. The syntax is import [FILENAME]. Include the .gz extension in the filename. After importing, type done to save the configuration.

Importing a configuration with the same key as one that already exists returns an error. In this case:
  • Delete the object with the same key and re-import.
  • Select the object with the same key and perform an import that will overwrite it with new data.

Using SFTP to Move Files

After exporting a configuration, use SFTP to copy the file to other Oracle Communications Session Border Controllers. Place the file in the /code/imports directory before using the import command on the second OCSBC.

Removing Files

Using the delete-import command with the name of the file you want to delete removes it from the system. Using this command, you can delete files that are no longer useful to you. Carrying out this command is final and there is no warning before you go ahead with the deletion. A failed deletion (for instance, because there is no such file) will produce an error message; a successful deletion simply returns you to the system prompt.