route table file
To load the routes for a route table from a file, use the route table file command in Cisco Unified SIP Proxy configuration mode. To delete the route table and the routes loaded from a file, use the no form of this command.
route table table_name file route-file
no route table table_name file route-file
Syntax Description
table_name |
Specifies the route table name as configured using the route table command. |
file route-file |
Specifies the file you are loading the route information from. The file path must start with pfs:/cusp/routes/. |
Command Modes
Cisco Unified SIP Proxy configuration (cusp-config)
Command History
Cisco Unified SIP Proxy Version
|
|
1.0 |
This command was introduced. |
8.5 |
This command was updated as follows:
- You can now have a route table that consists of both routes loaded from a file and routes configured on the system.
- You no longer need to keep the route table file in the upload location after you have uploaded the information from the file.
|
Usage Guidelines
– In Cisco Unified SIP Proxy Release 1.1.x, a route table can consist of either routes loaded from a file using this command or routes configured using the route table submode commands, but a route table cannot be mixed with routes loaded from a file and configured on the system.
– In Cisco Unified SIP Proxy Release 8.5 and later versions, after you use this command, you are put into route submode. Therefore, after you load routes from the file, you can make further changes to the route table. You can now have a route table that consists of both routes loaded from a file and routes configured on the system.
- Location of the route table file:
– In Cisco Unified SIP Proxy Release 1.1.x, the file that you uploaded must remain in that location or else the system will lose the route configuration upon reboot.
– In Cisco Unified SIP Proxy Release 8.5 and later versions, you do not need to keep the file in that location.
Note This command requires that you use the commit command for the configuration changes to take effect.
Examples
The following example loads routes from file routes.txt into route table t1:
se-10-0-0-0(cusp-config)> route table t1
se-10-0-0-0(cusp-config-rt)> exit
se-10-0-0-0(cusp-config)> route table t1 file pfs:/cusp/routes/routes.txt
The following example deletes the route table:
se-10-0-0-0(cusp-config)> no route table t1
Related Commands
|
|
commit |
Enables configuration changes for selected Cisco Unified SIP Proxy commands to take effect. |
key group |
Assigns a route group to a routing table and associates it with a key number. |
key response |
Assigns a response code to a key in a routing table. |
key route-uri target-destination |
Assigns a route-URI to a lookup key in a routing table and replaces the target destination with the specified value in the outgoing SIP request. |
key target-destination |
Assigns a request-URI to a key in a routing table. |
route table |
Creates a route table and enters route table configuration mode. |
route table
To create a route table and enter route table configuration mode, use the route table command in Cisco Unified SIP Proxy configuration mode. To delete the route table, use the no form of this command.
route table table_name
no route table table_name
Syntax Description
table_name |
Specifies the name of the route table. |
Command Default
A route table is not configured.
Command Modes
Cisco Unified SIP Proxy configuration (cusp-config)
Command History
Cisco Unified SIP Proxy Version
|
|
1.0 |
This command was introduced. |
Usage Guidelines
After you enter this command, you enter route table configuration mode. Use the commands in this configuration mode to configure the routes to be added to the route table. Lookups are performed on the route table keys that are specified using the key group, key target-destination, key response, and key route-uri target-destination commands. Keys with white space need to be specified using quotation marks.
A route table can consist of routes configured using the submode commands accessed using this command, or routes loaded from a file using the route table file command, however a route table cannot be mixed with routes configured on the system and loaded from a file.
Note This command requires that you use the commit command for the configuration changes to take effect.
Examples
The following configures route table t1:
se-10-0-0-0(cusp-config)> route table t1
se-10-0-0-0(cusp-config-rt)>
The following example deletes the route table:
se-10-0-0-0(cusp-config)> no route table t1
Related Commands
|
|
commit |
Enables configuration changes for selected Cisco Unified SIP Proxy commands to take effect. |
key group |
Assigns a route group to a routing table and associates it with a key number. |
key response |
Assigns a response code to a key in a routing table. |
key route-uri target-destination |
Assigns a route-URI to a lookup key in a routing table and replaces the target destination with the specified value in the outgoing SIP request. |
key target-destination |
Replaces a target destination with the specified value in an outgoing SIP request. |
route table file |
Loads the routes for a route table from a file. |
key default-sip
To configure the message in the route table to be simply routed using RFC 3263, use the key default-sip command in route table configuration mode. To remove the key from the route table, use the no form of this command.
key key default-sip network
no key key default-sip
Syntax Description
key |
Specifies the route table lookup key. |
network |
Specifies the name of the SIP network associated with this route (previously configured using the sip network command). |
Command Modes
Route table configuration (cusp-config-rt)
Command History
Cisco Unified SIP Proxy Version
|
|
1.0 |
This command was introduced. |
Usage Guidelines
The lookup key represents the portion of the SIP message that is being matched, and must be unique to the routing table.
Examples
The following example configures the message in the route table to be routed using RFC 3263:
se-10-0-0-0(cusp-config)> route table t1
se-10-0-0-0(cusp-config-rt)> key 973 default-sip external
The following example removes the lookup key from the route table:
se-10-0-0-0(cusp-config)> route table t1
se-10-0-0-0(cusp-config-rt)> no key 973 default-sip
Related CommandsTBD
|
|
key group |
Assigns a route group to a routing table and associates it with a key number. |
key policy |
Assigns a route policy to a key in a routing table. |
key response |
Assigns a response code to a key in a routing table. |
key route-uri target-destination |
Assigns a route-URI to a lookup key in a routing table and replaces the target destination with the specified value in the outgoing SIP request. |
key target-destination |
Replaces a target destination with the specified value in an outgoing SIP request. |
route table |
Creates a route table and enters route table configuration mode. |
key group
To assign a route group to a routing table and associate it with a lookup key number, use the key group command in route table configuration mode. To remove the route group assignment from the lookup key in the routing table, use the no form of this command.
key key group route-group name
no key key
Syntax Description
key |
Specifies the route table lookup key. The lookup key represents the portion of the SIP message that is being matched, and must be unique to the routing table. |
route-group name |
Specifies the name of the route-group. |
Command Modes
Route table configuration (cusp-config-rt)
Command History
Cisco Unified SIP Proxy Version
|
|
1.0 |
This command was introduced. |
Usage Guidelines
You cannot assign a route group and a request URI (using the key target-destination command) to the same key number.
Note This command requires that you use the commit command for the configuration changes to take effect.
Examples
The following example assigns a previously-configured route group to a routing table and assigns it a key number:
se-10-0-0-0(cusp-config)> route group users
se-10-0-0-0(cusp-config-rg)> exit
se-10-0-0-0(cusp-config)> route table t1
se-10-0-0-0(cusp-config-rt)> key 973 group users
The following example removes the lookup key from the route table:
se-10-0-0-0(cusp-config)> route table t1
se-10-0-0-0(cusp-config-rt)> no key 973
Related Commands
|
|
commit |
Enables configuration changes for selected Cisco Unified SIP Proxy commands to take effect. |
key default-sip |
Configures the message in the route table to be routed using RFC 3263. |
key policy |
Assigns a route policy to a key in a routing table. |
key response |
Assigns a response code to a key in a routing table. |
key route-uri target-destination |
Assigns a route-URI to a lookup key in a routing table and replaces the target destination with the specified value in the outgoing SIP request. |
key target-destination |
Replaces a target destination with the specified value in an outgoing SIP request. |
route table |
Creates a route table and enters route table configuration mode. |
key policy
To assign a lookup policy to a key in a routing table, use the key policy command in route table configuration mode. To remove the route policy assignment from the key in the routing table, use the no form of this command.
key key policy route-policy
no key key policy route-policy
Syntax Description
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-policy |
Specifies the route lookup policy (configured with the policy lookup command) to be used in the routing table. |
Command Modes
Route table configuration (cusp-config-rt)
Command History
Cisco Unified SIP Proxy Version
|
|
1.0 |
This command was introduced. |
Usage Guidelines
Use this command to configure a defined routing policy to advance to when route advance processing exhausts all specified next hop tuples. This command requires that the policy first be configured using the policy lookup command.
Note This command requires that you use the commit command for the configuration changes to take effect.
Examples
The following example assigns a previously-configured lookup policy to a routing table and assigns it a key number:
se-10-0-0-0(cusp-config)> policy lookup p1
se-10-0-0-0(cusp-config-lookup)> exit
se-10-0-0-0(cusp-config)> route table t1
se-10-0-0-0(cusp-config-rt)> key 973 policy p1
The following example removes the lookup key from the route table:
se-10-0-0-0(cusp-config)> route table t1
se-10-0-0-0(cusp-config-rt)> no key 973
Related Commands
|
|
commit |
Enables configuration changes for selected Cisco Unified SIP Proxy commands to take effect. |
key default-sip |
Configures the message in the route table to be routed using RFC 3263. |
key group |
Assigns a route group to a routing table and associates it with a key number. |
key response |
Assigns a response code to a key in a routing table. |
key route-uri target-destination |
Assigns a route-URI to a lookup key in a routing table and replaces the target destination with the specified value in the outgoing SIP request. |
key target-destination |
Replaces a target destination with the specified value in an outgoing SIP request. |
policy lookup |
Configures a lookup policy and enters lookup policy configuration mode. |
route table |
Creates a route table and enters route table configuration mode. |
key response
To assign a response code to a lookup key in a routing table, use the key response command in route table configuration mode. To remove the response code assignment from the lookup key in the routing table, use the no form of this command.
key key response response-code
no key key [response response-code]
Syntax Description
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. |
response-code |
Specifies the response code as configured using the failover-resp-code command. |
Command Modes
Route table configuration (cusp-config-rt)
Command History
Cisco Unified SIP Proxy Version
|
|
1.0 |
This command was introduced. |
Usage Guidelines
This command requires that you configure the failover-resp-code command first.
Note This command requires that you use the commit command for the configuration changes to take effect.
Examples
The following example assigns a response code to a routing table and assigns it a key number:
se-10-0-0-0(cusp-config)> server-group sip t1
se-10-0-0-0(cusp-config-sg)> failover-resp-code 404
se-10-0-0-0(cusp-config-sg)> exit
se-10-0-0-0(cusp-config)> route table t1
se-10-0-0-0(cusp-config-rt)> key 973 response 404
The following example removes the lookup key from the route table:
se-10-0-0-0(cusp-config)> route table t1
se-10-0-0-0(cusp-config-rt)> no key 973
Related Commands
|
|
commit |
Enables configuration changes for selected Cisco Unified SIP Proxy commands to take effect. |
failover-resp-code |
Configures a failover response code for a SIP server group. |
key default-sip |
Configures the message in the route table to be routed using RFC 3263. |
key group |
Assigns a route group to a routing table and associates it with a key number. |
key policy |
Assigns a route policy to a key in a routing table. |
key route-uri target-destination |
Assigns a route-URI to a lookup key in a routing table and replaces the target destination with the specified value in the outgoing SIP request. |
key target-destination |
Replaces a target destination with the specified value in an outgoing SIP request. |
route table |
Creates a route table and enters route table configuration mode. |
key route-uri target-destination
To assign a route-URI to a lookup key in a routing table and replace the target destination with the specified value in the outgoing SIP request, use the key route-uri target-destination command in Cisco Unified SIP Proxy route table configuration mode. To remove the route-URI assignment from the lookup key in the routing table, use the no form of this command.
key key route-uri route-uri target-destination target-destination network
no key key [ route-uri route-uri target-destination target-destination network ]
Syntax Description
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-uri route-uri |
Specifies the URI in the route header field to be assigned to the routing table. |
target-destination target-destination |
Specifies the host and port and transport of the request-URI. The format of this field is host:port:transport; port and transport are optional.. |
network |
Specifies the SIP network name as configured using the sip network command. |
Command Modes
Cisco Unified SIP Proxy route table configuration (cusp-config-rt)
Command History
Cisco Unified SIP Proxy Version
|
|
1.0 |
This command was introduced. |
Usage Guidelines
The route-URI must be configured first using the element route-uri command.
Note This command requires that you use the commit command for the configuration changes to take effect.
Examples
The following example assigns a route-URI to a routing table and assigns it a key number:
se-10-0-0-0(cusp-config)> route group users
se-10-0-0-0(cusp-config-rg)> element route-uri sip:external@example.com internal 1.0
se-10-0-0-0(cusp-config-rg)> exit
se-10-0-0-0(cusp-config)> route table t1
se-10-0-0-0(cusp-config-rt)> key 973 route-uri sip:external@example.com;lr target-destination 192.168.1.1:5060 external
The following example removes the lookup key from the route table:
se-10-0-0-0(cusp-config)> route table t1
se-10-0-0-0(cusp-config-rt)> no key 973
Related Commands
|
|
commit |
Enables configuration changes for selected Cisco Unified SIP Proxy commands to take effect. |
element route-uri |
Adds a route-URI header and replaces it with a request URI header in a route group, and enters element configuration mode. |
key default-sip |
Configures the message in the route table to be routed using RFC 3263. |
key group |
Assigns a route group to a routing table and associates it with a key number. |
key policy |
Assigns a route policy to a key in a routing table. |
key response |
Assigns a response code to a key in a routing table. |
key target-destination |
Replaces a target destination with the specified value in an outgoing SIP request. |
route table |
Creates a route table and enters route table configuration mode. |
sip network |
Creates a logical SIP network and enters SIP network configuration mode. |
key target-destination
To replace a target destination with the specified value in an outgoing SIP request, use the key target-destination command in route table configuration mode. To remove the request-URI from the key in the routing table, use the no form of this command.
key key target-destination target-destination network
no key key [ target-destination request-uri-host-port network]
Syntax Description
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. |
target-destination |
Specifies the host and port and transport of the request-URI to be assigned to the routing table. The format of this field is host:port:transport; port and transport are optional. |
network |
Specifies the SIP network name. |
Command Modes
Route table configuration (cusp-config-rt)
Command History
Cisco Unified SIP Proxy Version
|
|
1.0 |
This command was introduced. |
Usage Guidelines
The request-URI must be configured first using the element target-destination command.
You cannot assign a request-URI and a route group (using the key group command) to the same key number.
Note This command requires that you use the commit command for the configuration changes to take effect.
Examples
The following example assigns a target destination to a routing table and assigns it a key number:
se-10-0-0-0(cusp-config)> route group users
se-10-0-0-0(cusp-config-rg)> element target-destination sip:external@example.com internal 1.0
se-10-0-0-0(cusp-config-rg)> exit
se-10-0-0-0(cusp-config)> route table t1
se-10-0-0-0(cusp-config-rt)> key 973 target-destination hostnameB internal
The following example removes the lookup key from the route table:
se-10-0-0-0(cusp-config)> route table t1
se-10-0-0-0(cusp-config-rt)> no key 973
Related Commands
|
|
commit |
Enables configuration changes for selected Cisco Unified SIP Proxy commands to take effect. |
element target-destination |
Addds a target destination element to a route group and enters element configuration mode. |
key default-sip |
Configures the message in the route table to be routed using RFC 3263. |
key group |
Assigns a route group to a routing table and associates it with a key number. |
key policy |
Assigns a route policy to a key in a routing table. |
key response |
Assigns a response code to a key in a routing table. |
key route-uri target-destination |
Assigns a route-URI to a lookup key in a routing table and replaces the target destination with the specified value in the outgoing SIP request. |
route table |
Creates a route table and enters route table configuration mode. |
route group
To create a route group and enter route group configuration mode, use the route group command in Cisco Unified SIP Proxy configuration mode. To remove the route group, use the no form of this command.
route group route-group-name [ time-policy ] [ weight ]
no route group route-group-name
Syntax Description
route-group-name |
Specifies the name of the route group. |
time-policy |
(Optional) Enables the time-based routing configurations configured with the policy time command that this route group will use if implementing time-based routing. This option is disabled by default. |
weight |
(Optional) Enables weight-based routing configurations for the route group. If selected, the route group uses weight as the algorithm to pick the next route. This option is disabled by default. |
Command Modes
Cisco Unified SIP Proxy configuration (cusp-config)
Command History
Cisco Unified SIP Proxy Version
|
|
1.0 |
This command was introduced. |
Usage Guidelines
This command configures a route group and its route group elements. A route group is a set of one or more route group elements or next-hop tuple configurations. Route groups allow specific sets of next-hop data tuples to be reused across multiple route configurations.
Note This command requires that you use the commit command for the configuration changes to take effect.
Examples
The following example creates a route group g1 and enters route group configuration mode:
se-10-0-0-0(cusp-config)> route group g1
se-10-0-0-0(cusp-config-rg)>
The following example creates a route group using weight-based routing:
se-10-0-0-0(cusp-config)> route group g1 weight
The following example creates a route group using both time-based and weight-based routing:
se-10-0-0-0(cusp-config)> route group g1 time-policy weight
The following example deletes a route group:
se-10-0-0-0(cusp-config)> no route group g1
Related Commands
|
|
commit |
Enables configuration changes for selected Cisco Unified SIP Proxy commands to take effect. |
element route-uri |
Adds a route-URI element to a route group. |
element target-destination |
Addds a target destination element to a route group and enters element configuration mode. |
policy time |
Creates a time policy and enters time-policy configuration mode. |
show routes table |
Displays the configured Cisco Unified SIP Proxy routes. |
element route-uri
To add a route-URI header and replace it with a request URI header in a route group, and to enter element configuration mode, use the element-route-uri command in Cisco Unified SIP Proxy route group configuration mode. To remove the route entry from the route group, use the no form of this command.
element route-uri route-uri network [q_value]
no element route-uri route-uri network
Syntax Description
route-uri route-uri |
Specifies the Route-URI header. |
request-uri request-uri |
Specifies the Request-URI header that will replace the Route-URI header. |
network |
Specifies the SIP network configured with the sip network command. |
q_value |
(Optional) Represents a real number that specifies the priority of the server group element with respect to others in the server group. Valid values are from 0.0 to 1.0. The default is 1.0. |
Command Default
The route-URI element is not configured.
Command Modes
Cisco Unified SIP Proxy route group configuration (cusp-config-rg)
Command History
Cisco Unified SIP Proxy Version
|
|
1.0 |
This command was introduced. |
Usage Guidelines
More than one route-URI can be assigned to a given network.
For the weight option, each element in a server group is assigned a weight such that the element will receive a traffic load that is proportional to its weight relative to the weights of other elements of the same priority (q-value) in the server group.
Note This command requires that you use the commit command for the configuration changes to take effect.
Examples
The following example adds a route-URI element to a route group:
se-10-0-0-0(cusp-config)> route group g1
se-10-0-0-0(cusp-config-rg)> element route-uri sip:external@example.com ;lr internal
se-10-0-0-0(cusp-config-rg-element)>
The following example removes a route-URI element from a route group:
se-10-0-0-0(cusp-config)> route group g1
se-10-0-0-0(cusp-config-rg)> no element route-uri sip:external@example.com ;lr internal
Related Commands
|
|
commit |
Enables configuration changes for selected Cisco Unified SIP Proxy commands to take effect. |
element target-destination |
Addds a target destination element to a route group and enters element configuration mode. |
failover-codes |
Configures the failover codes for the request-URI element or route-URI element. |
route group |
Creates a route group and enters route group configuration mode. |
time-policy (element) |
Configures the time-policy used if implementing time-based routing. |
weight |
Configures the percentage assigned to the request-URI or route-URI in the route group if implementing weight-based routing. |
element route-uri target-destination
To add a route-URI element to a route group and to enter element configuration mode, use the element-route-uri command in Cisco Unified SIP Proxy route group configuration mode. To remove the route entry from the route group, use the no form of this command.
element route-uri route-uri request-uri-host-port request-uri-host-port network [q_value]
no element route-uri route-uri network
Syntax Description
route |
Specifies the Route-URI header. |
request-uri-host-port |
Specifies the Request-URI-host-port in the request. The format of this field is host:port; port is optional. |
network |
Specifies the SIP network configured with the sip network command. |
q_value |
(Optional) Represents a real number that specifies the priority of the server group element with respect to others in the server group. Valid values are from 0.0 to 1.0. The default is 1.0. |
Command Default
The route-URI element is not configured.
Command Modes
Cisco Unified SIP Proxy route group configuration (cusp-config-rg)
Command History
Cisco Unified SIP Proxy Version
|
|
1.0 |
This command was introduced. |
Usage Guidelines
More than one route-URI can be assigned to a given network.
Note This command requires that you use the commit command for the configuration changes to take effect.
Examples
The following example adds a route-URI element to a route group:
se-10-0-0-0(cusp-config)> route group g1
se-10-0-0-0(cusp-config-rg)> element route-uri sip:external@example.com;lr request-uri-host-port 192.168.1.1:5060 internal
se-10-0-0-0(cusp-config-rg-element)>
The following example removes a route-URI element from a route group:
se-10-0-0-0(cusp-config)> route group g1
se-10-0-0-0(cusp-config-rg)> no element route-uri sip:external@example.com;lr request-uri-host-port 192.168.1.1.:5060
Related Commands
|
|
commit |
Enables configuration changes for selected Cisco Unified SIP Proxy commands to take effect. |
element target-destination |
Addds a target destination element to a route group and enters element configuration mode. |
failover-codes |
Configures the failover codes for the request-URI element or route-URI element. |
route group |
Creates a route group and enters route group configuration mode. |
sip network |
Creates a logical SIP network and enters SIP network configuration mode. |
time-policy (element) |
Configures the time-policy used if implementing time-based routing. |
weight |
Configures the percentage assigned to the request-URI or route-URI in the route group if implementing weight-based routing. |
element target-destination
To add a target destination element to a route group and to enter element configuration mode, use the element target-destination command in route group configuration mode. To remove the route entry from the route group, use the no form of this command.
element target-destination target-destination network [ q_value]
no element target-destination target-destination
Syntax Description
target-destination |
Specifies the next hop tuples based off the target-destination in the request. The format of this field is host:port; port is optional. |
network |
Specifies the SIP network configured with the sip network command. |
q_value |
(Optional) Represents a real number that specifies the priority of the server group element with respect to others in the server group. Valid values are from 0.0 to 1.0. The default is 1.0. |
Command Default
The request-URI element is not configured.
Command Modes
Cisco Unified SIP Proxy route group configuration (cusp-config-rg)
Command History
Cisco Unified SIP Proxy Version
|
|
1.0 |
This command was introduced. |
Usage Guidelines
Note This command requires that you use the commit command for the configuration changes to take effect.
Examples
The following example adds a target destination element to a route group:
se-10-0-0-0(cusp-config)> route group g1
se-10-0-0-0(cusp-config-rg)> element target-destination hostnameB internal
se-10-0-0-0(cusp-config-rg-element)>
The following example removes a target destination element from a route group:
se-10-0-0-0(cusp-config)> route group g1
se-10-0-0-0(cusp-config-rg)> no element target-destination hostnameB
Related Commands
|
|
commit |
Enables configuration changes for selected Cisco Unified SIP Proxy commands to take effect. |
element route-uri |
Adds a route-URI element to a route group. |
failover-codes |
Configures the failover codes for the request-URI element or route-URI element. |
route group |
Creates a route group and enters route group configuration mode. |
sip network |
Creates a logical SIP network and enters SIP network configuration mode. |
time-policy (element) |
Configures the time-policy used if implementing time-based routing. |
weight |
Configures the percentage assigned to the request-URI or route-URI in the route group if implementing weight-based routing. |
failover-codes
To configure the failover codes for an element request-URI or element route-URI, use the failover-codes command in element request-URI or element route-URI configuration mode. To remove the failover code, use the no form of this command.
failover-codes codes [ - code ] [ , continue ]
no failover-codes
Syntax Description
codes |
Specifies the SIP response codes, which are separated by a comma. A single white space must be entered before and after each comma and dash used to denote a multiple range. |
Command Default
No failover codes are configured.
Command Modes
Element configuration (cusp-config-rg-element)
Command History
Cisco Unified SIP Proxy Version
|
|
1.0 |
This command was introduced. |
Usage Guidelines
Route advance occurs if the proxy receives one of the specified response codes from the downstream element.
Examples
The following example adds response codes to a route-URI element in a route group:
se-10-0-0-0(cusp-config)> route group g1
se-10-0-0-0(cusp-config-rg)> element route-uri sip:external@example.com internal 1.0
se-10-0-0-0(cusp-config-rg-element)> failover-codes 502, 503
The following example adds response codes to a route-URI element in a route group:
se-10-0-0-0(cusp-config)> route group g1
se-10-0-0-0(cusp-config-rg)> element route-uri sip:external@example.com internal 1.0
se-10-0-0-0(cusp-config-rg-element)> failover-codes 502, 504 - 508, 588
The following example removes the failover codes from the route-URI element:
se-10-0-0-0(cusp-config-rg)> element route-uri sip:external@example.com internal 1.0
se-10-0-0-0(cusp-config-rg-element)> no failover-codes
Related CommandsTBD
|
|
commit |
Enables configuration changes for selected Cisco Unified SIP Proxy commands to take effect. |
element route-uri |
Adds a route-URI element to a route group. |
element target-destination |
Addds a target destination element to a route group and enters element configuration mode. |
route group |
Creates a route group and enters route group configuration mode. |
time-policy (element) |
Configures the time-policy used if implementing time-based routing. |
weight |
Configures the percentage assigned to the request-URI in the route group if implementing weight-based routing. |
time-policy (element)
To configure the time policy for an element request-URI or element route-URI, use the time-policy command in element request-URI or element route-URI configuration mode. To remove the time policy, use the no form of this command.
time-policy policy
no time-policy
Syntax Description
policy |
Specifies the time policy previously configured using the policy time command if implementing time-based routing. This option is only valid if the time-policy option is specified in the route group command. |
Command Modes
Element configuration (cusp-config-rg-element)
Command History
Cisco Unified SIP Proxy Version
|
|
1.0 |
This command was introduced. |
Examples
The following example configures a time policy for a route-URI element:
se-10-0-0-0(cusp-config)> route group g1
se-10-0-0-0(cusp-config-rg)> element route-uri sip:external@example.com internal 1.0
se-10-0-0-0(cusp-config-rg-element)> time-policy tp1
The following example removes the time policy from the element route-URI:
se-10-0-0-0(cusp-config-rg)> element route-uri sip:external@example.com internal 1.0
se-10-0-0-0(cusp-config-rg-element)> no time-policy
Related CommandsTBD
|
|
commit |
Enables configuration changes for selected Cisco Unified SIP Proxy commands to take effect. |
element route-uri |
Adds a route-URI element to a route group. |
element target-destination |
Addds a target destination element to a route group and enters element configuration mode. |
failover-codes |
Configures the failover codes for the request-URI element or route-URI element. |
route group |
Creates a route group and enters route group configuration mode. |
weight |
Configures the percentage assigned to the request-URI in the route group if implementing weight-based routing. |
weight
To configure the weight percentage assigned to a request-URI or route-URI if implementing weight-based routing, use the weight command in element configuration mode. To remove the weight, use the no form of this command.
weight weight
no weight
Syntax Description
weight |
Specifies the percentage assigned to the request-URI or route-URI element in the route group if implementing weight-based routing. The valid range is from 0 to 100. If not configured, the default weight is 50. This option is only valid if the weight option is specified in the route group command. |
Command Modes
Element configuration (cusp-config-rg-element)
Command History
Cisco Unified SIP Proxy Version
|
|
1.0 |
This command was introduced. |
Usage Guidelines
Each element in a route group is assigned a weight. Each element receives a traffic load that is proportional to its weight.
Examples
The following example configures the route-URI element to have a percentage-weight of 50 for weight-based routing:
se-10-0-0-0(cusp-config)> route group g1
se-10-0-0-0(cusp-config-rg)> element route-uri sip:external@example.com internal 1.0
se-10-0-0-0(cusp-config-rg-element)> weight 50
The following example removes the weight value from the element route-URI:
se-10-0-0-0(cusp-config-rg)> element route-uri sip:external@example.com internal 1.0
se-10-0-0-0(cusp-config-rg-element)> no weight
Related CommandsTBD
|
|
commit |
Enables configuration changes for selected Cisco Unified SIP Proxy commands to take effect. |
element route-uri |
Adds a route-URI element to a route group. |
element target-destination |
Addds a target destination element to a route group and enters element configuration mode. |
failover-codes |
Configures the failover codes for the request-URI element or route-URI element. |
route group |
Creates a route group and enters route group configuration mode. |
time-policy (element) |
Configures the time-policy used if implementing time-based routing. |