Mappings

The applications mapping add command maps volumes (that are in the same application instance) to a host or a cluster. The mapping becomes part of a storage area network (SAN) providing block-level storage. The command allows you to choose the network protocol for storage communication. You can choose between

iscsi (internet small computer systems interface) protocol
NVMeOF (Non-Volatile Memory express over fiber) protocol
FC (Fibre Channel) protocol

The mapped volumes are block-level storage that appear to the host as local drives.

Map volumes to hosts

To map volumes (that are in the same application instance) to hosts, use the applications mapping add command.

Before you begin

Before you map volumes, you must configure hostname(s) in the S1 system. To configure hostnames in the S1 system, use the hosts create command.

Usage

applications mappings add --application=<app_name> [(--volumes=<vol_name…> --lunid=<lun_id…>)] --hosts=<name…>

options

Options and arguments	Description
`--application=<app_name>`	Specify the application instance from which the volumes map to the hostnames. Replace `<app_name>` with an application instance.
`--volumes=<vol_name…>`	To select a list of volumes from the application instance to be mapped to hostnames. Replace `<vol_name…>` with a list of volumes. If you do not use this option, all volumes in the application instance are mapped to the hostnames.
`--lunid=<lun_id…>`	To list logical unit identifiers (LUNid) that correspond to the list of volumes. Replace `<lun_id…>` with a list of LUN identifiers, where each LUN identifier corresponds to a volume in the `<vol_name…>` list.
`--hosts=<name…>`	List hostnames for the mapped volumes. Replace `<name…>` with a list of hosts.

Examples

To map volumes vol1 (LUN id 1) and vol2 (LUN id 2) on applications instance pack1 to hosts h1 h2 h3, run:

applications mapped add --application pack1 --volumes vol1 vol2 --lunid 1 2

Unmapping a volume from a host

You can unmap volumes from hostnames. To unmap volumes, use the applications mappings delete command.

Usage

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

Options

Options and arguments	Description
`--application=<app_name>`	Specify the application instance from which the mapped drive will be unmapped. Replace `<app_name>` with an application instance.
`--volumes=<vol_name…>`	To specify a list of volumes from the same application instance that will be unmapped from the hosts, replace `<vol_name…>` with a list of volumes. If you do not use this option, all volumes in the specified application instance are unmapped from the hostnames.
`--hosts=<name…>`	List hostnames from which the volumes will be unmapped. Replace `<name…>` with a list of hosts.

Examples

To delete vol1 on application instance pack1 from hosts h1 and h2, run:

applications mappings delete --application pack1 --volumes vol1 --hosts h1 h2

To delete all volumes in application instance pack1 from host h3, run:
```
applications mappings delete --application pack1 -hosts h3
```