Page Comparison

How to Deploy

To install Swarm Storage, you first enlist Enlist the chassis and then deploy them for management and orchestration to install Swarm Storage. Swarm Platform supports any chassis that is equipped with IPMI 2.0 or newer.

1. Power on each chassis

   that will be

   planned as a Swarm storage node. Each chassis

   will

   PXE

   boot

   boots from the Platform server,

   enlist

   enlists itself with Platform, and

   shut

   shuts itself down.

2. After enlistment completes, list List the chassis that are currently available currently to run Swarm after enlistment completes:

   Code Block
   language bash
   platform list nodes

   The number of chassis returned will be is the value to use in the next step for -n, unless you will be keeping some unless some are kept in reserve.

3. Deploy Swarm Storage to the chassis being managed by Platform:

   Code Block
   language bash
   platform deploy storage -v {#.#.# Version of Swarm Storage} -c {Path to cluster.cfg} -n {# Nodes To Deploy}

4. At this point, the Platform

   will power

   powers on each of the nodes twice. The first power on is commissioning, involving hardware interrogation and other tasks, which ends with a power off. The second power on is to boot Swarm Storage on the chassis.

5. Once Swarm is running, deploy Content Gateway, or, if not using Content Gateway, proceed to Deploying a Proxy.

   Code Block
   language bash
   platform deploy proxy -b {Path to Service Proxy Bundle zip}

Power Control with ESXi 

With a VMware ESXi hypervisor, you may want It may be ideal to use local Storage VMs with a VMware ESXi hypervisor. These VMs will enlist, but their the power type is not detected by MAAS. Therefore, commissioning Commissioning and deployment requires require the "Manual" power type (see next), and requires you to require manually power powering on these VMs (shutdown works).

Using the native VMware power type is possible, but more complex: you must select it through the VMWare UI as well as the MAAS CLI, and you are also required to use a valid (not self-signed) SSL certificate on the hypervisor. 

...

When a chassis is powered on for the first time, the Platform Server auto-detects which power mechanism to use when processing them for deployment. However, if a chassis has IPMI for power control of the chassis but you need Platform server to ignore IPMI, you must switch Switch the deployment to manual power control (add the --manual flag to the platform deploy command) and then manually power on machines at the right time as they go through the lifecycle if a chassis has IPMI for power control of the chassis but requires Platform server to ignore IPMI.

When using manual power control, you need to use CLI commands to know when to power on each chassis, so use the -y <system-id> flag, rather than -n <# of nodes>.

1. Run the deploy command for an individual chassis, using the  --manual

   flag

   and

   the

   -y <system-id>

   flag

   flags.

2. To Use the --state Commissioning flag to know when to turn the chassis on, use the --state Commissioning flag:.

   Code Block
   language bash
   platform list nodes --state Commissioning

3. As

   Power on the chassis as soon as the chassis appears in the list

   , you can power on the chassis

   .

4. After you power on the chassis, it will go through commissioning and then power

   The chassis goes through commissioning after being powered on and then powers itself off.

5. To Use the --state Deploying flag to know when to power on the chassis for the final time (to deploy the Storage software), use the --state Deploying flag:

   Code Block
   language bash
   platform list nodes --state Deploying

6. As

   Power on the chassis for the final time as soon as the chassis appears in the list

   , you can power on the chassis for the final time

   .

platform list nodes -y <system-id> --short

Changing Network Bonding Mode

By default, the The Platform server will boot boots all Storage chassis using the "balance-alb" bonding mode . You can modify the by default. The default bonding mode to use used can be modified for future deployments by using the following command:

platform add bonding-mode --default-bonding-mode "<bonding-mode-to-use>"

Use a mode for the Linux bonding driver that is tested and supported for Swarm:

To Override the default value by using the --bondingMode flag to use a different bonding mode when deploying an individual chassis, override the default value by using the --bondingMode flag:

platform deploy storage -v <#.#.# Version of Swarm Storage> -c <Path to cluster.cfg> -y <system-id> --bondingMode "<bonding-mode-to-use>"

To Run the add kernelparam command to modify the bonding mode for a chassis that's already deployed, run the add kernelparam command:

platform add kernelparam -y <system-id> --kernel_params "castor_net=<bonding_mode>"

After Restart the chassis after the command completes, restart the chassis.

Configuring Subclusters

After Assign chassis to subclusters after all the chassis have been are deployed and are running, you can assign chassis to subclusters.To .

Use the assign command to assign a chassis to a subcluster, use the assign command:

Add to subcluster

platform subcluster assign -y <system-id> --subcluster <subcluster-name>

To Use the list command to review the subcluster assignments, use the list command:

List subclusters

platform subcluster list