ADC CLI Commands

snmp-manager

The following operations can be performed on “snmp-manager”:

set add rm show unset

set snmp manager

Modifies the Domain Resolve Retry parameter of any host-name based SNMP manager configured on the Citrix ADC.

Synopsis

set snmp manager [-netmask ] [-domainResolveRetry ]

Arguments

IPAddress Host name of the SNMP manager for which you want to modify the Domain Resolve Retry parameter.

netmask Subnet mask associated with an IPv4 network address. If the IP address specifies the address or host name of a specific host, accept the default value of 255.255.255.255. Default value: 0xFFFFFFFF

domainResolveRetry Amount of time, in seconds, for which the Citrix ADC waits before sending another DNS query to resolve the host name of the SNMP manager if the last query failed. This parameter is valid for host-name based SNMP managers only. After a query succeeds, the TTL determines the wait time. The minimum and default value is 5. Minimum value: 5 Maximum value: 20939

Example

set snmp manager www.example.com -domainResolveRetry 7

add snmp manager

Specifies an SNMP manager to query the Citrix ADC. The added manager complies with SNMP V1, V2, and V3. If you specify one or more SNMP managers, the appliance does not accept SNMP queries from any hosts except the specified SNMP managers. You can specify up to a maximum of 100 IP based SNMP managers or networks and a maximum of 5 host-name based SNMP managers.

Synopsis

add snmp manager ... [-netmask ] [-domainResolveRetry ]

Arguments

IPAddress IP address of the SNMP manager. Can be an IPv4 or IPv6 address. You can instead specify an IPv4 network address or IPv6 network prefix if you want the Citrix ADC to respond to SNMP queries from any device on the specified network. Alternatively, instead of an IPv4 address, you can specify a host name that has been assigned to an SNMP manager. If you do so, you must add a DNS name server that resolves the host name of the SNMP manager to its IP address. Note: The Citrix ADC does not support host names for SNMP managers that have IPv6 addresses.

netmask Subnet mask associated with an IPv4 network address. If the IP address specifies the address or host name of a specific host, accept the default value of 255.255.255.255. Default value: 0xFFFFFFFF

domainResolveRetry Amount of time, in seconds, for which the Citrix ADC waits before sending another DNS query to resolve the host name of the SNMP manager if the last query failed. This parameter is valid for host-name based SNMP managers only. After a query succeeds, the TTL determines the wait time. The minimum and default value is 5. Minimum value: 5 Maximum value: 20939

Example

add snmp manager 192.168.1.20 192.168.2.42 add snmp manager 192.168.2.16 -netmask 255.255.255.240 add snmp manager hostnamemanager.com

rm snmp manager

Removes an SNMP manager from the list of managers that are allowed to access the Citrix ADC.

Synopsis

rm snmp manager ... [-netmask ]

Arguments

IPAddress IPv4 or IPv6 address (or IPv4 host name) of the SNMP manager, or the IPv4 network address or IPv6 network prefix of the SNMP managers.

netmask Subnet mask associated with an IPv4 SNMP manager entry. For a specific host, the subnet mask is 255.255.255.255. Default value: 0xFFFFFFFF

Example

rm snmp manager 192.168.1.20 rm snmp manager 192.168.2.16 -netmask 255.255.255.240 rm snmp manager hostnamemanager.com

show snmp manager

Displays configuration information about all SNMP managers on the Citrix ADC, or detailed information about the specified manager.

Synopsis

show snmp manager [ [-netmask ]]

Arguments

IPAddress IPv4 or IPv6 address (or IPv4 host name) of the SNMP manager, or the IPv4 network address or IPv6 network prefix of the SNMP managers, about which to display information.

netmask Subnet mask associated with an IPv4-address based SNMP manager entry. If the IP address specifies a specific host (either the IP address or the host name of the SNMP manager), the subnet mask is 255.255.255.255. Default value: 0

Output

IP The resolved IP address of the hostname manager

domain IP address of manager. It will be zero for hostname manager

domainResolveRetry Amount of time, in seconds, for which the Citrix ADC waits before sending another DNS query to resolve the host name of the SNMP manager if the last query failed. This parameter is valid for host-name based SNMP managers only. After a query succeeds, the TTL determines the wait time. The minimum and default value is 5.

devno count stateflag

Example

show snmp manager

unset snmp manager

Use this command to remove snmp manager settings.Refer to the set snmp manager command for meanings of the arguments.

Synopsis

unset snmp manager -netmask -domainResolveRetry

snmp-manager