hostmap ‑add

Establishes an association between a SAN LUN and a host or a group of hosts.

SYNOPSIS

hostmap ‑add 
   ‑lun lun‑or‑clone‑id‑or‑fqn
   ‑lunNumber logical‑unit‑number
   { ‑host host‑id‑or‑fqn
   | ‑hostGroup host‑group‑id‑or‑fqn
   }

   [{‑sessionKey | ‑u admin‑user ‑oracleFS oracle‑fs‑system}]
   [{‑outputformat | ‑o} { text | xml }]
   [{‑timeout timeout‑in‑seconds | ‑verify | ‑usage | ‑example | ‑help}]

DESCRIPTION

A host map defines which host or hosts can access an Oracle FS System LUN. You present a LUN to a host by creating a host map and assigning a logical unit number to the LUN. To provide access to a LUN from more than one host, use one of the following methods:

Create a host group and map it to the LUN.
Create multiple host maps, one for each host.

For a clustered environment, create a host group for the cluster.

Prior to creating a host map, the following requirements must be met:

The LUN must already exist on the Oracle FS System. To confirm that the LUN exists, use the lun ‑list command.
The host must be defined on the Oracle FS System. To verify that a host definition exists, use san_host ‑list command.
The logical unit number that you select must be available for the host on the Oracle FS System. Use hostmap ‑list ‑availableLunNumbers to obtain a list of unmapped logical unit numbers.

Note: You can create host maps for hosts that are disconnected from or not communicating with the Oracle FS System. You can also create host maps for empty host groups.

Note: Only administrators with primary administrator, admin1, or admin2 roles are authorized to run the hostmap ‑add command.

OPTIONS

‑host

Specifies a host entry which represents a computer on the customer SAN. You identify a host by providing a unique ID (ID) or a fully qualified name (FQN) for the host entry.

This host is mapped to the specified LUN.

‑hostGroup

Specifies a group of computers on the customer SAN. You identify the host group by providing a unique ID (ID) or a fully qualified name (FQN) for the group.

This host group is mapped to the specified LUN.

‑lun

Specifies the ID or the fully qualified name (FQN) of a LUN that resides on the Oracle FS System. An FQN begins with a forward slash character ( / ) and is followed by a path expression to locate the LUN.

‑lunNumber

Identifies the logical unit number of a LUN or of a Clone LUN to present to the SAN host.

EXAMPLE

Task

Using an unmapped logical unit number, create a host map that presents a LUN to a host.

Parameters

Fully qualified name of the LUN: /⁠lun_1
Logical unit number : 20
Fully qualified name of the host: /⁠sanhost_1

$ fscli  hostmap ‑add ‑lun /⁠⁠lun_1 ‑lunNumber 20 ‑host /⁠⁠sanhost_1