Configuring Triggers

Viewing and Deleting Triggers

SUMMARY STEPS

  1. Choose Configure > Triggers.
  2. To view the condition cases associated with this trigger, click the underlined name of the trigger.
  3. To delete a trigger, do the following:

DETAILED STEPS

Step 1

Choose Configure > Triggers.

The system displays the Triggers page and displays all triggers.

Step 2

To view the condition cases associated with this trigger, click the underlined name of the trigger.

Step 3

To delete a trigger, do the following:

  1. Check the check box next to the name of the trigger to delete.

  2. Click Remove.

  3. In the Cisco Unified SIP Proxy header, click Commit Candidate Configuration to commit this change.

About Triggers

A trigger is a set of conditions that can be used to dictate routing and normalization logic. It is automatically executed in response to a certain event (or condition case). Conditions can have multiple cases.

Note the structure:

  • A trigger is made up of one or more rules.

  • A rule is made up of one or more conditions.

  • A condition is made up of one or more cases.

For information on available triggers, see Available Trigger Conditions and Cases.

Example of a Trigger

You might have a trigger called New_Trigger. New_Trigger might have three rules, numbered 1, 2, and 3. Each rule has at least one condition and each condition has a case.

Table 1. Structure for the Trigger Called New_Trigger

Trigger Rules

Logic

Condition

1

Inbound Network is exactly ‘100’

AND

Local IP Address is exactly ‘100.10.10.101’

AND

SIP Message request

2

OR

Time Of Day is exactly ‘200’

AND

Mid-Dialog

AND

SIP Method UPDATE

3

OR

Outbound Network is exactly ‘300’

AND

Transport Protocol tcp

In the previous table, the trigger is called New_Trigger. New_Trigger has three rules. Because of the “OR” logic, only one of the three rules has to be true before the trigger is launched.

Rule 1 has three conditions:

  • Inbound Network is exactly ‘100’

  • Local IP Address is exactly ‘100.10.10.101’

  • SIP Message request

Because of the “AND” logic, all three conditions must be true before the rule is true.

In the condition “Inbound Network is exactly ‘100’”, the condition is “Inbound Network” and the case is “is exactly ‘100’”.

Available Trigger Conditions and Cases

The table lists the available trigger conditions and cases.

Table 2. Available Trigger Conditions and Cases

Trigger Name

Trigger Description

Trigger Condition Case

Inbound Network

Configures the inbound network for a trigger condition for a server-side transaction.

Enter the case:

  • is exactly (default)

  • contains

  • starts with

  • ends with

  • regex

Enter the condition:

  • IP for remote IP address

Outbound Network

Configures the outbound network for a trigger condition for a client-side transaction.

Enter the case:

  • is exactly (default)

  • contains

  • starts with

  • ends with

  • regex

Enter the condition:

  • IP for remote IP address

Local IP Address

Assigns a local-listen IP address that accepts incoming requests to a trigger condition.

Enter the case:

  • is exactly (default)

  • contains

  • starts with

  • ends with

  • regex

Enter the condition:

  • IP for remote IP address

Local Port

Assigns a local-listen port to a trigger condition.

Enter the case:

  • is exactly (default)

  • contains

  • starts with

  • ends with

  • regex

Enter the condition:

  • IP for remote IP address

Remote IP Address

Configures the remote IP network for a trigger condition.

Enter the case:

  • is exactly (default)

  • contains

  • starts with

  • ends with

  • regex

Enter the condition:

  • IP for remote IP address

Remote Port

Configures the remote port for a trigger condition.

Enter the case:

  • is exactly (default)

  • contains

  • starts with

  • ends with

  • regex

Enter the condition:

  • IP for remote IP address

SIP Message

Determines whether the trigger condition will fire based on whether the headers in the SIP message are request or response headers.

Enter the case:

  • request (default)

  • response

SIP Method

Configures a trigger condition in which the trigger is fired on the given SIP method name in the request.

  • INVITE (default)

  • ACK

  • PRACK

  • UPDATE

  • BYE

  • REFER

  • INFO

  • MESSAGE

  • OPTIONS

  • SUBSCRIBE

  • NOTIFY

  • REGISTER

  • PUBLISH

  • regular expression

SIP Response Code

Configures a trigger condition to fire on a specific response.

Enter the case:

  • is exactly (default)

  • contains

  • starts with

  • ends with

  • regex

Enter the condition:

  • IP for remote IP address

SIP Header

Configures the trigger to fire when matching the regular expression for this header.

Set the SIP header name.

Choose the SIP header index:

  • first (default)

  • last

  • all

Choose the type of match:

  • is exactly (default)

  • contains

  • starts with

  • ends with

  • regex

Mid-Dialog

Configures the trigger to fire on mid-dialog responses.

none

Time Of Day

Configures the trigger to fire if the specified time policy is met.

Enter the case:

  • is exactly (default)

  • contains

  • starts with

  • ends with

  • regex

Enter the condition:

  • IP for remote IP address

Transport Protocol

