Maintenance and Troubleshooting

show spl

Typing show spl displays the following items:

  • The version of the SPL engine
  • The filenames and version of the SPL plugins currently loaded on the Oracle Communications Session Border Controller
  • The signature state of each plugin
  • The system tasks that each loaded plugin interacts with, enclosed in brackets.

For example:

ORACLE# show spl 
SPL Version: C1.0.0
[acliConsole] File: signed_valid_lower_version.spl version: 1 signature: signed and valid
[acliConsole] File: signed_valid.spl version: 1 signature: signed and valid
[sipd] File: signed_valid_lower_version.spl version: 1 signature: signed and valid
[sipd] File: signed_valid.spl version: 1 signature: signed and valid

Adding the task to the end of the show spl command displays only the plugin information for the specified task. For example:

ORACLE# show spl sipd
SPL Version: C1.0.0
[sipd] File: signed_valid_lower_version.spl version: 1 signature: signed and valid
[sipd] File: signed_valid.spl version: 1 signature: signed and valid

show running-config spl-config

The ACLI show running-config spl-config displays SPL specific configuration information on the system.

ACMEPACKET# show running-config spl-config
spl-config
        spl-options
        plugins
                name                           LyncEmergencyCall.1.0.spl
        last-modified-by               admin@216.41.24.2
        last-modified-date             2012-10-12 15:31:05

show spl-options

The ACLI show spl-options command displays SPL-specific options registered by an SPL.

ACMEPACKET# show spl-options
   1. return_183_initial_invite: Returns a 183 provisional response when a
emergency call is placed through Lync [LyncEmergencyCall.1.0.spl,config]

show directory code spl

The ACLI show /code/spl command displays the SPLs stored in the /code/spl directory.

ACMEPACKET# show directory /code/spl
Listing Directory /code/spl:
drwxrwxrwx  1 0       0                 4096 Aug 13 10:07 ./
drwxrwxrwx  1 0       0                 4096 Aug 19 22:25 ../
-rwxrwxrwx  1 0       0                 3163 Aug 13 10:07 LyncEmergencyCall.1.0.spl

SPL Signature State

Upon executing show spl <task> , the ACLI displays SPL file information including the signature which will be in one of three states:

  1. not signed
  2. signed and valid
  3. signed but invalid

SPL Log Types

SPL log messages can often be found in the log file for the system task to which the SPL applies when that task is set to DEBUG level. You can find the output specific to SPL by the identifying prefix [SPL].

Aug 30 15:06:07.454 [SPC] Executing SPL callback from file: SipHeaderExtensionMetadata.1.2.spl
Aug 30 15:06:07.454 [SPL] Checking for LRE-Identifier to match triggered session-recording-server
Aug 30 15:06:07.454 [SPC] Creating table of name 'AcmeSipServerTransDataTable' with key [0x34522878]
Aug 30 15:06:07.454 [SPC] Creating new temporary session table of key [_SESSION_0x34522878]
Aug 30 15:06:07.454 [SPL] SIP Interface ingressSIP has option
Aug 30 15:06:07.454 [SPL] Storing data from message to insert into metadata

Delete SPL Plugin Files

Deleting files from /code/spl must be performed via SFTP.