CSCF Peer Server Monitoring Configuration Mode Commands

The CSCF Peer Server Monitoring Configuration Mode is used to configure an individual peer server’s monitoring parameters and operational mode. It also associates a network session template with the server.


Mode:

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

configure > context context_name > cscf peer-servers server_name type { bgcf | ibcf | icscf | mgcf | mrcf | pcscf | scscf | sip-as } > server server_name { address ip_address | domain domain_name )

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-server_name-peer-server)#

IMPORTANT:

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

dummy-as

Sets a response code for Dummy-AS peer server.

Product:

SCM (S-CSCF)


Privilege:

Administrator


Mode:

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

configure > context context_name > cscf peer-servers server_name type { bgcf | ibcf | icscf | mgcf | mrcf | pcscf | scscf | sip-as } > server server_name { address ip_address | domain domain_name )

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-server_name-peer-server)#

Syntax
dummy-as custom-response-code SIP_response_codedefault dummy-as custom-response-code
custom-response-code SIP_response_code

If the peer server is configured as dummy-as and it is chosen as per routing table configured, a UMM response message will be formed with the response code configured and sent as reply to incoming MESSAGE/PUBLISH requests.

SIP_response_code must be an integer from 200 to 699.

IMPORTANT:

The response code can be 2xx/4xx/5xx/6xx; 3xx,401,and 407 are not allowed.

default dummy-as custom-response-code

Sets the response code to 200.


Usage:

Use this command to configure a response code for Dummy-AS. If this mode is selected, then MESSAGE/PUBLISH requests will be responded to by S-CSCF with configured response code.


Example:
The following command configures AS as Dummy-AS with a corresponding response code of 425:
dummy-as custom-response-code 425
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.

ims-capable

Indicates whether the peer server belongs to a 3GPP/IMS network or a non-IMS network such as the Internet. This command is used to determine at the S-CSCF whether SIP signaling inter-working is needed when the calls are forwarded to external networks.

Product:

SCM (S-CSCF)


Privilege:

Administrator


Mode:

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

configure > context context_name > cscf peer-servers server_name type { bgcf | ibcf | icscf | mgcf | mrcf | pcscf | scscf | sip-as } > server server_name { address ip_address | domain domain_name )

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-server_name-peer-server)#

Syntax
[ no ] ims-capable
no

Removes the identification of “IMS capable” from the selected peer server.


Usage:

Use this command to identify a peer server as IMS capable allowing the S-CSCF to use SIP signalling inter-working when forwarding calls to non-IMS capable networks.

lro-selection-profile

Binds a CSCF last route profile with the peer server.

Product:

SCM


Privilege:

Administrator


Mode:

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

configure > context context_name > cscf peer-servers server_name type { bgcf | ibcf | icscf | mgcf | mrcf | pcscf | scscf | sip-as } > server server_name { address ip_address | domain domain_name )

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-server_name-peer-server)#

Syntax
lro-selection-profile
name profile_nameno lro-selection-profile
lro-selection-profile name profile_name

profile_name must be an existing CSCF last route profile and be from 1 to 79 alpha and/or numeric characters.

no lro-selection-profile

Removes CSCF last route profile from the peer server group.


Usage:

Use this command to identify a CSCF last route profile to use for finding the correct Public Safety Answering Point (PSAP) during emergency calls.


Example:
The following command assigns a CSCF last route profile named lro1 to the peer server group:
lro-selection-profile
name lro1
The following command removes a CSCF last route profile from the peer server group:
no lro-selection-profile 
mode

Sets the peer server mode to either active or standby. By default, peer servers are in active mode.

Product:

SCM


Privilege:

Administrator


Mode:

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

configure > context context_name > cscf peer-servers server_name type { bgcf | ibcf | icscf | mgcf | mrcf | pcscf | scscf | sip-as } > server server_name { address ip_address | domain domain_name )

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-server_name-peer-server)#

Syntax
mode { active | standby }
active

Defines the mode of the CSCF peer server as active.

standby

Defines the mode of the CSCF peer server as standby.


Usage:

Use this command to set the peer server mode to either active or standby.


Example:
The following command sets the peer server’s mode to standby:
mode standby
monitor-status

Sets parameters for monitoring the status of peer servers.

Product:

SCM


Privilege:

Administrator


Mode:

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

configure > context context_name > cscf peer-servers server_name type { bgcf | ibcf | icscf | mgcf | mrcf | pcscf | scscf | sip-as } > server server_name { address ip_address | domain domain_name )

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-server_name-peer-server)#

Syntax
monitor-status { max-response-codes
negative max | [ monitor-interval seconds ] [ monitor-message
options [ max-forwards max | response-timer seconds ] ] [ monitor-response-timer seconds ] | response-code { positive SIP_response_code | negative SIP_response_code } | timer [ mark-out-of-service seconds ] [ unavailable-monitor-interval seconds ] [ unavailable-notification seconds ] }no monitor-status { monitor | response-code [ negative | positive ] [ SIP_response_code ] }
max-response-codes negative max

