CLI Command Reference for Cisco Unified SIP Proxy Release 10.1

Bias-Free Language

The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.

Book Contents
Find Matches in This Book
Available Languages
Download Options

Book Title

CLI Command Reference for Cisco Unified SIP Proxy Release 10.1

Chapter Title

Cisco Unified SIP Proxy Radius Server Commands

Results

Updated:
November 25, 2019

Chapter: Cisco Unified SIP Proxy Radius Server Commands

Cisco Unified SIP Proxy Radius Server Commands

Last Updated: November 25, 2019

server-group radius group

To configure a RADIUS server group and enter RADIUS server group configuration mode, use the server-group radius group command in Cisco Unified SIP Proxy configuration mode. To remove the RADIUS server group, use the no form of this command.

server-group radius group radius_server local-ipaddress

no server-group radius group radius_server local-ipaddress

 
Syntax Description

radius_server

Specifies one RADIUS server group name.

local-ipaddress

Specifies the local source IP address to use when the proxy server sends RADIUS messages to the RADIUS server. The local IP address cannot be modified after the group is configured.

 
Command Default

None

 
Command Modes

Cisco Unified SIP Proxy configuration (cusp-config)

 
Command History

Cisco Unified SIP Proxy Version
Modification

1.0

This command was introduced.

 
Usage Guidelines

This command creates a RADIUS server group. The server can load balance accounting messages over the configured RADIUS servers. All accounting messages with the same Acct-Session-ID will go to the same RADIUS server.

note.gif

Noteblank.gif You can configure only one RADIUS server group in Cisco Unified SIP Proxy 1.0.

Examples

The following example creates a RADIUS server group:

se-10-1-0-0(cusp-config)> server-group radius group radius_server 192.168.20.42
se-10-1-0-0(cusp-config-radius)>
 

The following example removes a RADIUS server group and removes all server-group elements in it:

se-10-1-0-0(cusp-config)> no server-group radius group radius_server 192.168.20.42

 
Related Commands

Command
Description

element ip-address (RADIUS server group)

Creates an IP element for a RADIUS server group and determines its characteristics.

retransmit-timeout (RADIUS server group)

Configures the retransmit timeout value for the RADIUS server group.

show status server-group radius

Displays the status of all RADIUS server groups or a single RADIUS server group.

element ip-address (RADIUS server group)

To create an IP element for a RADIUS server group and determine its characteristics, use the element ip-address command in RADIUS server group configuration mode. To remove the IP element from the RADIUS server group, use the no form of this command.

element ip-address ip-address port shared-secret [ q-value q-value ]

no element ip-address ip-address port

 
Syntax Description

ip-address

Specifies the interface host name or IP address of the server group element.

port

Specifies the port used by the server group element. Valid values are from 1024 to 65535. The default port is 1813 for accounting and 1812 for authentication/authorization.

shared secret

Specifies the shared secret key between the proxy and the RADIUS server group element.

q-value q-value

(Optional) Specifies a real number that specifies the priority of the server group element relative to others in the server group. Valid values are from 0.0 to 1.0. The default is 1.0.

 
Command Default

The element for the RADIUS server group is not configured.

 
Command Modes

RADIUS server group configuration (cusp-config-radius)

 
Command History

Cisco Unified SIP Proxy Version
Modification

1.0

This command was introduced.

Examples

The following example creates an IP element for a RADIUS server group:

se-10-1-0-0(cusp-config)> server-group radius group acct-group
se-10-1-0-0(cusp-config-radius)> element ip-address 10.1.2.3 1813 cusp-secret
 

The following example removes an IP element from a RADIUS server group:

se-10-1-0-0(cusp-config)> server-group radius group acct-group
se-10-1-0-0(cusp-config-radius)> no element ip-address 10.1.2.3 1813

 
Related Commands

Command
Description

retransmit-count (RADIUS server group)

Configures the retransmit count value for the RADIUS server group.

retransmit-timeout (RADIUS server group)

Configures the retransmit timeout value for the RADIUS server group.

server-group radius group

Configures a RADIUS server group and enters server group RADIUS configuration mode.

retransmit-count (RADIUS server goup)

To configure the retransmit count value for a RADIUS server group, use the retransmit-count command in Cisco Unified SIP Proxy RADIUS server group configuration mode. To restore the default value, use the no form of this command.

