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
- Open Inventory > Systems.
- Select the system and click Rename.
- 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
- Open Inventory > Systems.
- Choose Register with Multi-System Manager.
- 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.
- 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 StorONE on Microsoft 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
- Open Inventory > Systems and choose Multi-System Manager Status.
- Select the system and choose Unregister.
- 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