Default: 1

Specifies the maximum number of negative response codes to receive to mark server unavailable.

max must be an integer from 1 to 10.

monitor-interval seconds

Default: 30

Specifies the interval that peer server monitoring will occur.

seconds must be an integer from 1 to 65535.

monitor-message options [ max-forwards max | response-timer seconds ]

Specifies that SIP message (OPTIONS) are to be sent periodically after each monitoring interval.

max-forwards max: Max-forwards in number of hops. max must be an integer from 0 to 70.

response-timer seconds: Response wait timer in seconds. seconds must be an integer from 1 to 65535.

monitor-response-timer seconds

Default: 180

Specifies the interval that the CSCF will wait for responses from the peer server.

seconds must be an integer from 1 to 65535.

response-code { positive SIP_response_code | negative SIP_response_code }

Specifies the Options Message response codes.

negative: Negative response codes. SIP_response_code must be an integer from 300 to 699.

positive: Positive response codes. SIP_response_code must be an integer from 200 to 299.

timer mark-out-of-service seconds

Default: 864000

Timer to mark server out-of-service from unavailable state.

seconds must be an integer from 0 to 2147483646.

timer unavailable-monitor-interval seconds

Periodic monitor interval to be used when server is marked as unavailable.

seconds must be an integer from 0 to 2147483646.

timer unavailable-notification seconds

Default: 180

Time after which to send notification to operations administrator.

seconds must be an integer from 0 to 2147483646.

no monitor-status { monitor | response-code [ negative | positive ] [ SIP_response_code ] }

Disables peering server status monitoring.


Usage:

Use this command to set parameters for monitoring the status of a peer server.


Example:
The following command sets the monitoring interval to three minutes (180 seconds) and the response timer to six minutes (360 seconds):
monitor-status monitor-interval
180 monitor-response-timer 360
nw-session-template

Specifies a session template for sessions terminating from the peer server group.

Product:

SCM


Privilege:

Administrator


Mode:

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

configure > context context_name > cscf peer-servers server_name type { bgcf | ibcf | icscf | mgcf | mrcf | pcscf | scscf | sip-as } > server server_name { address ip_address | domain domain_name )

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-server_name-peer-server)#

Syntax
nw-session-template
name template_nameno nw-session-template
name template_name

template_name must be an existing session template created in the Session Template Configuration Mode.

no

Removes session template from the peer server group.


Usage:

Use this command to identify a session template to use for sessions terminating from the peer server group.


Example:
The following command identifies a session template named template-25 to use for sessions terminating from the peer server group:
nw-session-template template-25
registration

This command specifies whether the S-CSCF skips third party registration to the Application Server (AS) by a configured time after initial registration.

Product:

SCM (S-CSCF)


Privilege:

Administrator


Mode:

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

configure > context context_name > cscf peer-servers server_name type { bgcf | ibcf | icscf | mgcf | mrcf | pcscf | scscf | sip-as } > server server_name { address ip_address | domain domain_name )

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-server_name-peer-server)#

Syntax
registration skip-count countno registration skip-count
skip-count count

Number of times to skip third party registration.

count must be an integer from 0 (default) to 60.

no registration skip-count

The S-CSCF does not skip third party registration to the AS by a configured time after initial registration.


Usage:

Use this command to specify whether the S-CSCF skips third party registration to the Application Server (AS) by a configured time after initial registration. After skipping the configured number of times, the third party register should be sent again to AS to reduce overload on AS.


Example:
The following command sets the number of times to skip third party registration to 25:
registration skip-count 25
tps-rate

Controls the rate of messages based on Transactions Per Second (TPS) from S-CSCF towards the peer server application server (AS).

Product:

SCM (S-CSCF)


Privilege:

Administrator


Mode:

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

configure > context context_name > cscf peer-servers server_name type { bgcf | ibcf | icscf | mgcf | mrcf | pcscf | scscf | sip-as } > server server_name { address ip_address | domain domain_name )

Entering the above command sequence results in the following prompt:

[context_name]host_name(config-server_name-peer-server)#

Syntax
tps-rate rate [ exclude
Register ] no tps-rate
rate

TPS from S-CSCF towards the peer server AS.

rate must be an integer from 1 to 1000.

exclude Register

Specifies that for Register method, TPS rate need not be applied.

no

TPS rate not applied from S-CSCF towards the peer server AS.


Usage:

Use this command to control the TPS towards the peer server AS. If TPS rate is exceeded, the incoming requests will be rejected with 500 error response; Retry-After Header specifies the number of seconds before UE should retry.


Example:
The following command sets the TPS rate towards the AS to 25:
tps-rate 25