Nodes

The most commonly deployed StorONE (S1) system consists of a two-node cluster. The nodes are servers with a high availability (HA) connection. The S1 system manages the controller node servers and their peripherals. Each node has its own internal storage and S1 software.

Controller nodes are responsible for managing access to disk drive resources. Users interact with the S1 system using either the CLI or the GUI.

List all nodes

To display all S1 nodes, use the command nodes list.

Usage

nodes list [--sensors] [--gateway] [--vols] [--ip] [--sed]

Options

Options and arguments	Description
--sensors	Display information on sensors.
--gateway	Display information on the IQNs (iSCSI qualified names) and WWNs (world wide names) of the nodes.
--vols	Display a list of volumes served by each of the nodes.
--ip	Display IP information for each of the nodes.
--sed	Display information about self-encrypting drive (SED) password.

Examples

1. To list of all nodes, run nodes list
2. To list nodes with additional information on hardware sensors, run nodes list --sensors
3. To list nodes and the volumes currently being served on each node, run nodes list --vols

Client connections

To list all connected clients, use the nodes sessions command. Client connections include connection from initiator hosts to block volumes, as well as Server Message Block (SMB) and Network File System (NFS) connections.

Usage

nodes sessions [--node=<node_name>]

Options

Options and arguments	Description
--node=<node_name>	Filter results by node name.

Examples

1. To list of all connected nodes, run nodes sessions
2. To view all clients connected to node s1-6021, run nodes sessions --node s1-6021

Manual failover

To instruct one of the nodes to take over all volumes of the other node, use the nodes takeover command. You must specify the name of the node that will take over all the volumes. Upon successful execution of this command, the high availability (HA) state of the takeover node will change to All while the state of the other node will change to None.

Usage

nodes takeover --node=<name> [--force]

Options

Options and arguments	Description
--node=<node_name>	Specify the name of the node that will takeover. Replace <node_name> with the name of the node.
--force	Force the failover operation.

Examples

1. To instruct node s1-6021 to take over all volumes of the other node, run nodes takeover --node s1-6021
2. To force node s1-6021 to takeover all volumes of the other node, run nodes takeover --node s1-6021 --force

Manual failback

To return the system to high availability (HA) mode, where volumes are managed by the original assigned controller node, use the command nodes giveback.

Usage

nodes giveback [--force]

Options

Options and arguments	Description
--force	Do not prompt for confirmation.

Examples

1. To return the system to HA mode, run nodes giveback
2. To return the system to HA mode and skip the confirmation prompt, run nodes giveback --force

Enable a support tunnel

The support tunnel refers to a mechanism that allows StorONE support to remotely access and support your system. It enables a secure connection to your StorONE system using secure a secure shell (SSH) that is only accessible by internal StorONE personnel. To enable the support tunnel, use the node support tunnel enable command. 

Usage

nodes support tunnel enable --node=<node>

Options

Options and arguments	Description
--node=<node>	Specify the node to enable the support tunnel to.

Examples

1. To enable a support tunnel on node s1-6021, run

   nodes support tunnel enable --node s1-6021

Disable a support tunnel

To disable the support tunnel, use the nodes support tunnel disable command.

Usage

nodes support tunnel disable --node=<node>

Options

Options and arguments	Description
--node=<node>	Specify the node to disable the support tunnel to.

Examples

1. To disable the support tunnel on node s1-6021, run nodes support tunnel disable --node s1-6021

Display support tunnel status

To view the current status of the support tunnel, use the nodes support tunnel status command. If the support tunnel of a node is enabled, then the tunnel key appears in the Support Tunnel Status column, inside the parenthesis. You can provide this tunnel key to StorONE support to allow them to access and troubleshoot your system.

Usage

nodes support tunnel status

Options

This command has no options.

Examples

1. To get status information on all nodes, run nodes support tunnel status