/
Persisted Settings (SNMP)

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

<