WBEM Provider Data Sheet nPartition Provider This data sheet provides basic information about the nPartition WBEM provider. This provider is implemented using the Pegasus C++ provider API. The intended audience of this document is client/provider developers and sophisticated end-users who want to use this provider. This data sheet was last updated: 18-August-2005. Keywords: (Pegasus C++ API, Partitionable System, nPartition, HP-UX 11.23, Linux, Windows) Table Of Contents 1.
.1.0: Adds support for Arches platforms (including new GSM properties); Adds compatibility with systems running Montecito (Hyper-Threaded) CPU’s. 2.0.0: Adds support for 64-bit Windows; Adds support for the local (BT) IPMI interface on Windows; Adds support for HP-WBEM 2.0 (WMI Mapper 2.0). 1.2.2: Fixes a Windows-specific (byte-ordering) problem in managing PA-RISC nPartitions running HP-UX. 1.2.
components (e.g., adding or removing cells and creating or deleting nPartitions) the operation may fail if it accesses the nPartition Provider on Windows or Linux. 2. Setting Up This Provider Installing this Provider on HP-UX 11i: This provider is installed with the bundle NPar. The provider executable is: /opt/nparprovider/lib/libHPNParProvider.1 Installing this Provider on Microsoft Windows: A Windows Installer (.
HP_NParPotentialErrorObject (Abstract Class) ............................................................ 4 HP_NParProfile (Abstract Class) .................................................................................. 5 HP_NParComplex (Concrete Class).............................................................................. 6 HP_NParPartition (Concrete Class)............................................................................. 13 HP_NParDynamicProfile (Concrete Class).......................
datetime LockTime Local locked when it was requested. The duration of time for which the object has been locked. The property is not present unless the ErrorCode property contains a value indicating that the object was locked when it was requested. Table 2. HP_NParPotentialErrorObject extrinsic methods Class HP_NParPotentialErrorObject contains no extrinsic methods. HP_NParProfile (Abstract Class) HP_NParProfile is a subclass of HP_NParPotentialErrorObject. This is an abstract class. No instances exist.
Table 4. HP_NParProfile extrinsic methods Method Name Description Exceptions thrown Unlocks the profile regardless of its current lock state. This should be used with care by client applications, when it is known that the lock is held by an unresponsive or nolonger-running client. MpPassword (management uint32 ForcedUnlockProfile( CIMOperationFailedException processor password) is string MpPassword ) if the operation fails. required when the namespace is for a remote MP otherwise it is ignored.
uint16 MinorRevisionNumber Local string RevisionString Local string ModelString Local string ComplexName Local string Local OriginalProductOrderNumber string Local CurrentProductOrderNumber string CreatorManufacturer Local string OEMManufacturer Local String CreatorProductName Local Least significant portion of the revision number for this profile layout. Major and minor revision numbers concatenated and separated by a period, e.g. "4.2".
string OEMProductName Local The name of the product as assigned by the OEM manufacturer. This property is supported only on Itanium®based platforms but may not be present on all of those. [Also see note at the end of this table.] string CreatorSerialNumber Local The serial number of the complex as assigned by the original manufacturer.
AllCLM(2), NoCLM(3), Absolute(4), and Fraction(5). User settable. uint16 GNIPerCell Local Array of values indexed by cell ID. Provides the amount of Global Non-Interleaved (GNI) or Cell Local Memory (CLM) memory that should be configured for this cell. When the corresponding element of GNISpecType is Absolute, this value is the number of 0.5 GB blocks, e.g. a value of 3 means that 1.5 GB of memory should be allocated as CLM.
uint8 GSMSharingType Local nPartitions. Each element in the array represents a partition. For example, element 0 is for partition 0 and element 6 is for partition 6. Each element is a bit array. For each bit a value of one indicates that sharing is allowed, and a value of zero indicates that sharing is not allowed. The bit array is indexed by partition id. For example, if array element 6 has bits 2 and 11 set, then partition 6 can share memory with nPartitions 2 and 11.
uint32 AffectedCells[] Local uint32 BootPartitions[] Local boolean UserCanModify Local SeeGSMSharingArray(2) = Refer to the GSMSharing array property to determine which nPartitions are configured to allow GSM sharing with which other nPartitions in the complex. Note: When writing these properties, the WBEM nPartition Provider may override the values in the GSMSharing array, based on the value specified for the GSMSharingType property.
boolean Local InterpartitionSecurityEnabled String MpPassword sint32 ErrorCode string ErrorMessage string LockOwner datetime LockTime on the nPartition where the provider is running. For a remote complex, the user must have previously configured the provider for that remote complex by creating a HP_NParRemoteComplex object containing a valid password for the remote service processor. Note that modification authority is subject to the restrictions implied by the property NParConfigPrivilegeIsEnabled.
CreatorProductName and possibly also OEM Product name. Client applications should first check if OEM Product name is present in the instance. If so, this value should be used to identify the type of system. If that is not present, then try CreatorProductName, and finally try ModelString.. Table 6. HP_NParComplex extrinsic methods Method Name Description Exceptions thrown uint32 ForcedUnlockProfile( See Table 4. See Table 4. string MpPassword ) Cancels a pending complex profile.
boolean PartitionIsDefined Local string PartitionLabel Local string PartitionName Local string PartitionNameLabel Local boolean IsLocalPartition Local boolean CellUseOnNextBoot[] Local uint32 CoreCellID Local uint8 MaxSizeCoreCellChoices Local uint32 CoreCellChoices[] Local based(3) True if this partition currently exists (has been configured in the complex), otherwise false. A display string formed from the nPartition number, e.g. "par2". The name of this nPartition.
boolean BootWithoutConsole Local boolean RebootOnError Local uint8 KnownGoodMemory Local string AdminIPAddress Local uint8 BootTimer Local attempt to select a core cell for the nPartition. For example, if the array contained the values {1, 2}, then cell 1 would be selected first. If cell 1 fails or is not capable of being a core cell, system firmware will then attempt to select cell 2.
uint16 IcodData Local uint8 FailureUsage[] Local Boolean BootPathsAreAvailable Local string PrimaryBootPath Local for a response from the boot device before trying the next boot deviceS upported only on PA-RISC nPartitions. User-settable. Data used by Instant Capacity. User-settable. Modification of this property requires approval by Instant Capacity software on complexes with Instant Capacity installed. Array of values indexed by cell ID.
boolean PrimaryAutosearch Local boolean PrimaryAutoboot Local string AlternateBootPath Local boolean AlternateAutosearch Local boolean AlternateAutoboot Local nPartition. Present and settable when BootPathsAreAvailable is true.. User-settable. True if autosearch should be enabled for the primary boot device. Present and settable for all nPartitions on PARISC platforms. Not supported on Itanium®-based platforms. User-settable. True if autoboot should be enabled for the primary boot device.
string HAAlternateBootPath Local boolean HAAlternateAutosearch Local boolean HAAlternateAutoboot Local uint8 OSSupportsGNI Local uint8 OSSupportsCellOLA Local uint8 OSSupportsCellOLD Local three of PrimaryAutoboot, Alternate Autoboot, and HAAlternateAutoboot must contain the same value. Usersettable. The HA alternate boot path for this nPartition. Present and settable when BootPathsAreAvailable is true.. User-settable. True if autosearch should be enabled for the HA alternate boot device.
string MpPassword sint32 ErrorCode string ErrorMessage string LockOwner datetime LockTime system instance on which the nPartition provider is running supports Cell On-line Deletion (OLD). Values are Unknown(0), Yes(1), No(2). HP_NParProfile See Table 3. HP_NParPotentialErrorObject See Table 1. HP_NParPotentialErrorObject See Table 1. HP_NParPotentialErrorObject See Table 1. HP_NParPotentialErrorObject See Table 1. Table 8.
IsLocalPartition property. MpPassword (management processor password) is required when the namespace is for a remote MP otherwise it is ignored. If the operation is successful, 0 will be returned. If the operation fails, an exception will be thrown and no value returned. Requests that the nPartition be booted. The nPartition will transition from the inactive state to the active state, e.g. the Boot Inhibit Bit (BIB) will be cleared for all cells in the nPartition for which CellUseOnNextBoot is true.
Capacity software. There is only one instance of this class in any complex. This class supports the same extrinsic methods as HP_NParProfile. Table 9. HP_NParDynamicProfile properties Property Name uint32 ProfileID [Key] uint32 SequenceNumber uint64 IcodCheckSum uint8 IcodData[] String MpPassword sint32 ErrorCode string ErrorMessage string LockOwner datetime LockTime Property Value (and data source) Local ID of this profile. Always 0. HP_NParProfile See Table 3. Write-only property.
uint8 CellSlotCount Local Number of cell slots in this cabinet uint8 IOBaySlotCount Local Number of I/O bay slots in this cabinet. uint8 IOChassisSlotCount Local Number of I/O chassis slots in this cabinet. Note that I/O chassis slots are located in I/O bays. This value represents the total number of I/O chassis slots in the cabinet, not the number in each bay. uint8 PowerDomainCount Local Number of power domains in this cabinet.
ServiceProcessorShortLabel string ServiceProcessorCount string ServiceProcessorLocation[] string ServiceProcessorStatus[] uint8 LEDState the service processor in this cabinet, e.g "MP" or "GSP". Local Number of service processors in this cabinet. Local Array of long display names for the location of service processors in this cabinet. On cabinets where the service is a separate component, this will be the same as the cabinet Label.
required when the namespace is for a remote MP otherwise it is ignored. If the operation is successful, 0 will be returned. If the operation fails, an exception will be thrown and no value returned. HP_NParSlot (Abstract Class) The HP_NParSlot class is an abstract class. No instances exist. Queries to get names or instances of this class are not directly supported. Table 13.
Table 14. HP_NParSlot extrinsic methods Method Name uint32 SetLED( uint8 newState, string MpPassword ) Description Exceptions thrown When newState = 3, turn the attention indicator on steady. When newState = 4, flash the attention indicator. When newState = 5, turn the attention indicator off. Fails for any other value. MpPassword (management processor password) is required when the namespace is for a remote MP otherwise it is ignored. If the operation is successful, 0 will be returned.
Table 16. HP_NParCellSlot extrinsic methods Method Name Description Exceptions thrown uint32 SetLED( uint8 newState , string MpPassword) See Table 14. uint32 MakeID( uint8 CabinetID, uint8 SlotNumber ) Return the correct ID for a cell slot in cabinet CabinetID None. and slot number SlotNumber within that cabinet. See Table 14. HP_NParIOChassisSlot (Concrete Class) HP_NParIOChassisSlot is a subclass of HP_NParSlot. This class represents I/O Chassis slots in a partitionable complex. Table 17.
uint32 SetLED( uint8 newState, string MpPassword ) See Table 14. See Table 14. uint32 MakeID( uint32 CabinetID, uint8 IOBayNumber, uint8 SlotNumber ) Return the correct ID for a chassis slot in cabinet CabinetID, I/O bay IOBayNumber within that cabinet, and slot number SlotNumber within that I/O bay. None HP_NParComponent (Abstract Class) HP_NParComponent is a subclass of HP_NParPotentialErrorObject. This is an abstract base class for the HP_NParCell and HP_NParIOChassis classes. No instances exist.
sint32 ErrorCode string ErrorMessage string LockOwner datetime LockTime an active nPartition and no reboot or shut down for reconfiguration of the nPartition has been done, or the component has been configured to remain inactive when the nPartition boots. A component is active when it has joined a nPartition during boot. Note that the status of the component does not imply anything about the state of the OS on the nPartition.
The HP_NParCell class is a subclass of HP_NParComponent. This class represents cells in a cellular, partitionable complex. Table 21. HP_NParCell properties Property Value (and data source) ID of the uint32 SlotID [Key] HP_NParComponent HP_NParCellSlot in which the cell is located. uint8 ComponentStatus HP_NParComponent See Table 19. sint32 ErrorCode HP_NParPotentialErrorObject See Table 1. string ErrorMsg HP_NParPotentialErrorObject See Table 1. string LockOwner HP_NParPotentialErrorObject See Table 1.
uint16 DIMMSize[] Local. string DIMMLabel[] Local uint8 DIMMStatus[] Local each DIMM type is defined in the Firmware ERS for the platform on which it is implemented. An element of this array is undefined if the corresponding element in DIMMSlotPopulated is false. NOTE: This property may not be available when the cell is powered off. Array, indexed by DIMM slot number, giving the size of the DIMM in the slot in megabytes.
uint32 ActualGNIMemory Local uint8 MaxInterleaveCount Local has deconfigured a DIMM. HWDeconfig is used when system firmware has deconfigured a DIMM. UnsupportedType is used when the type of the DIMM in the slot is not supported on this platform. TypeMismatch is used when the types or sizes of all of the DIMMs in a single memory echelon do not match (the term "rank" is used on older platforms instead of "echelon"). Echelon size varies by platform. Failed is used when the DIMM is has malfunctioned.
uint8 InterleaveCount Local uint32 InterleaveContribution[] Local uint32 MaxCPUCount Local supported by this platform. NOTE: This property may not be available when the cell is powered off. The actual number of interleave regions allocated by system firmware for the nPartition in which this cell is located. The value is 0 if the cell is not in an active nPartition. NOTE: This property may not be available when the cell is powered off.
Unit8 CPUModuleSlotCount Local uint8 CPUCount Local uint8 CPUCountOK Local uint8 CPUCountPerModule Local uint32 CPUClockDomain Local actually installed. The maximum number of processors per module supported by this system can be computed by dividing this value by CPUModuleSlotCount. The number of processor module slots on this cell. A processor module may contain 1 or more processors. The actual number of processors on this cell. The number of installed processors that are configured for use.
uint32 CPUSpeed Local uint8 CPUModuleNumber[] Local boolean CPUSlotPopulated[] Local uint8 CPUStatus[] Local the processors. This property is valid only for PA-RISC processors. It will always be 0 for Itanium®-based processors. The clock speed in megahertz of the processors on the cell. All processors must have the same clock speed. NOTE: This property may not be available when the cell is powered off. Array of size MaxCPUCount, indexed by CPU slot number.
uint8 CPUModuleType Local uint16 CPUFrequencyType Local uint8 CellBoardType Local uint8 CellComplexType Local string CompatibilityLabel Local uint8 CellArchitecture Local uint8 CellUsage Local the processor slot is not populated. The processor module compatibility value. This value must be the same for all cells in an nPartition. The processor frequency compatibility value. This value must be the same for all cells in an nPartition. The cell board compatibility value.
uint16 IODCVersion Local uint32 FirmwareMajorNumber Local uint32 FirmwareMinorNumber string FirmwareRevision Local boolean ConnectedToIOChassis Local FailureUsage property of HP_NParPartition. Values are: Unknown(0), Other(1), None(2), Base(3), Base No Interleave (4), Floating(5), and Deconfigured(6). "Base no interleave" indicates the cell should have had interleaved memory but no memory was interleaved due to the setting of the FailureUsage property.
uint32 ConnectedIOChassisID Local boolean REOInitialized Local boolean HasCoreIO Local boolean PCIOlradCapable Local boolean GSMSupportCapable Local boolean CellPowerControlCapable Local boolean CellOlradCapable Local boolean Local IOChassisPowerControlCapable boolean Local I/O Chassis ID of the chassis to which the cell is connected. The property is not present if ConnectedToIOChassis is false.
IOChassisOlradCapable boolean CabinetOlradCapable sint32 ErrorCode string ErrorMessage string LockOwner datetime LockTime on the cell supports I/O chassis online replacement, addition and deletion. True if system firmware on the cell supports Local cabinet online addition and deletion. HP_NParPotentialErrorObject See Table 1. HP_NParPotentialErrorObject See Table 1. HP_NParPotentialErrorObject See Table 1. HP_NParPotentialErrorObject See Table 1.
uint8 PCISlotCount Local uint8 PopulatedPCISlotCount Local string PCISlotLabel[] Local boolean PCISlotPopulated[] Local uint32 PCICardVendorID[] Local uint32 PCICardDeviceID[] Local core I/O card. The number of PCI I/O card slots in this chassis. NOTE: This property may not be available when the connected cell is powered off. The number of PCI I/O card slots occupied by cards in this chassis. NOTE: This property may not be available when the connected cell is powered off.
uint32 PCICardClass[] uint32 PCICardLabel[] sint32 ErrorCode string ErrorMessage string LockOwner datetime LockTime Provides the device ID from the PCI config header on the card in the slot. The value is 0 if the slot is empty. NOTE: This property may not be available when the connected cell is powered off. Array indexed by PCI I/O card slot number within the chassis that contains the slot. Provides the PCI class of the card from the PCI config Local header on the card in the slot.
HP_NParPowerCoolingDomain (Concrete Class) The HP_NParPowerCoolingDomain class represents either a power domain (a set of power supplies used to power a particular set of components in the cabinet) or a cooling domain (a set of cooling units, such as fans or blowers, used to cool a particular set of components in a cabinet. Table 25.
there are one or more redundant units in that one or more units could fail and the domain could continue to serve its purpose for the equipment installed in this cabinet. N indicates sufficient, but non-redundant units. There are sufficient units to serve the cabinet, but any single failure will cause the domain to become insufficient. N- indicates there are insufficient units to serve the cabinet as configured. Some components may be shut down. Housekeeping only applies only to power domains.
for the unit, within its cabinet. For example, "fan1". string LongUnitLabel[] Local An array indexed by slot number giving a label for the unit including the cabinet number, for example "cab0, fan1". Table 26. HP_NParPowerCoolingDomain extrinsic methods Class HP_NParPowerCoolingDomain contains no extrinsic methods. HP_NParRemoteComplex Class (Concrete Class) The HP_NParRemoteComplex class represents remote service processors that this provider can access.
the remove service processor. string Password Local The password required to access the remote service processor via LAN. This property is "write-only". It is necessary to create the instance, but will not be present in the instance when it is fetched from the provider. Table 28.
processor is changed or reassigned to a different system. MpPassword (management processor password) is required when the namespace is for a remote MP otherwise it is ignored. If the operation is successful, 0 will be returned. If the operation fails, an exception will be thrown and no value returned. string NameSpaceName() Retrieve the namespace name that a client should use to access this remote complex through the provider. Return the IP address for a given namespace.
Indications and Queries generated by this provider This provider does not support indications or queries. Associations provided by this provider This provider supports 8 associations. Tables 30 - 39 describe these associations. HP_NParCellConnectedToIOChassis (Association Class) ......................................... 46 HP_NParComponentInSlot (Abstract Association Class) ........................................... 46 HP_NParCellInSlot (Association Class)............................................
Property Name Property Inheritance Property Value (and data source) HP_NParSlot ref ContainingSlot Local Reference to an HP_NParSlot containing a component. HP_NParComponent ref ContainedComponent Local Reference to the HP_NParComponent contained in the slot. HP_NParCellInSlot (Association Class) Table 32 lists the properties of an association between cell slots and their installed cells. The ID of an HP_NParCell will be equal to the ID of the HP_NParCellSlot in which it is installed. Table 32.
HP_NParSlotInCabinet (Abstract Association Class) Table 34 lists the properties of an association between cabinets and their contained component slots. This is an abstract class. The provider does not support obtaining instances of this class directly. Table 34. HP_NParSlotInCabinet properties Property Name Property Inheritance Property Value (and data source) HP_NParCabinet ref ContainingCabinet Local Reference to an HP_NParCabinet containing a slot.
HP_NParCabinet ref ContainingCabinet HP_NParIOChassisSlot ref ContainedSlot Local Reference to an HP_NParCabinet containing an I/O chassis slot Local Reference to the HP_NParIOChassisSlot contained in the cabinet. HP_NParCellSlotInPartition (Association Class) Table 37 lists the properties of an association between nPartitions and their assigned cell slots. This information is also contained in the CellAssignments property of the HP_NParComplex class. Table 37.
HP_NParLocalPartition Class (Association Class) Table 39 lists the association between the complex as a whole and the nPartition on which the provider is running, if any. Note that a provider need not run on an nPartition in a partitionable system, since via the HP_NParRemoteComplex object, it can access data for a remote partitionable complex by communicating directly with the service processor of that complex over the LAN.
about the WBEM infrastructure and administration information, see the WBEM manual or the man pages. For information about Microsoft’s implementation of the WBEM standard for Windows (WMI), see the Microsoft Platform SDK/WMI. Managed Resource Documentation For detailed information about nPartitions, refer to HP System Partitions Guide: Administration for nPartitions. 5. Known Defects And Performance Considerations Performance Considerations.
o JAGae78762: For Superdome IO Expansion cabinets (IOX), the provider reports both even and odd numbered IO chassis slots, however the even numbered slots are not accessible/inoperable. Therefore, any operations (e.g., SetLED) attempted on these even numbered IO chassis slots will result in errors (exception thrown: “Target not present”). For now, client applications should ignore/filter-out even numbered IO Chassis slots returned by the provider for superdome IOX cabinets.