Assigns a transport protocol to the trigger condition.

Enter the case:

  • none (default)

  • udp

  • tcp

  • tls

Proxy Route

Ability to configure proxy route rule.

Choose the parameter:

  • uri (default)

  • uri-user

  • uri-host

  • uri-port

  • uri-scheme

  • uri-parameter

  • header-parameter

Choose the type of match:

  • is exactly (default)

  • contains

  • starts with

  • ends with

  • regex

Enter the condition:

  • IP for remote IP address

Request URI

Configures a trigger to fire when matching the regular expression for the specified Uniform Resource Identifier (URI) parameter.

Choose the parameter:

  • uri (default)

  • uri-user

  • uri-host

  • uri-port

  • uri-scheme

  • uri-parameter

  • header-parameter

Choose the type of match:

  • is exactly (default)

  • contains

  • starts with

  • ends with

  • regex

Enter the condition:

  • IP for remote IP address

Adding a Trigger


Restriction

You cannot change the name of an existing trigger, so choose the name carefully.

SUMMARY STEPS

  1. Choose Configure > Triggers.
  2. Click Add.
  3. Enter a name for this trigger.
  4. To have only one rule apply before the trigger is activated (that is, to apply “OR” logic), add logic to the rule by checking the Logic box.
  5. Click Add.
  6. Add rules to the trigger. See Viewing, Adding, Moving, and Deleting Rules for a Trigger.
  7. In the Cisco Unified SIP Proxy header, click Commit Candidate Configuration to commit this change.

DETAILED STEPS

Step 1

Choose Configure > Triggers.

The system displays the Triggers page.

Step 2

Click Add.

The system displays the Trigger (New) page.

Step 3

Enter a name for this trigger.

Step 4

To have only one rule apply before the trigger is activated (that is, to apply “OR” logic), add logic to the rule by checking the Logic box.

Step 5

Click Add.

The system displays the Trigger ‘<name of the trigger>’ Conditions page.

Step 6

Add rules to the trigger. See Viewing, Adding, Moving, and Deleting Rules for a Trigger.

Step 7

In the Cisco Unified SIP Proxy header, click Commit Candidate Configuration to commit this change.

Viewing, Adding, Moving, and Deleting Rules for a Trigger

Before you begin

Add a trigger. See Adding a Trigger.

SUMMARY STEPS

  1. Choose Configure > Triggers.
  2. To view the rules for a trigger, click the underlined name of the trigger.
  3. To add a rule for a trigger, do the following:
  4. To delete a rule for a trigger, do the following:
  5. If your trigger has multiple rules, you can reorder them by doing the following:
  6. In the Cisco Unified SIP Proxy header, click Commit Candidate Configuration to commit this change.

DETAILED STEPS

Step 1

Choose Configure > Triggers.

The system displays the Triggers page.

Step 2

To view the rules for a trigger, click the underlined name of the trigger.

The system displays the Trigger ‘<name of the trigger>’ Rules page.

Step 3

To add a rule for a trigger, do the following:

  1. Click Add. The system displays the Trigger ‘<name of the trigger>’ Conditions page.

  2. Add conditions. See Adding, Editing, and Deleting Conditions for a Trigger Rule.

Step 4

To delete a rule for a trigger, do the following:

  1. Check the check box next to the rule to delete.

  2. Click Remove.

Step 5

If your trigger has multiple rules, you can reorder them by doing the following:

Tip 

The trigger fires as soon as a rule is matched. To optimize the system, we recommend that you put the rule most likely to match at the top of the list.

  1. Select the rule.

  2. Click the up or down arrows.

  3. Click Update.

Step 6

In the Cisco Unified SIP Proxy header, click Commit Candidate Configuration to commit this change.

Adding, Editing, and Deleting Conditions for a Trigger Rule


Note

  • You cannot add condition cases to existing rules. You can only add condition cases to a rule when you originally create the rule.

  • You cannot edit existing conditions attached to a rule.

  • You cannot delete a condition case from a rule.

Before you begin

SUMMARY STEPS

  1. Choose Configure > Triggers.
  2. Click the underlined name of the trigger.
  3. To add a rule, click Add.
  4. To add a condition, do the following:
  5. Add additional conditions to this rule as needed.

DETAILED STEPS

Step 1

Choose Configure > Triggers.

The system displays the Triggers page.

Step 2

Click the underlined name of the trigger.

The system displays the Trigger ‘<name of the trigger>’ Rules page.

Step 3

To add a rule, click Add.

The system displays the Trigger ‘<name of the trigger>’ Conditions page. You are automatically adding a new rule by being on this page. This page is where you add conditions to the new rule.

Step 4

To add a condition, do the following:

  1. Select a condition from the Trigger Condition drop-down menu. See Available Trigger Conditions and Cases.

  2. If necessary, select a condition case.

  3. If necessary, enter a condition to match.

  4. Click Add.

    The system displays the Trigger ‘<name of the trigger>’ Conditions page with the new condition.

Step 5

Add additional conditions to this rule as needed.