san_host

Manages the SAN host entries on the Oracle FS System.

SYNOPSIS

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

DESCRIPTION

A SAN host entry is a record that represents a group of one or more initiators. An initiator is the World Wide Name (WWN) of an FC HBA port. You create host entries manually using the san_host ‑add command or automatically using Oracle FS Path Manager (FSPM).

The Oracle FS System can contain the following types of SAN host entries:

Unassociated host: The Oracle FS System automatically creates unassociated SAN host entries when an initiator is discovered on the SAN. The name of the initiator and the unassociated SAN host entry are the same.
Associated host: A host entry that an administrator associates with one or more host initiators. Use the san_host ‑add command to manually associate the initiators for a SAN host as associated hosts. After associating the initiators to the host, the associated host is a host entry.
FSPM host: A host that FSPM associates with one or more host initiators after logging in to the Pilot. FSPM manages the association of the initiators on the FSPM host to the FSPM host name.

Using the san_host command, you can perform the following operations:

Provide an alias for the SAN host initiator ports. An alias makes the ports easier to identify.
Enable the HP‑UX compatibility option that allows the system to use the HP-UX addressing scheme for LUNs.
Configure the FSPM load balancing settings on some operating systems.
Associate the host entry to a host group, which is a named, logical collection of hosts.

SUBCOMMANDS

‑add: Creates a SAN host entry on the Oracle FS System.
‑delete: Removes a SAN host entry from the Oracle FS System.
‑list: Displays information about a SAN host entry.
‑modify: Changes the properties of a SAN host entry.

GLOBAL OPTIONS

‑help: Displays command usage and additional help about the command.
‑usage: Returns a summary of the subcommands that are available for this command.

EXAMPLE

Task

Create a SAN Host entry on the Oracle FS System.

Parameters

The name of a SAN host entry: sanhost_1
The Fibre Channel (FC) HBA port on the SAN host that can connect to the Oracle FS System: 2001000B08000520/fcport-alias_1

$ fscli san_host ‑add ‑name sanhost_1 ‑fcInitiatorPort 2001000B08000520/⁠fcport-alias_1