CSCF Peer Servers Configuration Mode Commands

The CSCF Peer Servers Configuration Mode is used to configure peer servers (for next-hop session routes) within the system.


Mode:

Exec > Global Configuration > Context Configuration > CSCF Peer Servers Configuration

configure > context context_name > cscf peer-servers server_name type { bgcf | ibcf | icscf | mgcf | mrcf | pcscf | scscf | sip-as }

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-cscf-peer-servers-group)#

IMPORTANT:

The commands or keywords/variables that are available are dependent on platform type, product version, and installed license(s).

end

Exits the current configuration mode and returns to the Exec mode.

Product:

All


Privilege:

Security Administrator, Administrator


Syntax
end

Usage:

Use this command to return to the Exec mode.

exit

Exits the current mode and returns to the parent configuration mode.

Product:

All


Privilege:

Security Administrator, Administrator


Syntax
exit

Usage:

Use this command to return to the parent configuration mode.

hunting-method

Configures the method by which server is contacted.

Product:

SCM


Privilege:

Administrator


Mode:

Exec > Global Configuration > Context Configuration > CSCF Peer Servers Configuration

configure > context context_name > cscf peer-servers server_name type { bgcf | ibcf | icscf | mgcf | mrcf | pcscf | scscf | sip-as }

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-cscf-peer-servers-group)#

Syntax
hunting-method { round-robin | sequence-on-failure | weighed }default hunting-method
default

Specifies that the server will be used in round-robin fashion.

round-robin | sequence-on-failure | weighed

Specifies the hunting method for the server.

round-robin: Specifies that the server will be used in round-robin fashion. This is the default setting.

sequence-on-failure: Specifies that the server will be used sequentially if a failure occurs on a server (i.e., first peer server is always used, except on failure, during which next peer server in the list will be used).

weighed: Specifies that the peer server has a set “weight” that determines use as compared to the other like-configured peer servers. The actual weight of the peer server is configured in the server command in this mode.


Usage:

Use this command to configure the method that is used by the system to connect to the peer server.


Example:
The following command sets the hunting method for a server to contact sequentially only when a server fails:
hunting-method sequence-on-failure
server

Configures the name, IP address, and port of servers belonging to this peer server and enters the Server Configuration Mode.

Product:

SCM


Privilege:

Administrator


Mode:

Exec > Global Configuration > Context Configuration > CSCF Peer Servers Configuration

configure > context context_name > cscf peer-servers server_name type { bgcf | ibcf | icscf | mgcf | mrcf | pcscf | scscf | sip-as }

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-cscf-peer-servers-group)#

Syntax
server name { address ip_address | domain domain_name } [ port number ] [ transport { tcp | udp } ] [ weight number ]no server name
no

Removes the specified server from the group.

name

Specifies a name for the server. name must be from 1 to 79 alpha and/or numeric characters in length.

address ip_address

Specifies the IP address of the server. ip_address is expressed in dotted decimal notation for IPv4 or colon notation for IPv6.

domain domain_name

Specifies the domain name of the peer server. domain_name must be from 1 to 255 alpha and/or numeric characters in length.

port number

Specifies the port number of the server.

number must be an integer value from 1 to 65535.

transport { tcp | udp }

Specifies the transport type (TCP or UDP).

weight number

Default: 5

Specifies a weighted number for the specific peer server for load balancing purposes. number must be an integer value from 1 to 10. Higher weight implies larger server capability (and more routed requests).

IMPORTANT:

This keyword is only valid if the weighed keyword is applied to the hunting-method command in this mode.


Usage:

Use this command to configure servers and enter the Server Configuration Mode.

Entering this command results in the following prompt:
[context_name]hostname(config-server_name-peer-server)#

Server Configuration Mode commands are defined in the CSCF Peer Server Monitoring Configuration Mode Commands chapter.


Example:
The following command configures a server named scscf5 with an IP address of 1.2.3.4 and a port number of 5060:
server scscf5 address
1.2.3.4 port 5060