Add the Swarm Storage Component
Important
SCS requires Swarm 14 or higher version.
Adding the Software
Add the storage software bundle for the cluster.
Important
Use the tarball ending in .TGZ.
The .ZIP and .RPM files are used for Swarm deployments without SCS.
scsctl repo component add -f swarm-scs-storage-<version>.tgzPrompting for Settings
Certain component settings ship without defaults, as these settings are unique to the environment in which Swarm runs. The CLI prompts for the component values while adding the software. If any of these settings are skipped, the CLI prompts again during the finalization of Swarm configuration settings.
disk.encryptNewVolumes
This setting enables encryption at rest. It is recommended to avoid encryption at rest unless specified by DataCore Support team. Contact DataCore Support team for configuration assistance after SCS installation and configuration if use of encryption at rest is desired. Choose Later at the group and/or instance level to skip this step.
disk.volumes
This setting governs which volumes on the chassis Swarm storage will use. Enter all when prompted for the disk.volumes setting’s default value unless instructed by DataCore.
cip.multicastEnabled
Available since: Swarm 15.0
This setting controls the use of multicast for Swarm Storage node intercommunication. The multicast was mandatory before Swarm v15.0. For clusters already using multicast, it is advised to continue using it as changing the setting value requires a full, non-rolling cluster reboot.
Prompting for the Cluster/Group Name
Once the software is added, provide a group name when prompted to define a cluster for Swarm Storage nodes.
Warning
If you are deploying an SCS with an existing storage cluster, this group value MUST be the same as the cluster.name value of the existing storage cluster.
The failure causes an initialization error for the cluster on boot-up (the Persistent Settings Stream stores the cluster.name and does not match the cluster name stored in SCS) and requires resetting and re-initializing the SCS. https://perifery.atlassian.net/wiki/spaces/public/pages/1223491694/SCS+CLI+Commands#scsctl-system-reset
Example:
$> scsctl repo component add -f swarm-scs-storage-15.0.0.tgz
Missing setting: storage/disk.volumes
Missing setting: storage/cip.multicastEnabled
The following setting(s) require a default value:
disk.volumes [type: str] (Required. Specifies the volume storage devices for Swarm to use. Valid entries: all, or a space-separated list of Linux volume identifiers, such as /dev/sda, /dev/sdb. all (recommended) is required for hot plugging and lets Swarm to use all volumes larger than disk.minGB. If a node is shut down longer than disk.obsoleteTimeout, all of its volumes are stale and cannot be used unless you force a volume remount by adding the :k (keep) policy option modifier. To specify the size, add a modifier with units: vols1:100m vols2:250g.):
all
cip.multicastEnabled [type: bool] (Whether or not multicast should be used for communication within Swarm.):
> True
False
added: storage - 15.0.0 (15.0.5)
Please enter a name for the group (FQDN format encouraged) - Required to be able to boot instances of "storage":
a.storage.cluster
Please enter a description for the group (purpose, etc). [OPTIONAL]:
Store it all!
group added
=============================================================================================================================================================================================================================================
Please run the following command to check for missing config in the new group:
> scsctl diagnostics config scan_missing
=============================================================================================================================================================================================================================================
© DataCore Software Corporation. · https://www.datacore.com · All rights reserved.