Systems

A system is a StorONE-managed cluster — a single controller or an HA controller pair, along with everything it manages (applications, volumes, pools, and so on). A single CLI or web session can be connected to more than one system at once: one system is always your currently selected system (the one commands run against by default), and you can switch between systems, rename them, and list them all from here.

If you manage several systems side by side, Multi-System Manager registration ties them together under one central management address, so you don't have to connect to each one individually to keep track of them.

Listing systems

Using the web interface

Open Inventory > Systems. The list shows every system your session knows about, which one is currently selected, and its connectivity (direct or through a relay). Use the toolbar to also show each system's nodes.

Using the CLI

systems list [--connectToAllSystems] [--showNodes]

Option	Description
--connectToAllSystems	Create a connection to all systems.
--showNodes	Show nodes within the systems.

Examples

List systems with their connectivity status:

systems list

Connect to every known system and show their nodes:

systems list --connectToAllSystems --showNodes

Switching systems

Switching changes which system your CLI/API session's commands run against by default. This is a CLI/API-only concept — in the web interface, use the system picker rather than a command to switch context.

You can't switch systems while there are asynchronous configurations still running against the current one.

Using the CLI

systems select --name=<name>|--id=<numbers>

Option	Description
--name=<name>	Switch and manage this system by name.
--id=<numbers>	Switch and manage this system by ID.

Example

systems select --name dr-site

Renaming a system

Using the web interface

1. Open Inventory > Systems.
2. Select the system and click Rename.
3. Enter the new name and confirm.

Using the CLI

systems rename --name=<name>|--id=<numbers> --newname=<name>

Option	Description
--name=<name>	The system to rename, by name.
--id=<numbers>	The system to rename, by ID.
--newname=<name>	The new name for the system.

Example

systems rename --name dr-site --newname dr-site-east

Multi-System Manager

Registering a system with Multi-System Manager adds it to a central management address, so that address has visibility into every system registered to it. You can register the system you're currently connected to directly, or — if it's already registered — register a remote node so it joins the same Multi-System Manager.

Registering a system

Using the web interface

1. Open Inventory > Systems.
2. Choose Register with Multi-System Manager.
3. Under Local Registration, enter the Multi System Manager address to register the currently managed system with it — or, under Remote Registration, enter the management IP of a remote node to register it to the same Multi-System Manager as the local one.
4. Confirm to register.

Using the CLI

systems multi_system_manager register --multi_system_manager=<text>|--remoteNode=<text>

Option	Description
--multi_system_manager=<text>	The IP address or DNS name of the Multi-System-Manager.
--remoteNode=<text>	The management IP address of a remote node to register. The node will be registered to the same Multi-System-Manager as the locally managed node.

Examples

Register the currently managed system:

systems multi_system_manager register --multi_system_manager 10.10.1.5

Register a remote node to the same Multi-System Manager as the local one:

systems multi_system_manager register --remoteNode 10.10.1.20

A StorONE system running on Microsoft Azure can't be registered locally — registering it that way is refused. Always add it as a remote node from an on-premises system, as shown in Example: disaster recovery to Azure.

Checking registration status

Using the web interface

Open Inventory > Systems and choose Multi-System Manager Status.

Using the CLI

systems multi_system_manager status

This command takes no parameters — it reports the Multi-System Manager address each known system is registered to, and whether that system is currently connected.

Unregistering a system

Using the web interface

1. Open Inventory > Systems and choose Multi-System Manager Status.
2. Select the system and choose Unregister.
3. Confirm.

Using the CLI

systems multi_system_manager unregister --systemId=<numbers>|--address=<text>

Option	Description
--systemId=<numbers>	The ID of the system to unregister.
--address=<text>	The IP address or DNS name of the system to unregister.

Example

systems multi_system_manager unregister --address 10.10.1.20

---

See also: Users & Permissions · License