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	overlayMinNodes
log.host	Yes	cluster	Yes	logHost
log.level	Yes	cluster	Yes	logLevel
log.port	Yes	cluster	Yes	logPort
metrics.nodeExporterFrequency	Yes	cluster	Yes	metricsExporterFrequency
metrics.period	Yes	cluster	Yes	metricsPeriod
metrics.port	Yes	cluster	Yes	metricsTargetPort
metrics.target	Yes	cluster	Yes	metricsTargetHost
network.gateway		node		gateway
network.igmpTimeout	Yes	cluster	Yes	networkIGMPTimeout
network.ipAddress		node		ipaddress
network.netmask		node		netmask
network.timeSource		node		timeSource
node.archiveMode	Yes	node		archiveMode
node.subcluster	Yes	node		subcluster
policy.eCEncoding	Yes	cluster	Yes	policyECEncoding
policy.eCMinStreamSize	Yes	cluster	Yes	policyECMinStreamSize
policy.lifecycle	Yes	cluster	Yes	policyLifecycle
policy.replicas	Yes	cluster	Yes	policyReplicas
policy.versioning	Yes	cluster	Yes	policyVersioning
power.savingMode	Yes	cluster	Yes	powerSavingMode
power.sleepAfter	Yes	cluster	Yes	sleepAfter
power.wakeAfter	Yes	cluster	Yes	wakeAfter
recovery.completedRecoveryExpiration	Yes	cluster	Yes	completedRecoveryExpiration
recovery.suspend	Yes	cluster	Yes	volumeRecoverySuspend
recovery.suspendedVolumes	Yes	cluster	Yes	castorAddVolumeRecoverySuspend, castorRemoveVolumeRecoverySuspend
recovery.volMaintenanceInterval	Yes	cluster	Yes	volMaintenanceInterval
scsp.allowPutCreate	Yes	cluster	Yes	allowPutCreate
scsp.autoContentMD5Computation	Yes	cluster	Yes	autoContentMD5Computation
scsp.autoRecursiveDelete	Yes	cluster	Yes	autoRecursiveDelete
scsp.filterResponseBlacklist	Yes	cluster	Yes	filterResponseBlacklist
scsp.filterResponseHeaders	Yes	cluster	Yes	filterResponseHeaders
scsp.filterResponseWhitelist	Yes	cluster	Yes	filterResponseWhitelist
scsp.keepAliveInterval	Yes	cluster	Yes	keepAliveInterval
scsp.maxContextReplicas	Yes	cluster	Yes	maxcontextreplicas
scsp.port		cluster		scspport
scsp.replicateOnWrite	Yes	cluster	Yes	autoRepOnWrite
scsp.requireExplicitContextCreate	Yes	cluster	Yes	requireExplicitContextCreate
search.enableCustomMetadataTyping	Yes	cluster	Yes	enableCustomMetadataTyping
search.enableDelimiterPaths	Yes	cluster	Yes	enableDelimiterPaths
security.administrators	Yes	cluster	Yes	addModifyAdministrator, removeAdministrator
security.secureLogging	Yes	cluster	Yes	secureLogging
snmp.timeout	Yes	cluster	Yes	snmpTimeout