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 https://perifery.atlassian.net/wiki/spaces/public/pages/2443811291.
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 30Listed 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 |
|---|---|---|---|---|
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 |
© DataCore Software Corporation. · https://www.datacore.com · All rights reserved.