hostmap

Manages the mappings between Oracle FS System SAN LUNs and hosts.

SYNOPSIS

hostmap { [ ‑add | ‑delete | ‑list | ‑modify] | [ ‑usage | ‑help ] }

DESCRIPTION

Prior to making a LUN available to one or more hosts, confirm that your SAN environment meets the following requirements:

The LUN exists on the Oracle FS System.
For SAN hosts that are running Oracle FS Path Manager (FSPM), verify that FSPM has connected to the Oracle FS System and has created a host entry. For more information, see the appropriate Oracle FS Path Manager Installation Guide for the version of FSPM that is running on the SAN host.
For SAN hosts that are not running FSPM, define the host on the Oracle FS System by using the san_host ‑add command.

When you provision a LUN by using the lun ‑add command, the following mapping options are available to you:

Globally mapped: All hosts which can access the Oracle FS System Controllers can access the LUN
Mapped to one or more host entries: Only the specified hosts can access the LUN
Mapped to a host group: Only the hosts that are associated with a specified host group can access the LUN
Unmapped: None of the hosts on the SAN can access the LUN

To make a LUN visible to additional hosts, create a separate host map for each host or map the LUN to a host group. When working with hosts in a high-availability clustered environment, designate a host group for each group of hosts in the cluster.

Note: When you associate a host that has mapped LUNs with a host group, the Oracle FS System retains the individual host maps in most cases. The only exception is when the host group has LUN mappings that are also individually mapped to one or more hosts that are associated with the host group. In this scenario, the individual host mappings are replaced with the host group mappings.

Important! Host mapping and Controller port masking are two methods to prevent access to a given LUN. If you have provisioned your LUN with masking set to restrict access to the LUN from the Controller ports to which your host is connected, clear the port masking before attempting to present the LUN to the host. To clear the port masking, use the lun ‑modify ‑unMaskedControllerPorts command.

SUBCOMMANDS

‑add: Establishes an association between a SAN LUN and a host or a group of hosts.
‑delete: Deletes the mappings between the specified LUN and the specified hosts.
‑list: Displays a list of host maps or available LUN numbers.
‑modify: Changes the logical unit number assignment for a given host map.

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