Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents

Panel

In this section:

Section
Column
width40%
Panel
title
Table of Contents

Column
Info
titleAbout this Page
  • This document details the steps required to produce an effective SIP Message Manipulation.
Tip
titleRelated Articles

Prerequistes

Tip

Read the SIP Message Manipulation Overview
Requires Sonus SBC2000/1000 Version 2.2 or later
This document assumes the reader is familiar with the Transformation Table's Optional/Mandatory and User Value features.

maxLevel3

 

Steps to Creating an Effective SMM Translation

Step 1: Add a Condition Rule

If there are any conditions for the SMM Rule, add a Condition Rule.

...

Examples include:

    • Only on a particular phone number
    • Only a specific header (name)

  1. In the example below, the Called Number must be 'anonymous'. This condition will be applied later in the SIP Message Rule.
    Align
    aligncenter

    Image Removed
    Condition: When the Called Number is 'anonymous'

    Panel
  2. 1a: Add a Condition Rule
  3. 1b:

Select a Match Type Token value; this states the SIP Packet element (diversion number, IP address, etc.) for the match. Then, complete of the remainder which provides the value you desire to match.

Step 2: Select SIP Packets to be changed

Decide which type of SIP packets are to be changed (All Messages, All Requests, All Responses, Select Messages). The types of SIP packets to be changed is selected when the SMM Message Rule Table is created.

  1. Align
    aligncenter

    Image Removed
    Creating an SMM Rule Table

    Panel2a: Add a Add the SIP Message Rule Table.
  2. 2b: Select Configure which SIP Messages messages will be examined by this Rule Table.
  3. Configure whether the 2c: Will this SMM Table will be Mandatory or Optional within in the Signaling Group?What .

Step 3: Select SIP Packet element

...

  1. Click the name of the newly created SMM Table in the left-hand navigation tree, then add an SMM Rule entry.

  2. Which type of Rule? Use the diagram below!

    Align
    aligncenter

    Image Removed
    Image Removed
    Be sure to select the appropiate SMM Rule type!

    Panel3: Add one of the Rule Types:

    Select rule type: Header, Request, Status, or Raw

Step 4: Identify which rule section corresponds to the SIP element to be changed

  1. Add SIP Header Rule.
  2. For Header Value, configure the URI User. For example,

    you want to change.Example: If you wanted

    to change the FROM number to something other than anonymous


    (i.e, From

    :

    <sip:

    anonymous@10

    anonymous@10.1.1.74>;tag=254b0000).

    align


    Caption

    align

    0

    center

    Table

    Image Removed
    Use the references below if you're uncertain about which configuration to use

    Panel ExpandClick here to see the mapping between SIP packet elements and their corrsponding SMM configurationsClick here to see the mapping between SIP packet elements and their corrsponding SMM configurations

    Image Removed
    Image Removed
    Image Removed

    Select the appropriate type of change

    1Mapping Between SIP Packet Elements and Corresponding SMM Configurations
    SIP Header Rule FieldCorresponds to SIP message field
    Header NameFrom
    Display Namename
    URI Schemesip
    URI User1010
    Passwordpassword
    URI User Parametersusr=param
    URI HostIP address (i.e., 10.1.1.74)
    URI PortURI port (i.e, 5061)
    URI Parametersuser=phone
    Header ParametersHeader (i.e., tag=254b0000)

Step 5: Select Type of Change to be made

Configure the rule to correspond with the manipulation you require.

  1. Access SIP Header Rule.
  2. Align
    aligncenter

    Image Removed
    Steps to create a SMM Rule

    Panel5a: Select the Result Type. This setting operates exactly the same as the Translational Table optional/mandatory.
  3. 5b: Set the Action to Add, Remove, Copy, or Modify. The available options will vary based upon the type of rule you're adding. If you think about it, you can't _add a Request URI or Status Line; the SIP packet already has one, right?
  4. 5c: For Configure a Header Rule, you'll need supply a Header Name Name (either from the pre-progammed list or by simply typing the name of the header if it doesnisn't appear in the list). Request and Status Rules address only the Request and Status headers, so ; those rules don't require the user to pick do not require a header to be chosen.
  5. 5d: Configure the target rule setting. In the case of the example for For example, when changing any calling number of anonymous to 1000, set the User URI info Info to Modify and add the configuration/value you want for the SIP element changed to.
  6. 5e: If you created a Condition in Step 1, add it to the Rule entry now . In this example, the SMM will only execute if the Calling Number is 'anonymous'.Configure your
  7. Select the appropriate type of change to be made.

Step 6: Configure the new rule into either a Signaling Group or Call Route

...

Configure the new rule into either a Signaling Group or Call Route (SMM Rules can be processed either ingress or egress at the Signaling Group).

Align
aligncenter

Image Removed
Configure the SMM into the Signaling Group

Info

For details on Signaling Groups or Call Routes, refer to Managing SIP Signaling Groups or Managing Call Routing Tables.

Important Notes

Info

Like the Transformation Table's User Values, the SMM feature supports a method to copy values into user-controlled, generic tokens, SG User Values. The SG User Values can be transported from ingress to egress SG, or be utilized in a Transformation Table (e.g. to move a P-Asserted number to the Calling Number at the Call Route level rather than the Signaling Group level). See this SMM Document for an example of the SG User Value used with a Translation Table.

Pagebreak