Enable an SPL Plug-in

You must enable the SBC Programming Language (SPL) plug-in before you configure an SPL option. The process to enable the SPL plug-in on the Oracle® Enterprise Session Border Controller (E-SBC) requires the following steps.
  1. Upload the SPL plug-in to the E-SBC.
  2. Add the SPL plug-in to the E-SBC configuration.
  3. Execute the SPL file.
  4. Synchronize the SPL files across HA pairs.
  5. Reset the SPL on standby nodes.
  6. Configure the SPL plug-in option.

1. Upload the SPL Plug-in to the E-SBC

Use any CLI or interface-based FTP or SFTP application to send the SPL plug-in to the E-SBC. You can use the wancom or eth0 management phy-interface to reach the FTP/SFTP server on the SBC.
  1. Upload the SPL plug-in to the /code/spl directory on the E-SBC.

2. Add the SPL Plug-in to the E-SBC Configuration

Confirm that you are in Superuser mode.

On the SBC, in the spl-configuration element, configure the SPL plug-in.
  1. Type configure terminal, and press <Enter>.
  2. Type system, and press <Enter>.
  3. Type spl-config, and press <Enter>.
  4. Type select, and press <Enter>.
  5. Type plugins, and press <Enter>.
  6. Type name, enter a space, and type the name of the SPL plug-in file.
  7. Type done.
  8. Type exit.
  9. Type done.

3. Execute the SPL File

Confirm that the SPL plug-in is configured on the E-SBC, and that you exited the configuration menu.

You must save and activate the configuration.
  1. Perform the save-config and activate-config operations on the E-SBC.

4. Synchronize the SPL Files Across HA Pairs

Confirm that you are in Superuser mode.

When running in an HA pair configuration, the active system and the standby system must both have the same version of the SPL plug-in installed. To facilitate configuring the standby system, you can execute the synchronize the spl ACLI command, without any arguments, to copy all of the files in the /code/spl directory from the active system to the same directory on the standby system. Note that any file on the standby system with the same name as a file on the active system is overwritten.

By adding the specific file name as an argument to the synchronize spl command, the individual, specified scripts are copied. For example:

ACMEPACKET# synchronize spl <name of the SPL plug-in file>

The synchronize spl command can only by executed from the active system in an HA pair. There is no means to synchronize spl files automatically during save and activate operations on the E-SBC.

  1. Type synchronize spl, and press <Enter>.

5. Reset the SPL on Standby HA Nodes

Confirm that you are in Superuser mode.

Execute the reset spl command on all standby nodes that receive the spl file by way of the synchronize command.

  1. Type reset spl, and press <Enter>.

6. Configure the SPL Plug-in Option

See the instructions for configuring the particular SPL plug-in option.