retransmit-count count

no retransmit-count

 
Syntax Description

count

Specifies the allowable number of retries of a RADIUS request to a RADIUS server. If no successful response is obtained from the RADIUS server after the maximum number of retries, the RADIUS server is marked as being out-of-service. The default value is 3.

 
Command Default

Three retries

 
Command Modes

Cisco Unified SIP Proxy RADIUS server group configuration (cusp-config-radius)

 
Command History

Cisco Unified SIP Proxy Version
Modification

1.0

This command was introduced.

Examples

The following example configures the retransmit-count value to 5:

se-10-1-0-0(cusp-config)> server-group radius group acct-group 192.168.20.42
se-10-1-0-0(cusp-config-radius)> retransmit-count 5
 

The following example restores the default retransmit-count value:

se-10-1-0-0(cusp-config)> server-group radius group acct-group 192.168.20.42
se-10-1-0-0(cusp-config-radius)> no retransmit-count

 
Related Commands

Command
Description

element ip-address (RADIUS server group)

Creates an IP element for a RADIUS server group and determines its characteristics.

retransmit-timeout(RADIUS server group)

Configures the retransmit timeout value for a RADIUS server group.

server-group radius group

Configures a RADIUS server group and enters server group RADIUS configuration mode.

retransmit-timeout (RADIUS server group)

To configure the retransmit timeout value for a RADIUS server group, use the retransmit-time command in Cisco Unified SIP Proxy RADIUS server group configuration mode. To restore the default retransmit timeout value, use the no or default form of this command.

retransmit-timeout timeout

no retransmit-timeout

 
Syntax Description

timeout

Specifies the maximum number of milliseconds allowed to wait for a response from a RADIUS server. If no response is received, the server will retry the request up to the retransmit-count value before it determines that the server is not available. The default value is 500.

 
Command Default

500 milliseconds

 
Command Modes

Cisco Unified SIP Proxy RADIUS server group configuration (cusp-config-radius)

 
Command History

Cisco Unified SIP Proxy Version
Modification

1.0

This command was introduced.

Examples

The following example configures the retransmit-timeout value to 1000:

se-10-1-0-0(cusp-config)> server-group radius group acct-group 192.168.20.42
se-10-1-0-0(cusp-config-radius)> retransmit-timeout 1000
 

The following example restores the default retransmit-timeout value:

se-10-1-0-0(cusp-config)> server-group radius group acct-group 192.168.20.42
se-10-1-0-0(cusp-config-radius)> no retransmit-timeout

 
Related Commands

Command
Description

element ip-address (RADIUS server group)

Creates an IP element for a RADIUS server group and determines its characteristics.

retransmit-count (RADIUS server group)

Configures the retransmit count value for a RADIUS server group.

server-group radius group

Configures a RADIUS server group and enters server group RADIUS configuration mode.

show status server-group radius

To display the status of all RADIUS server groups or a single RADIUS server group, use the show status server-group radius command in Cisco Unified SIP Proxy EXEC mode.

show status server-group radius [ server-group-name ]

 
Syntax Description

server-group-name

(Optional) Displays the status of a single RADIUS server group.

 
Command Modes

Cisco Unified SIP Proxy EXEC (cusp)

 
Command History

Cisco Unified SIP Proxy Version
Modification

1.0

This command was introduced.

Examples

The following example shows sample output from the show status server-group radius command:

se-10.0.0.0(cusp)> show status server-group radius rgl
 
Servergroup: radius_server
Address Secret Q-Value Status
192.168.20.6:1813 cusp-secret 1.0 up
192.168.20.7:1813 cusp-secret 1.0 up
se-192-168-20-42(cusp)>
 

Table 1 describes the significant fields shown in the display.

 

Table 1 show status server-group radius Field Descriptions

Field
Description

Servergroup

Displays the name of the RADIUS server group.

Q-Value

A real number that specifies the priority of the server group element with respect to others in the server group.

Status

Displays the operational status of the RADIUS server group.

 
Related Commands

Command
Description

show status server-group sip

Displays the status of all SIP server groups or a single SIP server group.

Was this Document Helpful?

FeedbackFeedback

Contact Cisco