DO NOT SHARE THESE DOCS WITH CUSTOMERS!

This is an LA release that will only be provided to a select number of PLM-sanctioned customers (PDFs only). Contact PLM for details.


In this section:

Related articles:

Use the SIP Param Based Action profile window to work with SIP Param Based Action profiles. Use these profiles in in conjunction with SIP Message Manipulation (SMM) processing to enable secondary trunk group selection.  

By default, the SBC selects the ingress trunk group for an incoming SIP request based on its source IP address and port. However, using SMM, you can extract a value from the incoming message and use the value to select a new ingress trunk group. Secondary trunk group selection enables applying trunk group policies and profiles on a more granular basis in subsequent processing of the session.

The SIP Param Based Action profile maps values that might be extracted from incoming messages, using the SMM store SIP Param operation, to specific SIP trunk group names. If the extracted store SIP Param value matches an entry configured in a SIP Param Based Action profile specified with the SMM store Profile Name operation, the SBC selects the trunk group specified by the matching entry as the new ingress trunk group.

When you define entries within a SIP Param Based Action profile you specify the type of matching to perform. The options include: 

  • Full - entries include a list of one or more specific parameter values. The extracted value must match one of the entry's specified values exactly to be considered a match. For example, the list might consist of a set of host names.    
  • Range - entries define a starting value and an ending value in the entry. The extracted value must fall within the range to be considered a match. For example, the range might consist of numeric range for the username.
  • Regexp - entries are defined using a regular expression. The extracted value must match the regular expression to be considered a match.

If a match occurs, in all subsequent processing, the SBC considers the profiles and configurations called for by the new ingress trunk group. This includes CAC, SMM, Emergency profiles, and so on. If the extracted value does not match any of the entries in the profile, the SBC does not select a new ingress trunk group and continues using the original ingress trunk group.

Note

SMM rules can also be configured with the operation store a trunkgroup name to a variable to select a new ingress trunk group. If you configure rules using both types of operations:

  • The ingress trunk group selected using the store Profile Name operation takes precedence over one selected using the store a trunkgroup name to a variable operation.
  • If the store Profile Name operation does not find a new trunk group, the trunk group selected by the store a trunkgroup name to a variable operation becomes the new ingress trunk group.
  • If neither the store Profile Name operation nor the store a trunkgroup name to a variable operation selects a new trunk group, the SBC continues to use the original ingress trunk group as the ingress trunk group.

To View SIP Param Based Action Profiles

On the SBC main screen, go to All > Profiles > Signaling > SIP Param Based Action Profile

The  SIP Param Based Action profile window opens.

SIP Param Based Action Profile Window


To Create a SIP Param Based Action Profile 

To create a new SIP Param Based Action profile you name and specify an action for the profile from the SIP Param Based Action Profile page. Once the profile is created, create the parameter entries using the subordinate Entry and Param pages.

  1. Click New SIP Param Based Action Profile. The Create New SIP Param Based Action Profile window opens.

    Create New SIP Param Based Action Profile Window

  2. Enter the parameter values using the following table and then click Save.

    SIP Param Based Action Profile Parameters

    ParameterDescription

    Name

    Enter a name for the new SIP Param Based Action profile.

    Action

    Click to select the action to be performed by the SIP Param Based Action profile. Options are:

    • None (default)
    • select TG

  3. Go to the Entry window to add entries to the new profile.

To Edit a SIP Param Based Action Profile

To edit a SIP Param Based Action profile:

  1. Click the radio button next to the name of the entry you want to edit. The Edit Selected SIP Param Based Action Profile window opens.

  2. Change the variable value and click Save.

To Copy a SIP Param Based Action Profile

To copy a SIP Param Based Action profile: 

  1. Click the radio button next to the name of the entry you want to copy.

  2. Click Copy SIP Param Based Action Profile. The Copy Selected SIP Param Based Action Profile window opens.
  3. Make the required changes and click Save.

To Delete a SIP Param Based Action Profile

To delete a SIP Param Based Action profile:

  1. Click the radio button next to the name of the entry you want to delete.
  2. Click the delete icon (X) at the end of the row.
  3. Confirm the deletion when prompted.