Cluster Management

Cluster Management

The Cluster page provides options for monitoring cluster status, managing cluster nodes, and configuring CSI storage classes for dynamic storage provisioning.

Initialize the Cluster #

Before using the cluster functions, create a pool and volume to initialize the System Volume. After the System Volume is initialized, XInsight automatically starts creating the cluster and configures the current KSM system as the master node.

Until initialization is complete, the Cluster page displays the following message: Not ready. Please initialize System Volume first.

If cluster initialization does not complete successfully, Cluster Status displays Error. Verify that the System Volume has been initialized correctly before continuing.

Cluster Information #

Select Cluster to view the cluster name and current cluster status.

  • Cluster Name: Displays the name assigned to the cluster.
  • Cluster Status: Displays the current operating condition of the cluster.

Cluster Status #

The Cluster Status field indicates the current operating state of the cluster:

  • Normal: The cluster is operating normally.
  • Warning: A worker node is offline, hardware is degraded, or one or more pools are in the Degraded or Error state.
  • Error: The master node is offline, a hardware error has occurred, or the pool containing the System Volume has failed.
  • NotReady: The System Volume has not been created.
  • Initializing: The System Volume has been created, and cluster initialization is in progress.
  • Transferring: The System Volume is being transferred. Cluster operations are unavailable until the transfer is complete.

Nodes Management #

Select Nodes Management to view the number of nodes in the cluster. Select a node from the cluster list to display its information.

The first KSM system is configured as the Master node. Additional KSM systems that join the cluster are configured as Worker nodes.

Add a Node #

Click the + icon in the lower-left corner of the Cluster panel to open the Add New Node window.

Enter the following information:

  • Node IP: Enter the IP address of the KSM system to add.
  • User Name: Enter a valid user name for the target system.
  • Password: Enter the corresponding password.

Click Add to add the node to the cluster.

Important: The target KSM system must be configured as a stand-alone master before it can be added. Adding the node might fail if the target system is already operating as a worker node or belongs to another cluster.

Node Information #

Select a master or worker node to view the following information:

  • Host Name: Displays the host name of the node.
  • Role: Identifies the node as Master or Worker.
  • Status: Displays the current operating status of the node.
    • Online: The node is ready and operating normally.
    • Warning: The node remains operational, but a resource, hardware, or connection condition requires attention.
    • Degraded: The node is operating with a degraded condition, such as an abnormal temperature, an unreachable node state, or a firmware version mismatch.
    • Offline: The node cannot communicate normally with the cluster or does not respond over the network.
  • Connection Quality: Indicates the communication quality between the node and the cluster.
  • Firmware Version: Displays the firmware version and build number.
  • Node IP: Displays the IP address used by the node.

Remove a Node #

Select a Worker node, and then click Remove. Confirm the removal when prompted.

The master node cannot be removed using this function. Before removing a worker node, make sure that the node is no longer required by cluster services or applications.

CSI Driver #

Select CSI Driver to view and manage the storage classes used by KSM for dynamic storage provisioning. The page displays the configured storage classes and provides options for managing connections to QSAN storage systems.

Create a Storage Class #

In the CSI Driver panel on the right, click the + icon in the lower-left corner to open the Create Storage Class window.

Requirement: The storage resources required by the selected protocol must already exist on the target QSAN storage system.

Under Connection, select one of the following:

  • Use existing connection: Select a previously configured QSAN storage connection.
  • Create new connection: Enter the storage system Address, Port, and account credentials. Enable HTTPS as required.

Select NFS or iSCSI under Protocol.

Enter a Name for the storage class and specify the storage resources used for provisioning. For NFS, specify the Pool and Share Host Group. Click Create.

Manage CSI Connections #

Click Manage Connections to view the QSAN storage system connections available to CSI storage classes.

Click the edit icon to modify the connection settings.

Click the delete icon to remove a connection.

Restriction: A connection that is currently used by a storage class cannot be deleted. Remove its association with the storage class before deleting the connection.

Table of contents