Upgrade considerations - SNMP configuration

March 9, 2020

Contributed by: S

The timeout parameter for an SNMP alarm is an internal option that has no impact on the alarm configuration.

Timeout parameter might appear in the SNMP alarm configurations in the running configuration (sh running) and the saved configuration (ns.conf) even if you have not made any changes to these SNMP alarm configurations.

On upgrading to a release build with the fix for the timeout setting issue, the SNMP configurations are erroneously reset to default values.

The following SNMP alarms (if configured) are impacted during an upgrade:

APPFW-BUFFER-OVERFLOW
APPFW-COOKIE
APPFW-CSRF-TAG
APPFW-DENY-URL
APPFW-FIELD-CONSISTENCY
APPFW-FIELD-FORMAT
APPFW-POLICY-HIT
APPFW-REFERER-HEADER
APPFW-SAFE-COMMERCE
APPFW-SAFE-OBJECT
APPFW-SQL
APPFW-START-URL
APPFW-VIOLATIONS-TYPE
APPFW-XML-ATTACHMENT
APPFW-XML-DOS
APPFW-XML-SCHEMA-COMPILE
APPFW-XML-SOAP-FAULT
APPFW-XML-SQL
APPFW-XML-VALIDATION
APPFW-XML-WSI
APPFW-XML-XSS
APPFW-XSS
CLUSTER-BACKPLANE-HB-MISSING
CLUSTER-NODE-HEALTH
CLUSTER-NODE-QUORUM
CLUSTER-VERSION-MISMATCH
COMPACT-FLASH-ERRORS
CONFIG-CHANGE
CONFIG-SAVE
HA-BAD-SECONDARY-STATE
HA-NO-HEARTBEATS
HA-SYNC-FAILURE
HA-VERSION-MISMATCH
HARD-DISK-DRIVE-ERRORS
HA-STATE-CHANGE
HA-STICKY-PRIMARY
PORT-ALLOC-FAILED
SYNFLOOD

These SNMP alarms configurations are impacted when you upgrade the Citrix ADC (NetScaler) appliance to the following release builds:

Release 11.1 build 61.2 or later
Release 12.0 build 61.0 or later
Release 12.1 build 30.1 or later
Release 13.0 build 51.4 or later

Example

Let’s consider an example of CLUSTER-NODE-HEALTH SNMP alarm.

CLUSTER-NODE-HEALTH SNMP alarm is set up by using the Citrix ADC (NetScaler) command line:

> set snmp alarm CLUSTER-NODE-HEALTH -time 111 -state DISABLED -severity Major

> save config

This SNMP alarm configuration appears in the saved configuration file (ns.conf) as:

set snmp alarm CLUSTER-NODE-HEALTH -time 111 -state DISABLED -severity Major -timeout 86400

During an upgrade to any of the release builds mentioned above, the following error appears in ns.log file:

May 23 09:14:46 <local0.err> ns nsconfigd: __init_config_filter(): (null) line 0: No such argument [-timeout]>> set snmp alarm CLUSTER-NODE-HEALTH -time 111 -state DISABLED -severity Major -timeout 86400.

After the upgrade, the SNMP alarm configurations are reset to the default values.

Workaround

Use one of the following workarounds:

Before the upgrade, remove the timeout setting from the SNMP configurations in the saved configuration file (ns.conf).
After the upgrade, reconfigure the SNMP alarms without the timeout parameter.

The official version of this content is in English. Some of the Citrix documentation content is machine translated for your convenience only. Citrix has no control over machine-translated content, which may contain errors, inaccuracies or unsuitable language. No warranty of any kind, either expressed or implied, is made as to the accuracy, reliability, suitability, or correctness of any translations made from the English original into any other language, or that your Citrix product or service conforms to any machine translated content, and any warranty provided under the applicable end user license agreement or terms of service, or any other agreement with Citrix, that the product or service conforms with any documentation shall not apply to the extent that such documentation has been machine translated. Citrix will not be held responsible for any damage or issues that may arise from using machine-translated content.

Upgrade considerations - SNMP configuration

March 9, 2020

Contributed by: S

Upgrade considerations - SNMP configuration

Example

Workaround

Upgrade considerations - SNMP configuration

In this article