Stopping and Starting the HyperScale X Appliance Cluster

You can stop and restart a HyperScale X Appliance cluster.

Caution

To maintain data integrity and to prevent data loss, it is important to follow the proper shut down and startup procedures outlined in this page, while stopping or starting the cluster.

If a single node needs to be shutdown for maintenance, follow the steps outlined in Stopping and Starting a Node.
If more than one node needs to be shutdown, make sure to shutdown the entire cluster as described in this page.
Improper shutdown of multiple nodes individually can lead to data integrity issues resulting in data loss and restore failures.

Stopping the Cluster

Stop or suspend all running jobs associated with the MediaAgents in the cluster . For more information, see Controlling Jobs.
Set the MediaAgents on maintenance mode. For more information, see Setting the MediaAgent on Maintenance Mode.
Stop the Commvault services and unmount the Commvault Distributed Storage (CDS) vdisk on all the nodes in the cluster:
1. Using an SSH client program, like PuTTy on Windows, login to one of the nodes using the root credentials.
2. Get the <vdiskname> using the following command:
  
  <vdiskname> is the name sub-folder under /ws/hedvig.
```
 
# df -h
```
  See the following example:
```
 
127.0.0.1:/exports/CVLTBackupSMC43002153  269T -1.5T  271T   0% /ws/hedvig/CVLTBackupSMC43002153
127.0.0.1:/exports/CVLTBackupSMC43002153  269T -1.5T  271T   0% /ws/hedvig/CVLTBackupSMC43002153-r
```
3. Stop the services using the following command:
```
# commvault stop
```
4. To verify that vdisk is unmounted, execute the mount command. The output should not display <vdiskname> in the output.
5. Repeat the steps on the other nodes in the cluster.
Start the hv_deploy mode using the following commands:
```
# su - admin
# export HV_PUBKEY=1
# hv_deploy
```

Display the cluster name and note down the name.

# show_all_clusters

This will display the cluster name, as shown in the following sample output:

Cluster name: HV13102021054000 - owner: unowned - version: v-4.5.0.0.2.3597.00320e0ba9:06aca75bc4db06170a13ef14cbfe8446

# login_to_cluster <cluster name>

For example:

# login_to_cluster HV13102021054000

When prompted, type the root password.

Stop the cluster.
```
# stop_cluster
```
Exit the the hv_deploy mode.
```
# exit
```
Exit the admin user mode.
```
# exit
```

Starting the Cluster

Using an SSH client program, like PuTTy on Windows, login to one of the nodes using the root credentials.
Start the hv_deploy mode using the following commands:
```
# su – admin
# export HV_PUBKEY=1
# hv_deploy
```