Skip to main content

Systems

All StorONE (S1) systems connect to a management station, also known as a relay. The command line interface (CLI) client connects to the relay, and can manage any systems connected to that relay.

You can use the systems command to list and select systems connected to the same relay. You can also rename the system.

The command prompt indicates the name of the system that you are currently working on. For example, if you are working on a system named Acme-Inc, then the command prompt appears as:
Acme-Inc>

List all systems

To view all S1 systems connected to the management station (available to the CLI session), use the systems list command.

Usage:

systems list [--connectToAllSystems]

Options:

Options and arguments Description
--connectToAllSystems Create a connection to all systems.
--showNodes Show nodes within the systems.

Examples:

  1. To list all available systems connected to the relay, run
    systems list
  2. To list all nodes within all systems connected to the relay, run
    systems list --connectToAllSystems --showNodes

Select a system

To work on a specific system, use the system select command.

Usage:

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

Options:

Options and arguments Description
--name=<name> Switch to an S1 two-node cluster by specifying its name, replace <name> with system name.
--id=<num> Switch to an S1 two-node cluster by specifying its id. Replace <num> with the id number of the system.

Examples:

  1. To switch to system name CLD1, run systems select --name CLD1
  2. To switch to system id 1, run system select --id 1

Rename a system

To rename a system that is available in your current CLI session, use the systems rename command.

Usage:

systems rename (--name=<name>|--id=<num>) --newname=<new_name>

Options:

Options and arguments Description
--name=<name> Specify the system by name, replace <name> with system name that you want to rename.
--id=<num> Specify the system by id, replace <num> with the ID number of the system that you want to rename.
--newname=<new_name> Specify the new name for the system. Replace <new_name> with a name of your choice.

Examples:

  1. To rename system CLD1 to Cloud1, run systems rename --name CLD1 --newname Cloud1
  2. To rename a system with ID 2 to MK1, run systems rename --id 2 --newname MK1