Creates a SAN host entry on the Oracle FS System.
san_host ‑add ‑name sanhost‑name [{‑hpuxCompatibility | ‑noHpuxCompatibility}] [‑fcInitiatorPort fcinitiatorport‑wwn[/fcinitiatorport‑alias] [, fcinitiatorport‑wwn[/fcinitiatorport‑alias] ]... ] [{‑reconcileMappings | ‑noReconcileMappings}] [‑associateGroup 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}]
Use the san_host ‑add command to create an associated host entry by associating one or more initiators on a host to a named host entry. An initiator is the World Wide Name (WWN) of an FC HBA port.
For systems that use the HP-UX operating system, you can set an option to use the HP-UX LUN numbering scheme. You can optionally specify that the system reconcile any future conflicts with existing host LUN mappings.
If the host is running Oracle FS Path Manager (FSPM) then FSPM automatically creates a host entry for the host when FSPM first connects to the Pilot on theOracle FS System. For host systems that use FSPM, you might not need to use the san_host ‑add command. Refer to the Oracle FS Path Manager Installation Guide for details on how to add FSPM host entries on the Oracle FS System.
Specifies the ID or the fully qualified name (FQN) of the host group with which to associate the SAN host.
Optional: an alias for the port consisting of a slash character ( / ) that is followed by the text of the alias.
Identifies the host as using the HP-UX addressing mode for LUNs.
Specifies the name of a SAN host entry that you are creating on the Oracle FS System. After the Oracle FS System updates the internal host table, the name that you provide is used to create the fully qualified name (FQN). To ensure that the Oracle FS CLI software that is running on thePilot includes the spaces or dashes in the name, use double quotation marks around names containing spaces or dashes; otherwise, the software will generate a parsing error.
Disables the HP-UX LUN addressing mode for the SAN host.
Disables the automatic fixing of any LUN mappings for this host that cause mapping conflicts.
Specifies that any subsequent LUN mappings for this host that cause a conflict are automatically fixed. If this option is omitted, ‑noReconcileMappings is the default.
The following global options can be used for fully formed fscli commands:
The command completes successfully.
The command returns with an error.
The session times out.
Inspects the validity of the command syntax, not the semantics. Used to test the structure of a command without running the command. Does not determine whether errors would be produced if you issue a structurally correct command with the input provided.
Directs the CLI to prompt you to supply a session key when you issue the command. The CLI displays Sessionkey: as the prompt. To obtain a session key, log in with the ‑returnKey option specified. After the session is established, the session key is displayed in STDOUT. If you request a session key, the ‑sessionkey option is required syntax for all commands that are issued in a given session. In environments with more than one Oracle FS System, the session key is used to determine to which Oracle FS System to direct the command for validation. Session keys are also used to establish two or more CLI sessions when using a shared administrator account.
Create a SAN Host entry on the Oracle FS System.
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