Viewing a List of Route Tables
Procedure
Step 1
Choose Configure > Route Tables.
The system displays the Route Tables page, containing the fields described in Table 11 .
Step 2
To delete a route table, do the following:
a.
Check the check box next to the name of the route table to delete.
b.
Click Remove.
c.
In the Cisco Unified SIP Proxy header, click Commit Candidate Configuration to commit this change.
Step 3
To revert any changes you have made back to the state they were in at the time of the last commit, do the following:
a.
Check the check box next to the name of the route table that has the changes to revert back to.
b.
Click Revert.
c.
In the Cisco Unified SIP Proxy header, click Commit Candidate Configuration to commit this change.
About Route Tables
You configure route tables to direct SIP requests to their appropriate destinations. Each route table consists of a set of keys that are matched based on the lookup policy.
For example, in one table, each key might represent the prefix of the phone number dialed. The table performs a task depending on the prefix dialed. In this example, the table is designed to respond to calls with a 404 message (not found) unless the phone number dialed begins with 510. Another table might be designed to respond to calls with a 404 message (not found) unless the phone number dialed begins with the escape sequence (91).
You can add, update, or delete route tables from the Route Tables page. You can also add, update, or delete routes.
Route Table Fields
Table 11 lists the fields on the Route Tables page.
Table 11 Route Tables Parameters
|
|
State |
Can be one of the following:
- New—New record. Will be added to the active configuration when it is committed.
- Modified—Modified record. Will become the active configuration when it is committed.
- Deleted—Deleted record. Will be removed from the active configuration when it is committed.
- Active—Active record and active configuration.
|
Name |
Name of this route table. The valid characters are alphanumeric characters, dash, period, and underscore. |
Route Fields
Table 12 lists the fields on the Route Table ‘<name of route>’ Routes page.
Note
Depending on the route type that you choose, you will see some or all of these parameters.
Table 12 Route Table Route Parameters
|
|
State |
Can be one of the following:
- New—New record. Will be added to the active configuration when it is committed.
- Modified—Modified record. Will become the active configuration when it is committed.
- Deleted—Deleted record. Will be removed from the active configuration when it is committed.
- Active—Active record and active configuration.
|
|
Key |
Specifies the route table lookup key number. The lookup key represents the portion of the SIP message that is being matched, and must be unique to the routing table. |
Route Type |
Can be one of the following:
- destination
- route-group
- route-policy
- response
- default-sip
|
Destination Route Type (Optional; only available if you choose a
Route Type of destination or default-sip)
|
Destination Route Type |
The type of route. Can be either target destination, next hop, or both. |
Network |
Specifies the SIP network name. |
Target Destination (Optional; only available if you choose a
Destination Route Type of target destination or both)
|
Host/Server Group |
Hostname or IP address of the target destination. |
Port |
Port of the target destination. Values can be 1024 to 65535. |
Transport Type |
Can be one of the following:
|
|
SIP URI |
URI of the next hop. |
Route-Group Route Type (Optional; only available if you choose a
Route Type of route-group)
|
Route Group |
The name of the route group. |
Response Route Type (Optional; only available if you choose a
Route Type of response)
|
Response |
Specifies the response code to a lookup key in a routing table. |
Route-Policy Route Type (Optional; only available if you choose a
Route Type of route-policy)
|
Lookup Route Policy |
Specifies the route lookup policy to be used in the routing table. |
Default SIP Route |
Simple routing following RFC 3263. |
Related Topics
Adding a Route Table
Procedure
Step 1
Choose Configure > Route Tables.
The system displays the Route Tables page.
Step 2
Click Add.
The system displays the Route Tables page.
Step 3
Enter a name for this route table.
Step 4
Click Add.
The system displays the Route Tables page, with the new route table listed.
Step 5
In the Cisco Unified SIP Proxy header, click Commit Candidate Configuration to commit this change.
Related Topics
Viewing a List of Route Table Routes
Procedure
Step 1
Choose Configure > Route Tables.
The system displays the Route Tables page, containing the fields described in Table 11 .
Step 2
To see the routes associated with the route table, click the underlined name of the route table.
The system displays the Route Table ‘<name of route table>’ Routes page, containing some or all of the fields described in Table 12 .
Step 3
To see a different number of routes on each page, on the top right, choose another number from the drop-down box and click Go. You can choose to see 10, 25, 50, 100, or all routes.
Step 4
To move to another page, use the left and right arrow buttons on the bottom right, or enter another page number, and press Enter.
Step 5
To delete a route, do the following:
a.
Check the check box next to the name of the route to delete.
b.
Click Remove.
c.
In the Cisco Unified SIP Proxy header, click Commit Candidate Configuration to commit this change.
Step 6
To revert any changes you have made back to the state they were in at the time of the last commit, do the following:
a.
Check the check box next to the name of the route table that has the changes to revert back to.
b.
Click Revert.
c.
In the Cisco Unified SIP Proxy header, click Commit Candidate Configuration to commit this change.
Related Topics
Adding a Route to a Route Table
Before You Begin
If you are going to import one or more routes from a file, put the file in the pfs:/cusp/routes/ directory.
Procedure
Step 1
Choose Configure > Route Tables.
The system displays the Route Tables page.
Step 2
Click the underlined name of the route table for which you want to add a route.
The system displays the Route Table ‘<name of route table>’ Routes page.
Step 3
Click Add.
The system displays the Route Table ‘<name of route table>’ Route (New) page.
Step 4
Enter information about the route as described in Table 12 .
Step 5
Click Add.
Step 6
To load the routes for a route table from a file, click Import.
Step 7
Enter the name of a file.
Note
The file must be in the following directory: pfs:/cusp/routes/
Step 8
In the Cisco Unified SIP Proxy header, click Commit Candidate Configuration to commit this change.
Related Topics
Exporting Active Routes
Restriction
You can only export routes that are in the active state. To move a route to the active state, commit the configuration.
Procedure
Step 1
Choose Configure > Route Tables.
The system displays the Route Tables page.
Step 2
Click the underlined name of the route table that contains the routes to export.
The system displays the Route Table ‘<name of route table>’ Routes page.
Step 3
Click Export Active Routes.
The system displays a dialog box.
Step 4
Click Save.
Step 5
Enter the location to which you want to export the file. Click OK.
The system saves the route to that location.
Related Topics
Editing the Routes Associated with a Route Table
Procedure
Step 1
Choose Configure > Route Tables.
The system displays the Route Tables page.
Step 2
Click the underlined name of the route table that contains the route to edit.
The system displays the Route Table ‘<name of route table>’ Routes page.
Step 3
Click the underlined name of the key for the route to edit.
The system displays the Route Table ‘<name of route table>’ Route page.
Step 4
Make changes to the values.
Step 5
Click Update.
Step 6
In the Cisco Unified SIP Proxy header, click Commit Candidate Configuration to commit this change.
Related Topics