Viewing and Deleting Triggers
Procedure
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:
a. Check the check box next to the name of the trigger to delete.
b. Click Remove.
c. In the Cisco Unified SIP Proxy header, click Commit Candidate Configuration to commit this change.
Related Topics
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.
Related Topics
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 3 Structure for the Trigger Called New_Trigger
|
|
|
|
|
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’”.
Related Topics
Available Trigger Conditions and Cases
Table 4 lists the available trigger conditions and cases.
Table 4 Available Trigger Conditions and Cases
|
|
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
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:
|
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:
|
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:
|
Related Topics
Adding a Trigger
Restriction
You cannot change the name of an existing trigger, so choose the name carefully.
Procedure
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.
Related Topics
Viewing, Adding, Moving, and Deleting Rules for a Trigger
Before You Begin
Add a trigger. See Adding a Trigger.
Procedure
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:
a. Click Add. The system displays the Trigger ‘<name of the trigger>’ Conditions page.
b. Add conditions. See Adding, Editing, and Deleting Conditions for a Trigger Rule.
Step 4 To delete a rule for a trigger, do the following:
a. Check the check box next to the rule to delete.
b. 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.
a. Select the rule.
b. Click the up or down arrows.
c. Click Update.
Step 6 In the Cisco Unified SIP Proxy header, click Commit Candidate Configuration to commit this change.
Related Topics
Adding, Editing, and Deleting Conditions for a Trigger Rule
Before You Begin
Add a trigger and rules for the trigger. See Adding a Trigger and Viewing, Adding, Moving, and Deleting Rules for a Trigger.
Restrictions
- 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.
Procedure
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:
a. Select a condition from the Trigger Condition drop-down menu. See Table 4 .
b. If necessary, select a condition case.
c. If necessary, enter a condition to match.
d. 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.
Related Topics