hostmap list

Displays a list of host maps or available LUN numbers.

SYNOPSIS

hostmap ‑list 
   [‑details]
   [{ ‑lun lun‑or‑clone‑id‑or‑fqn [, lun‑or‑clone‑id‑or‑fqn]...
    | ‑availableLunNumbers
    }]
   [{ ‑host host‑id‑or‑fqn [, host‑id‑or‑fqn]...
    | ‑hostmap hostmap‑id‑or‑fqn [, hostmap‑id‑or‑fqn]...
    | ‑hostGroup host‑group‑id‑or‑fqn [, host‑group‑id‑or‑fqn]...
    | ‑hostGroupMap host‑group‑map‑id‑or‑fqn [, host‑group‑map‑id‑or‑fqn]...
    } ]

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

DESCRIPTION

Displays a list of the fully qualified names (FQNs) of the hosts, and the LUNs to which they are mapped. Use the ‑details option to see hostmap or hostgroupmap FQNs and unique identifiers (IDs), LUN numbers, and mapping types.

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

OPTIONS

availableLunNumbers

Returns a list of all of the logical unit numbers that are available on the Oracle FS System, for a given SAN host or hostmap or SAN host group or hostgroup map. If neither hosts, host groups, nor maps are provided, then the globally available numbers are returned.

details
Provides the following information for each host mapping:
  • The fully qualified name (FQN) and unique identifier (ID) of the LUN or of the Clone LUN

  • The logical unit number of the LUN or of the Clone LUN

  • The FQN and the ID of the SAN host

  • The FQN and the ID of each initiator that is associated with the SAN host

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.

The list of host mappings are returned only for the specified SAN hosts.

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.

The list of host mappings are returned only for the specified host groups.

hostGroupMap

Specifies a mapping between a LUN and a host group. You identify the host group mapping by providing a fully qualified name (FQN) or a unique ID (ID).

The list of host mappings are returned only for the specified host group maps.

hostmap

Identifies a mapping between a LUN and a SAN host. You identify the hostmap by providing a unique ID (ID) or a fully qualified name (FQN).

The list of host mappings are returned only for the specified host maps.

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.

EXAMPLE

Task

Display a detailed list of host maps that are associated with a given LUN.

Parameters
  • The details option

$ fscli hostmap ‑list ‑details