Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The persistent settings stream is a config file that is automatically created in the cluster when you edit one of the parameters on a node's admin console (log settings, log host, FVR suspend, etc) or after the first reboot is completed.  When a settings change is made on a running node, the persistent settings stream is created if it doesn't already exist, and then a message is broadcast to the rest of the nodes telling them the new settings and persistent settings stream UUID.

The purpose of this stream is to provide a mechanism to configure certain settings on all nodes in the cluster at once, and to provide those same settings to any new nodes entering the cluster.  If a persistent settings stream is known to the cluster, any new node coming online will be told about it by a process called the town crier and the new node will pick up those settings as well.  As Swarm code has evolved, more and more settings that were previously in the cluster.cfg/ node.cfg only configurable via a configuration file have been placed here.  That in this stream within the cluster.  This allows for dynamic settings changes without requiring a reboot.

...