CSCLI Reference (Release 2.1.0)
Explains CSCLI modes and handling of invalid parameters for ClusterStor systems.
CLI commands are organized by mode; certain commands are available depending on the mode (state) of the ClusterStor system. Two modes are relevant to customers: Site Configuration Mode and Daily Mode. A third mode, OEM Mode, is relevant only to Manufacturing and factory personnel. OEM Mode commands are not included in this document.
Site Configuration Mode/CustWizard Mode/Pre-Shipment Mode
Site Configuration (custWizard) Mode (also called "Pre-Shipment" mode) commands are available after the ClusterStor system has been fully provisioned and before the system runs in Daily Mode. These commands enable users to specify customer configuration settings, apply or reset network cluster settings, obtain FRU information, upgrade ClusterStor software on Lustre nodes, and toggle between Site Configuration and Daily Modes.
Daily Mode
Daily Mode commands are available after the ClusterStor system has been fully provisioned and configured for customer use. These commands enable users to fully manage the Lustre file system and cluster nodes, including mount/unmount, power-cycle, failover/failback, and control node filters and exports. Daily Mode commands also enable users to obtain FRU information and upgrade ClusterStor software on Lustre nodes.
Guest Mode
A guest account allows non-privileged users to run some commands to obtain information about the system, using read-only access to the system. Depending on the privileges, a subset of CSCLI commands is provided for a guest account.
Set the Mode
Determine which mode is active:
cscli cluster_mode –s
To change modes, run one of the following:
cscli cluster_mode --mode daily
cscli cluster_mode --mode custwiz
How CSCLI Handles Invalid Parameters
If CSCLI detects multiple invalid parameters, it may report an error for only one of them. After fixing the designated error and re-entering the command, an error is reported for the next invalid parameter, and so on.
Summary of Changes for Release 2.1.0
- The CNG feature is not supported in Release 2.1.0. To avoid confusion, the section on CNG-specific CSCLI commands has been removed from this document.
- In Release 2.1.0, optional Additional DNE Units (ADUs) are now referred to as optional additional Metadata Management Units (MMUs). CSCLI commands that were previously used for ADUs are applicable to MMUs.
DailyMode – CSCLI Commands Added in Release 2.1.0
The following commands were added, changed, or removed in this software release 2.1.0:
| Addition/Change | CSCLI Command | Description | Component |
|---|---|---|---|
| Added | network ean secondary | EAN Secondary interface configuration | Network |
| Added | network ean route | EAN routing configuration | Network |
| Added | ssh_port | Specify SSH TCP port settings | Network |
| Added | remove_unit | Remove unit(s) from cluster | Node Control |
Summary of Changes for Release 2.0.0
The following table shows commands that were added or changed in the previous release:| Addition/Change | CLI Command | Description | Component |
|---|---|---|---|
| Added | async_journal | Enables/Queries/Disables asynchronous journal for OST targets | OST Target |
| Added | configure_mds | Configures MDS nodes (as part of ADU addition) | ADU |
| Updated | service_console | Configure service console | Serviceability |
| Updated | support_bundle | Additional log files are available in the support bundle for MDRAID examine output and Lustre users/groups or local users/groups for CNG nodes. | Support Bundle Settings |
| Added | lustre_network | Lustre network (HSN) IP addresses management. | Lustre |
| Added | list_ranges | List ranges of IPs for HSN | Lustre |
| Added | find_gaps | Show unused IPs in ranges of HSN | Lustre |
| Added | add_range | Add new range of IPs into HSN | Lustre |
| Added | extend_range | Extend range of IPs for HSN | Lustre |
| Added | remove_range | Remove range of IPs for HSN | Lustre |
| Added | lustre_perf | These commands are used to view the Lustre performance | Lustre |
| Added | show_new_nodes | Displays the nodes in ADUs when they are added to a system | ADU |
| Added to existing CSCLI command | configure_hosts | Nodes in the ADU (MDS nodes) can be configured via this command | ADU |
| Added to existing CSCLI command | show_nodes | Nodes in the ADU (MDS nodes) will also display along with OSS nodes | ADU |
| Added to existing CSCLI command | fs_info | File System information of nodes (MDS) in the ADU will also display | ADU |
| Added | rack | Extends the functionality of cscli get_rack_position and set_rack_position | Rack |
| Added | UD Commands | Unresponsive Drives Commands | Disk Drive |
| Added | dm | DM Service Configuration Management | Disk Drive |
| Added | dwd | DWD - Daemon Configuration Management | Disk Drive |