Persisted Settings (SNMP)

A subset of Swarm configuration settings are persisted settings, which are stored in a Settings object in the cluster if any domains exist or any settings have been modified in the Swarm UI (or legacy Admin Console). These special settings persist across reboots, regardless of how the configuration (node.cfg/cluster.cfg) files are updated.

Important

The Settings object persists and overrides the configuration files, storing both settings and passwords for the cluster. See Defining Swarm Admins, Swarm Users, and Swarm Passwords.

Best Practice

Always change settings using the Swarm UI, rather than through the configuration files.

There are several benefits to this practice:

No reboot required. No need to perform a full reboot for the configuration change to take effect.
Updates persisted settings. The changes are stored directly in the Settings object.
Only update in one place. Only need to update persisted settings on one node: Swarm propagates the changes to all other Settings objects in the cluster.

Important

Swarm supports SNMP version 2 only.

Here is an example SNMP set command that changes the string that is the policy for cluster-wide versioning:

snmpset -m +CARINGO-CASTOR-MIB -v2c -M +/usr/share/snmp/mib2c-data -c{password} -OQs 
	{node} policyVersioning s "allowed"

Here is an example that changes an integer value:

snmpset -m +CARINGO-CASTOR-MIB -v2c -M +/usr/share/snmp/mib2c-data -c{password} -OQs 
	{node} healthExamDelay i 30

Listed below are the special Swarm settings with SNMP names, as well as whether they are persisted and writable. All are configurable using the Swarm UI.

Name	Writable	Scope	Persisted	SNMP Name

Name	Writable	Scope	Persisted	SNMP Name
bidding.relocationThreshold	Yes	cluster	Yes	relocationThreshold
cip.group		cluster		group
cip.queryRetryMultiplier	Yes	cluster	Yes	queryRetryMultiplier
cluster.enforceTenancy	Yes	cluster		enforceTenancy
cluster.name		cluster		cluster
console.messageExpirationSeconds	Yes	cluster	Yes	messageExpirationSeconds
disk.atimeEnabled	Yes	cluster	Yes	accessedTimeEnabled
disk.atimeGranularity	Yes	cluster	Yes	accessedTimeGranularity
disk.volumes		node		vols
ec.conversionPercentage	Yes	cluster	Yes	ecConversionPercentage
ec.convertToPolicy	Yes	cluster	Yes	ecConvertToPolicy
ec.convertVersionedObjects	Yes	cluster	Yes	ecConvertVersionedObjects
ec.protectionLevel	Yes	cluster	Yes	ecProtectionLevel
ec.segmentConsolidationFrequency	Yes	cluster	Yes	ecSegmentConsolidationFrequency
health.defragInterval	Yes	cluster	Yes	healthDefragInterval
health.examDelay	Yes	cluster	Yes	healthExamDelay
health.offloadPauseInterval	Yes	cluster	Yes	healthOffloadPauseInterval
health.relocationVolumeFillRate	Yes	cluster	Yes	hpRelocationVolumeFillRate
health.replicationMulticastFrequency	Yes	cluster	Yes	repMulticastFrequency
health.replicationUnicastFrequency	Yes	cluster	Yes	repUnicastFrequency
health.startDelay		node		hpStartDelay
index.optimize404	Yes	cluster	Yes	overlayOptimize404
index.overlayEnabled	Yes	cluster	Yes	overlayIndexEnabled
index.ovMinNodes	Yes	cluster	Yes	<