Command:

radius-server host

Mode:

Router(config)#

Syntax:

radius-server host {hostname | ip-address} [auth-port port-number] [acct-port port-number] [timeout seconds] [retransmit retries] [key string] [alias{hostname | ip-address}]

no radius-server host {hostname | ip-address} [auth-port port-number] [acct-port port-number] [timeout seconds] [retransmit retries] [key string]


Syntax Description:

hostname DNS name of the RADIUS server host.
ip-address IP address of the RADIUS server host.
auth-port (Optional) Specifies the UDP destination port for authentication requests.
port-number (Optional) Port number for authentication requests; the host is not used for authentication if set to 0.
acct-port (Optional) Specifies the UDP destination port for accounting requests.
port-number (Optional) Port number for accounting requests; the host is not used for accounting if set to 0.


Command Description:

To specify a RADIUS server host, use the radius-server host global configuration command. Use the no form of this command to delete the specified RADIUS host.

Usage Guidelines

Use multiple radius-server host commands to specify multiple hosts. The software searches for hosts in the order they are specified.


Example:

The following example specifies host1 as the RADIUS server and uses default ports for both accounting and authentication:

Router(config)#radius-server host host1.domain.com

The following example specifies port 12 as the destination port for authentication requests and port 16 as the destination port for accounting requests on a RADIUS host named host1:

Router(config)#radius-server host host1.domain.com auth-port 12 acct-port 16

Because entering a line resets all the port numbers, you must specify a host and configure accounting and authentication ports on a single line.

To use separate servers for accounting and authentication, use the zero port value as appropriate. The following example specifies that RADIUS server host1 be used for accounting but not for authentication, and that RADIUS server host2 be used for authentication but not for accounting:

Router(config)#radius-server host host1.domain.com auth-port 0
Router(config)#radius-server host host2.domain.com acct-port 0


Misconceptions:

 

None


Related Commands:

 

aaa accounting

 

aaa authentication

 

aaa authorization

 

ppp authentication

 

radius-server key

 

username

 


� Cisco Systems, Inc. 2001, 2002, 2003
World Wide Education

Converted from CHM to HTML with chm2web Pro 2.85 (unicode)