Hosts

The S1 system allows the mapping of logical volumes, from the same application instance, to a host or a cluster. The mapping becomes part of a storage area network (SAN) providing a block-level storage.

When to use the hosts command

The hosts command create a host (or an internal host) designed to map block-level raw storage resources from logical volumes through iSCSI, Fiber-channel or NVVMe. To map a provisioned raw data from logical volume, you need to have a host.

Display available hosts

To display a list of available hosts, use the hosts list command

Usage:

hosts list [<name>] [--wwn --iqn --nqn] [--mapping] [--ip]

Options:

Examples:

1. To list all the hosts, run

   hosts list
   

2. To list all the hosts and to display the IP address of each host, run

   hosts list --ip
   

3. To list all the hosts and to display both the IP address and the iSCSI qualified name for each of the hosts, run

   hosts list --ip --iqn
   

4. To display the IP address, world wide name identifier, the iSCSI qualified name, and the mappings for a host name hs1, run hosts

   list hs1 --ip --wwn --iqn --mapping
   

5. To list all the hosts and to display IP address, iSCSI qualified name, world wide name identifier, network qualified name, network qualified name, and mapping, run

   hosts list --ip --wwn --iqn --nqn --mapping
   

Creating a host

To create a new host, use the hosts create command.

Usage:

hosts create <name> [--ip=<name>] (--wwns=<wwn…>| --iqn=<iqn> | --nqn=<nqn>)

Options:

Examples:

1. To create host hst1 with IP address 192.168.60.26 and with iSCSI qualified identifier 130, run

   hosts create hst1 --ip 192.168.60.26 --iqn iqn.130 
   

2. To create host NQhs with IP address 192.168.68.212 and with network qualified name 2023.org.nv, run

   hosts create NQhs --ip 192.168.68.212 --nqn nqn.2023.org.nv
   

3. To create host WN with IP address 192.168.75.212 and with world wide name addresses 50:06:04:81:D6:F3:45:42, 10:00:00:00:C9:22:FC:01, and 5A:CD:E4:82:34:56:78:98, run

   hosts create WN --ip 192.168.75.212 --wwn 50:06:04:81:D6:F3:45:42 10:00:00:00:C9:22:FC:01 5A:CD:E4:82:34:56:78:98
   

Editing a host

To edit a host, use the hosts edit command.

Usage:

 hosts edit <name> [--newname=<name>]  [--ip=<name>] [--wwns=<wwn…>| --iqn=<iqn> | --nqn=<nqn>]

Options:

Notice: The edit command cannot mix between FC, iSCSI, and NVMeOF protocols. For example, if a host was created with an IQN network protocol, it cannot be modified by the edit command to work with an NQN network protocol.

Examples:

1. To rename host hs1 to myHS1, run

   hosts edit hs1 --newname myHS1
   

2. To edit IQN protocol host hst3 with the following parameters

   • Change the IP to DNS name: myiqn.com.
   • Change the IQN identifier to ABCD. run:

   hosts edit hs13 --ip myiqn.com --iqn iqn.ABCD
   

3. To edit WWN protocol host srt with the flowing parameters

   • Rename tokQN
   • Change IP address to DNS name key2storage.com
   • Change the unique identifier addresses to world wide name addresses 50:AA:04:81:D6:F3:45:42 50:AA:cc:81:D6:F3:45:42 ,

   run

   hosts edit srt --newname kQN --ip key2storage.com --wwn 50:AA:04:81:D6:F3:45:42  50:AA:cc:81:D6:F3:45:42
   

Add mapping to a logical volume (host mapping add)

To add mapping between a logical volume and an iSCSi/FC/NVMeOF host, use the hosts mappings add command

Usage:

hosts mappings add --application=<name> --hosts=<name…> [(--volumes=<name…> --lunIds=<lun_id…>)]

Options:

Notice:

• The LUN ID is an integer ranging between 1-255.
• The LUN ID is for identifying the mapping between a host and a logical volume. Logical volume that are not mapped does not have a LUN ID.
• When you add a mapping between host A and logical volume V, you are required to enter a LUN ID for this mapping. You can enter any integer between 1 to 255 provided that it has not been used by host A to map other logical volumes.
• The LUN ID is managed by the host side. If A and B are two different hosts, then it is perfectly legal for them to use the same LUN ID integer to map logical volumes.
• You cannot map file/object logical volume.

Examples:

1. To map hosts hst1 to logical volume yn2 with LUN ID 1 on application instance sales, run

    hosts mappings add --application sales --volumes yn2 --lunIds 1 --hosts hst1 
   

2. To map hosts hst2 to logical volume xy3 using the next available LUN ID on application instance HR, run

   hosts mappings add --application HR --volume xy3 --lunIds * --hosts hst2
   

3. To map hosts h1 to logical volume lv1 and h2 to logical volumes lv2, where both lv1 and lv2 are on application instance sales, run

   hosts mappings add --application sales --volume lv1 lv2 --lunIds * * --hosts h1 h2
   

Removing a mapping from a logical volume

To remove a mapping from a logical volume, use the hosts mapping delete command.

Usage:

hosts mappings delete --application=<name> [--volumes=<name…>] --hosts=<name…>

Options:

Examples:

1. To delete (unmap) mapping between host hst1 and logical volume lv1 on application name sales, run

   hosts mappings delete --application sales --volumes lv1 --host hst1
   

2. Multiple mappings between hosts and logical volumes that are on the same application instance can be deleted. Consider the following mappings:

   • Mapping between host H1 and vol1 on application instance HR.
   • Mapping between host H2 and vol2 on application instance HR. To delete the above mappings, run

   hosts mappings delete --application HR --volumes vol1 vol2 --hosts H1 H2
   

Adding WWN to a host

Adding WWN (World Wide Name) to a host refers to the process of associating a unique identifier with a host in a storage area network (SAN) or Fibre Channel environment. Adding WWN to a host configures its Fibre Channel HBA or NIC with a unique identifier. This allows the host to communicate and connect with other devices in the Fibre Channel network. It enables the host to access shared storage resources, transfer data, and participate in SAN activities.

To add WWN to a host, use the host wwn add command.

Usage:

 hosts wwn add <name> --wwns=<wwn…>

Options:

Examples:

1. To add WWN 50:D6:A4:81:D6:F3:45:42 to a host hs1, run

   hosts wwn add hs1 50:D6:A4:81:D6:F3:45:42
   

2. To add WWNs 50:B6:A4:81:D6:F3:45:42 and 50:06:A4:81:D6:F3:55:55 to a host hs1, run

   hosts wwn add hs1 50:B6:A4:81:D6:F3:45:42 50:06:A4:81:D6:F3:55:55 
   

Removing WWN from a host

To remove (delete) a WWN from a host, use the command hosts wwn delete.

Usage:

 hosts wwn delete <name> --wwns=<wwn...>

Options:

Examples:

Delete a host

To delete a host, use the hosts delete command.

Examples:

1. To remove WWN 50:D6:A4:81:D6:F3:45:42 from a host hs1, run

   hosts wwn add hs1 50:D6:A4:81:D6:F3:45:42
   

2. To delete WWNs 50:B6:A4:81:D6:F3:45:42 and 50:06:A4:81:D6:F3:55:55 from a host hs1, run

   hosts wwn add hs1 50:B6:A4:81:D6:F3:45:42 50:06:A4:81:D6:F3:55:55 
   

Usage:

hosts delete <name>

Options:

Examples:

1. To delete host name hst1, run

   hosts delete hst1