Managing client host groups

A client host group is a collection of client hosts. When you associate a storage resource with a client host group, it is associated with all client hosts in the group.

Viewing all client host groups

Procedure

Run the following command on any node in the cluster to view all client host groups:

zbs-meta host_group list

Output example

ID                                    Name                 Description
------------------------------------  -------------------  -------------
26bbbf0d-1c66-4ed6-b7cd-01e420137ce5  test-group-1
adf9f50f-2ed9-46d2-9891-581ea28e9239  test-group-3
eb01b152-4565-46cf-b67c-b958d8c56b24  test-group-2

Output note

Viewing basic information and associated storage resource details of a specified client host group

Procedure

Run the following command on any node in the cluster to view the basic information and associated storage resources of a specified client host group.

• View by client host group name:

  zbs-meta host_group show <host_group_name> [--show_associated_resources]

• View by client host group ID:

  zbs-meta host_group show_by_id <host_group_id> [--show_associated_resources]

Output example

-----------  ------------------------------------
ID           26bbbf0d-1c66-4ed6-b7cd-01e420137ce5
Name         test-group-1
Description
-----------  ------------------------------------
Associated Targets
Target ID
------------------------------------
2734d5ce-006e-4b35-a69c-fffefea1dcc0

Associated Luns
Parent Target ID                        Lun ID
------------------------------------  --------
2734d5ce-006e-4b35-a69c-fffefea1dcc0         1
69af0b7d-e684-4cd6-9d46-d9f459daa36f         2

No subsystem associated

No namespace associated

Output note

• Client host group basic information

  Parameter	Description
  ID	The client host group ID.
  Name	The client host group name.
  Description	The client host group description.

• Associated storage resource information

  • Associated iSCSI target information

    Parameter	Description
    Target ID	The target ID.

  • Associated iSCSI LUN information

    Parameter	Description
    Parent Target ID	The ID of the target to which the LUN belongs.
    Lun ID	The LUN ID.

  • Associated NVMe subsystem information

    Parameter	Description
    Subsystem ID	The subsystem ID.

  • Associated NVMe namespace information

    Parameter	Description
    Parent Subsystem ID	The ID of the subsystem to which the namespace belongs.
    NS ID	The namespace ID.

Creating a client host group

Procedure

Run the following command on any node in the cluster to create a client host group and set its name and description:

zbs-meta host_group create <host_group_name> [--desc DESC]

Output example

-----------  ------------------------------------
ID           45787fff-83fc-4d3b-9535-1c5934e4886b
Name         test-host-group
Description  test-desc
-----------  ------------------------------------

Updating a client host group

Procedure

Run the following command on any node in the cluster to update the client host group. This is a full update command, and all parameters must be specified:

zbs-meta host_group update <host_group_name> <new_host_group_name> <desc>

Output example

-----------  ------------------------------------
ID           45787fff-83fc-4d3b-9535-1c5934e4886b
Name         new-test-host-group
Description  new-desc
-----------  ------------------------------------

Deleting a client host group

Procedure

Run the following command on any node in the cluster to delete the client host group:

• Delete by client host group name:

  zbs-meta host_group delete <host_group_name>

• Delete by client host group ID:

  zbs-meta host_group delete_by_id <host_group_id>

Output note

If the command succeeds, no output is displayed.