Table 17 RAS Directives
Directive Name
|
Directive Definition
|
Valid Directive Values
|
RASModule
|
Enables the RAS module.
|
On and Off. Default is Off.
|
RASAcceptLCF
|
LCF message to accept.
|
First (take the first valid LCF message from any gatekeeper) and Best (wait for the best LCF message within the LRQ time window; "best" means from the gateway that has the lowest cost and highest priority).
|
RASTimeoutInterval
|
Time (in milliseconds) to wait for a single response from a gatekeeper. If the timeout expires, Cisco SPS tries another gatekeeper within the same cluster. You must set this directive if you set the RAS LRQ Method to Sequential.
|
Default is 300.
|
RASLRQMethod
|
Method used to send LRQ messages to a gatekeeper.
|
Sequential (Cisco SPS sends LRQs sequentially and waits for a response in the RAS Timeout Interval time) and Blast (SPS sends LRQs in parallel before detecting any response).
|
RASLRQWindow
|
Maximum time (in milliseconds) to wait for responses from the gatekeepers contacted.
|
Default is 3000. The RIP message can override this value.
|
RASTimeToLive
|
TTL (TimeToLive) value (in hops) in the RAS LRQ nonstandard message body.
|
Default is 6
|
RASAllowTranslation
|
Sets the can Map Alias field in the LRQ message.
|
On—Set to True. The gatekeeper replaces the dialed phone number or destinationInfo field.
Off—Set to False. The gatekeeper does not replace address information.
If the gatekeeper replaces address information and the value of the canMapAlias field is False, the gatekeeper rejects the LRQ.
|
RASGateKeeperCluster
|
Sets priorities for gatekeeper clusters so that Cisco SPS can query clusters in priority order. For each gatekeeper, you must specify the IP address and port number.
Example
The following example sets up two clusters, each containing two gatekeepers that use port 1719. Priority values are 1 and 2 respectively.
RASGatekeeper
gatekeeper1.company.com 1719
RASGatekeeper
gatekeeper2.company.com 1719
RASGatekeeper
gatekeeper3.company.com 1719
RASGatekeeper
gatekeeper4.company.com 1719
|
1 to 65535.
|
RASGateKeeper
|
IP address (or FQDN) and port number of each individual gatekeeper in a gatekeeper cluster.
|
Maximum number of gatekeepers in a cluster is 5.
|
RASDefaultTechPrefixAction
|
Default action to take to an outgoing INVITE request or 302 message when a technology prefix exists and no specific local rule applies.
|
Strip (remove the prefix) and Include (include the prefix).
|
RASTechPrefix
|
Technology prefix to use when the dialed number matches the specified number pattern.
Example
RASTechPrefix 1919321... 001#
INCLUDE
RASTechPrefix 1919456... 002# STRIP
|
—
|
RASTransportType
|
Transport type to use in the route entry that Cisco SPS learns from a gatekeeper via RAS.
|
TCP, TLS, and UDP. Default is UDP.
|
DebugFlagRasAPI
|
Logs RasAPI debug messages to <ServerRoot>/logs/error_log. These messages explain how Cisco SPS handles incoming and outgoing RasAPI messages that concern RAS encoding/decoding and sending/receiving.
|
On and Off. Default is Off.
|
DebugFlagRAS
|
Logs RAS debug messages to <ServerRoot>/logs/error_log. These messages explain how Cisco SPS handles incoming and outgoing RAS messages that concern module-specific tasks such as module configuration, socket creation, message conversion, and routes insertion.
|
On and Off. Default is Off.
|
