HP 3PAR CIM API Programming Reference (OS 3.1.2 MU2) (QL226-97015, June 2013)

CreateStorageHardwareID (Creating Host and Path)
This method creates a StorageHardwareID (host HBA WWN/iscsiBane) on a host, it creates
the association TPD_MgmtServicesForStorageHWIDCollection between
TPD_StorageHardwareIDManagementService and the new TPD_StorageHardwareID.
This operation is similar to “createhost <hostname> <wwn>” or “createhost –iscsi
<hostname> <iscsiName>”. If ElementName is NULL, a new host with a system-generated
ElementName will be created first and the StorageID will be added to the host. If a host already
exists with the same ElementName, then the StorageID will be added to that host. Otherwise
a new host will be created with the ElementName and StorageID will be added to the host.
The method signature is described below:
uint32 CreateStorageHardwareID (
[In] String ElementName,
[In] String StorageID,
[In] Uint16 IDType,
[In] String OtherIDType,
[In] CIM_StorageClientSettingData REF Setting,
[Out] CIM_StorageHardwareID REF HardwareID);
• ElementName: This is the name of the host to create the host HBA WWN/iSCSI name on. If
this is NULL, a new host with a system-generated ElementName will be created. If a host
already exists with the same ElementName, then the StorageID will be added to that host.
Otherwise a new host will be created with the ElementName and StorageID will be added
to the host.
• StorageID: WWN of the FC host HBA or iscsiName of the iSCSI host HBA to create. This
is mandatory.
• IDType: Type of StorageID property. This must be 2 (Port WWN for FC target port) or 5
(iscsiName for iSCSI target port); all other values are rejected. This is mandatory.
• OtherIDType: Description of the type of StorageID if IDType is 1 (Other). Since only IDType
of 2 and 5 is accepted, this value is ignored.
• Setting: Reference to the StorageClientSettingData containing the OSType appropriate
for this initiator. This refers to an TPD_StorageClientSettingData which is equivalent
to a host persona; if not specified then the host persona defaults to Generic. If this operation
is being applied to a StorageID on an existing host with a different Setting, then the host
will be reconfigured to use this Setting.
• HardwareID: Reference to the new StorageHardwareID instance. Must be NULL on input.
DeleteStorageHardwareID (Removing a Path from a Host)
This method deletes a named StorageHardwareID (host HBA WWN/iscsiName) from a host,
and also tears down the associations that are no longer needed, including
CIM_ConcreteDependency and CIM_AuthorizedSubject.
This operation is similar to “removehost <hostname> <wwn>” or “removehost –iscsi
<hostname> <iscsiName>”.
The method signature is described below:
uint32 DeleteStorageHardwareID (
[In] CIM_StorageHardwareID REF HardwareID);
Masking and Mapping Subprofile 87