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. Provider Overview ( Description, Requirements, Release History, Supported Managed Resources, Special Requirements & Dependencies )
2. Setting Up This Provider ( Installing, Configuring )
3. Using This Provider ( Schema Supported, Indications and Queries Generated Associations Provided )
4. Links To More Information ( Additional Provider Documentation, WBEM Information, Managed Resource Information )
5. Known Defects And Performance Considerations
·
Description
This provider is for use by clients that will examine and change the
configuration of HP partitionable servers, such as HP Superdome. The
provider implements a set of classes and associations that model components and
aspects of partitionable systems, including a partitionable complex as a whole,
cabinets, cells and cell slots, I/O chassis and their slots, nPartitions, the
Complex Profile, power domains, and cooling domains, along with associations
among these components.
·
Requirements
The nPartition Provider is implemented and tested on HP-UX 11i v2
(B.11.23), Microsoft Windows 2000 SP3, Windows XP, Windows Server 2003 (32-bit
and 64-bit editions), Red Hat Enterprise Linux AS v.3 Update 2, Red Hat Enterprise
Linux AS v.3 Update 3, Red Hat Enterprise Linux AS v.4, and Suse Linux
Enterprise Server 9.
· Microsoft Windows
2.1.3: Adds properties
for determining Hyper-Threading capabilities and status; Adds support for enabling/disabling
Hyper-Threading on nPartitions that support Hyper-Threading.
2.1.0: Adds support for
Arches platforms; 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.1: Fix for setting
core cell choices (HP_NParPartition); Fixes a Windows-specific (byte-ordering)
problem parsing IPMI ASF messages.
1.2.0: Adds compatibility with WMI Mapper 1.2.; Memory
leak fixes (mostly Windows-specific).
1.0.0: Microsoft Windows
initial release (32-bit only).
· HP-UX
B.23.01.05.01: HP-UX 11i v2
December 2005 update.
B.11.11.01.04.00.01: HP-UX 11i v1
September 2005 update.
B.11.23.01.04.00.01: HP-UX 11i v2 May
2005 update.
B.11.11.01.03.00.02: HP-UX 11i v1 December
2004 update.
B.11.23.01.03.00.06: HP-UX
11i v2 September 2004 update. Minor
defect fixes. Support for PA-RISC.
B.01.02.00.02: HP-UX 11i
v2 March 2004 update. Minor defect
fixes.
B.01.00: HP-UX 11i v2
initial release.
· Linux
1.03: Initial Linux release.
·
Supported Managed Resources
This provider supports configuration and management of nPartitions on HP
server systems. In combination with the
HP nPartition Commands the provider supports management of any nPartition
running any supported operating system.
·
Special Requirements & Dependencies
Management of a remote complex requires network connectivity to the managed
complex service processor. A separate
Instant Capacity (iCAP) WBEM provider (also delivered with HP-UX 11i) is
required for validating operations that might affect the iCAP status of the
complex. The iCAP provider is currently
not available on Microsoft Windows or Linux.
Therefore, Instant Capacity partitionable servers cannot currently be
managed fully through the nPartition Provider on Microsoft Windows or
Linux. When making changes on an iCAP
server, containing iCAP components (cells, CPUs, or memory), that could affect
the status of the iCAP 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.
· 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 (.msi) file is provided for installing the nPar provider on Microsoft
Windows 2000 SP3, Windows XP, and Windows Server 2003. Simply double-click the
.msi file to initiate the installation. Note that on Windows, the nPar provider
is installed as a WMI (Windows Management Instrumentation – Microsoft’s
implementation of the WBEM standard) provider, and therefore is accessible via
the WMI client API’s on Windows. You may also access the Windows nPar provider
using the Pegasus client API’s and the “WMI Mapper” (part of the Pegasus
distribution, also delivered and installed with the nPar provider on Windows).
·
Installing this Provider on
Linux: This provider is installed with the hp.com-npartition-providers RPM. The provider executable is: /opt/hp/nparprovider/lib/libHPNParProvider.1
·
Configuring this Provider: The provider is initially configured to
manage the complex on which the provider is installed. The provider can be
configured to manage remote complexes by creating instances of the class HP_NParRemoteComplex. A
client application can create an instance of this class to configure the
provider to access a particular remote complex, and delete the instance to
deconfigure the provider so that it cannot access that remote complex.
·
Schema supported by this provider
The tables below describe the properties and methods supported by the
provider. The property tables have 3 columns. The first is
the property name including types and units. The second is the property
inheritance, including which class or superclass defines the property.
The third is a description of the possible values and, where relevant, the data
source for each property. Each row describes a property. The tables
of extrinsic methods (those that are explicitly declared in each class) also
have 3 columns. The first lists the method name and signature. The
second describes the action of the method and all return values and
arguments. The third column lists exceptions that might be thrown by the
method, if any.
HP_NParPotentialErrorObject (Abstract Class)
HP_NParProfile (Abstract Class)
HP_NParComplex (Concrete Class)
HP_NParPartition (Concrete Class)
HP_NParDynamicProfile (Concrete Class)
HP_NParCabinet (Concrete Class)
HP_NParCellSlot (Concrete Class)
HP_NParIOChassisSlot (Concrete Class)
HP_NParComponent (Abstract Class)
HP_NParIOChassis (Concrete Class)
HP_NParPowerCoolingDomain (Concrete Class)
HP_NParRemoteComplex Class (Concrete Class)
This is an abstract class. No instances exist. Queries to get names or instances of this class are not directly supported. This class is a superclass for those objects that must be locked to be read or written, or for which other errors may occur when attempting to retrieve data about the object.
|
Property Name |
Property Inheritance |
Property Value (and data source) |
|
Sint32 ErrorCode |
Local |
A numeric error code indicating the type of error encountered. The property is not present unless an error was encountered when the object instance was requested. See NParErrorCodes.h (nPar Provider SDK) for a list of possible error codes. |
|
string ErrorMessage |
Local |
A message corresponding to the error code. The property is not present unless an error was encountered when the object instance was requested. |
|
string LockOwner |
Local |
A string indicating the entity that has locked the object instance. The property is not present unless the ErrorCode property contains a value indicating that the object was locked when it was requested. |
|
datetime LockTime |
Local |
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. |
Class HP_NParPotentialErrorObject contains no extrinsic methods.
HP_NParProfile is a subclass of HP_NParPotentialErrorObject. This is an abstract class. No instances exist. Queries to get names or instances of this class are not directly supported. This class models objects that form the Complex Profile maintained in stable storage.
|
Property Name |
Property Inheritance |
Property Value (and data source) |
|
Uint32 SequenceNumber |
Local |
The sequence number of this profile. Sequence numbers are changed whenever a change to the profile is made. |
|
String MpPassword |
Local |
Password required to access a remote service processor when modifying an HP_NParProfile instance. User-settable. Write-only-property, e.g. the property is not present in an instance when read, but must be inserted to modify the instance on a remote service processor. Not required to modify an instance on the local complex. |
|
Sint32 ErrorCode |
See Table 1. |
|
|
string ErrorMessage |
See Table 1. |
|
|
string LockOwner |
See Table 1. |
|
|
datetime LockTime |
See Table 1. |
|
Method Name |
Description |
Exceptions thrown |
|
uint32 ForcedUnlockProfile( string MpPassword ) |
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 no-longer-running client. MpPassword (management processor password) is required when the namespace is for a remote MP otherwise it is ignored. On success, the lock has been cleared and 0 will be returned. On failure, an exception will be thrown and the lock will still be in effect. |
CIMOperationFailedException if the operation fails. |
HP_NParComplex is a subclass of HP_NParProfile. There are at most 2 instances of this class. One instance represents the complex as it currently exists. The other, if present, represents a new pending configuration that that the service processor is in either in the process of instantiating or waiting to instantiate. Pending complex data is not supported on all platforms. Extrinsic methods supported by HP_NParComplex are the same as those in HP_NParProfile. Note that on systems configured for Instant Capacity, the provider will not modify any instance of this class without approval from Instant Capacity software.
|
Property Name |
Property Inheritance |
Property Value (and data source) |
|
Uint32 ProfileID [Key] |
Local |
0 if this is the active complex configuration. 1 if this is the pending complex configuration. |
|
Uint32 SequenceNumber |
See Table 3. |
|
|
uint16 MajorRevisionNumber |
Local |
Most significant portion of the revision number for this profile layout. |
|
uint16 MinorRevisionNumber |
Local |
Least significant portion of the revision number for this profile layout. |
|
string RevisionString |
Local |
Major and minor revision numbers concatenated and separated by a period, e.g. "4.2". |
|
string ModelString |
Local |
A string identifying the model number of this complex, e.g. SD64000. This property is supported only on PA-RISC platforms. [Also see note at the end of this table.] |
|
string ComplexName |
Local |
The name of this complex. User-settable. |
|
string OriginalProductOrderNumber |
Local |
The product order number for this complex as originally delivered, e.g. AxxxxxA. If the complex has been upgraded, this will be the product order number before the upgrade. |
|
string CurrentProductOrderNumber |
Local |
The product order number for this complex as it current exists. If the complex has been upgraded, this will be the product order number after the upgrade. |
|
string CreatorManufacturer |
Local |
The name of the original manufacturer of the complex, e.g. "HP". |
|
string OEMManufacturer |
Local |
The name of an OEM manufacturer of the complex. This property may not be supported on all platforms. |
|
String CreatorProductName |
Local |
The name of the product as assigned by the original manufacturer of the complex, e.g., “SD64A”. This property is supported only on Itanium®-based platforms. [Also see note at the end of this table.] |
|
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. |
|
string OEMSerialNumber |
Local |
The serial number of the complex as assigned by an OEM manufacturer. This property may not be supported on all platforms. |
|
uint8 UUID[16] |
Local |
A 16-byte value used for software licensing. This property may not be supported on all platforms. |
|
uint8 CellType[] |
Local |
Array of values, indexed by cell ID. Identifies the type of each cell. Possible values are Unknown (0), Other (1), Floating (2), Base(3), and Free(4). User settable. On Instant Capacity systems, requires Instant Capacity software approval to modify. |
|
uint8 CellAssignments[] |
Local |
Array of values, indexed by cell ID. Provides the nPartition ID of the nPartition in to which this cell is assigned, or 255 if the cell has type equal to Free. User settable. . On Instant Capacity systems, requires Instant Capacity software approval to modify. |
|
uint8 GNISpecType[] |
Local |
Array of values indexed by cell ID. Specifies how to interpret the value in the property GNIPerCell. The possible values are Unknown(0), Other(1), 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. When the corresponding element of GNISpecType is Fraction, this value is the number of eigths of the cell’s memory that should be allocated as CLM, e.g. a value of 3 means that 3/8 of the cell’s memory should be allocated as CLM. When the corresponding value of GNISpecType is either AllCLM or NoCLM, this value is irrelevant, but these two values are equivalent to specifying Fraction and GNIPerCell of either 8 or 0, respectively. User settable. |
|
string DiagnosticLicenseID |
Local |
ID string for diagnostic software licensing purposes. |
|
uint8 MaxPartitionsSupported |
Local |
The maximum number of nPartitions that this complex can support. For example, an rp7410 system can support no more than 2 nPartitions. |
|
uint16 GSMSharing[16] |
Local |
This property contains information on whether or not Global Shared Memory (GSM) is enabled between two 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. No partition should be configured to share memory with another partition that is not sharing memory with it. In other words, if element 5 has bit 7 set then element 7 should have bit 5 set. Setting bit N in element N has no effect. The bit positions are represented in little endian manner. Changes to a partition's GSM sharing will not take effect until the partition is rebooted. |
|
uint8 GSMSharingType |
Local |
This property may be used to help interpret the values in the GSMSharing array, above. The possible values are: DisabledComplexWide(0) = All bits are cleared in the GSMSharing array = GSM sharing is disabled for ALL nPartitions in the complex (including any subsequently created nPartitions); EnabledComplexWide(1) = All bits are set in the GSMSharing array = ALL nPartitions are configured to allow GSM sharing with ALL other nPartitions in the complex; and 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. For example, setting GSMSharingType = 1 will cause the nPartition Provider to set all bits in the GSMSharing array. If you would like to specify GSM sharing on an individual nPartition basis, you must ensure the GSMSharingType is set to SeeGSMSharingArray(2). |
|
uint32 AffectedCells[] |
Local |
Array of cell IDs for those cells that are affected by a complex reconfiguration. This is non-empty only in a pending complex profile, and must be correctly set to modify the complex profile. User-settable. |
|
uint32 BootPartitions[] |
Local |
Array of nPartition IDs for those nPartitions that should be rebooted when a complex reconfiguration is completed. This property may be set when the complex profile is modified. It will be present only in a pending complex profile User-settable. |
|
boolean UserCanModify |
Local |
True if the user that requested the object has the authority to modify the complex. For the local complex, the user must have administrative privileges 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. |
|
boolean InterpartitionSecurityEnabled |
Local |
Fasle if nPartition Configuration Privilege is set to “unrestricted” for this complex. In this case, the service processor will permit configuration changes to nPartitions other than the one from which the request is made. When true, the privilege is set to “restricted”, and the service processor will permit configuration changes only to the nPartition from which the request was made. This applies only when the request is made for the local complex where the provider is running. Configuration changes are never restricted for a remote complex, where the requirement for a password affords additional security.
|
|
String MpPassword |
See Table 3. |
|
|
sint32 ErrorCode |
See Table 1. |
|
|
string ErrorMessage |
See Table 1. |
|
|
string LockOwner |
See Table 1. |
|
|
datetime LockTime |
See Table 1. |
NOTE: PA-RISC platforms support ModelString, and do not support CreatorProductName or OEMProductName. Itanium®-based platforms support 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..
|
Method Name |
Description |
Exceptions thrown |
|
uint32 ForcedUnlockProfile( string MpPassword ) |
See Table 4. |
See Table 4. |
|
uint32 CancelPendingProfile( string MpPassword ) |
Cancels a pending complex profile. The method will return success (0), but do nothing if there is no pending profile. The method will fail if the service processor has already distributed the pending profile to one or more cells and so cannot cancel the pending profile. MpPassword (management processor password) is required when the namespace is for a remote MP otherwise it is ignored. |
CIMOperationFailedException if the operation fails. |
HP_NParPartition is a subclass of HP_NParProfile. Instances of this class represent nPartitions in a partitionable complex. This class supports the same extrinsic methods as HP_NParProfile. Note that on systems configured for Instant Capacity, the provider will not modify any instance of this class without approval from Instant Capacity software.
|
Property Name |
Property Inheritance |
Property Value (and data source) |
|
uint32 PartitionID [Key] |
Local |
The ID of this nPartition in the complex. |
|
uint32 SequenceNumber |
See Table 3. |
|
|
uint8 PartitionType |
Local |
Type of cells in this nPartition. Values are Unknown(0), Other(1), PA-RISC(2), and Itanium®-based(3) |
|
boolean PartitionIsDefined |
Local |
True if this partition currently exists (has been configured in the complex), otherwise false. |
|
string PartitionLabel |
Local |
A display string formed from the nPartition number, e.g. "par2". |
|
string PartitionName |
Local |
The name of this nPartition. This value needn't be unique within a complex. User settable. |
|
string PartitionNameLabel |
Local |
Concatenation of the nPartition name and its label, e.g. "MyPartition (par2)". |
|
boolean IsLocalPartition |
Local |
True if the nPartition provider handling the request is running on this nPartition in the complex. |
|
boolean CellUseOnNextBoot[] |
Local |
Array of true/false values indexed by cell ID. Indicates whether the cell should be incorporated into the nPartition when the nPartition is booted. This does not affect the nPartition or the cell until the nPartition is booted. If the indexed cell is not part of the nPartition, the value is ignored. User settable. On Instant Capacity systems, requires approval by Instant Capacity software to modify. |
|
uint32 CoreCellID |
Local |
The cell ID of the core cell for this nPartition, or 255 if the nPartition is not booted. |
|
uint8 MaxSizeCoreCellChoices |
Local |
The maximum size of the array in the CoreCellChoices property. |
|
uint32 CoreCellChoices[] |
Local |
An array of cell ID's, with maximum length given by MaxSizeCoreCellChoices, giving the order in which system firmware should 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. If the array is empty, or no valid core cell is found among the choices, the system will automatically select a core cell from among those cells in the nPartition that are core-cell capable. If no functional cell is core-cell capable, the nPartition will not boot. User settable. |
|
boolean BootWithoutConsole |
Local |
True if the nPartition should be booted without waiting for console input. False if console input should be required for the nPartition to boot. Supported only on PA-RISC nPartitions. User settable |
|
boolean RebootOnError |
Local |
True if the OS should be automatically rebooted after a catastrophic error. False if the OS should not be booted after an error. Supported only on PA-RISC nPartitions. User settable. |
|
uint8 KnownGoodMemory |
Local |
Amount of zero-based memory that must be error free for the nPartition to boot. Supported only on PA-RISC nPartitions. |
|
string AdminIPAddress |
Local |
The IP address at which a WBEM server running on this nPartition can be contacted when the nPartition is booted. User settable. |
|
uint8 BootTimer |
Local |
Number of seconds to wait for a response from the boot device before trying the next boot deviceS upported only on PA-RISC nPartitions. User-settable. |
|
uint16 IcodData |
Local |
Data used by Instant Capacity. User-settable. Modification of this property requires approval by Instant Capacity software on complexes with Instant Capacity installed. |
|
uint8 FailureUsage[] |
Local |
Array of values indexed by cell ID. Specifies the policy for how a cell is to be booted with the nPartition when one or more CPU or DIMM failures have been detected during self-tests but the cell remains usable. Values are Unknown(0), Other(1), Normal(2) (use the cell as in the CellType array in the HP_NParComplex instance), NoInterleave(3) (use the cell, but do not use its memory as interleaved memory), and Deconfigure(5) (do not use the cell.) User-settable. |
|
boolean MultithreadingEnabled |
Local |
This property enables Hyper-Threading. Hyper-Threading allows multiple threads to run concurrently on each CPU. Look at the property MultithreadCapable on HP_NParCell to see if a cell supports Hyper-Threading. A value of True means that Hyper-Threading is enabled. See the property MultithreadingActive on HP_NParCell to determine if threads are active. |
|
Boolean BootPathsAreAvailable |
Local |
True when the following boot path data is present and settable, false otherwise. Boot path data is present and settable for all nPartitions on PA-RISC systems, but only for the nPartition on which the provider handling the request is running on Itanium®-based systems running HP-UX. Boot path data is not present when the provider is running on a Windows or Linux operating system. |
|
string PrimaryBootPath |
Local |
The primary boot path for this nPartition. Present and settable when BootPathsAreAvailable is true.. User-settable. |
|
boolean PrimaryAutosearch |
Local |
True if autosearch should be enabled for the primary boot device. Present and settable for all nPartitions on PA-RISC platforms. Not supported on Itanium®-based platforms. User-settable. |
|
boolean PrimaryAutoboot |
Local |
True if autoboot should be enabled for the primary boot device. Present and settable when BootPathsAreAvailable is true.. Note that on Itanium®-based platforms, all three of PrimaryAutoboot, Alternate Autoboot, and HAAlternateAutoboot must contain the same value. User-settable. |
|
string AlternateBootPath |
Local |
The alternate boot path for this nPartition. Present and settable for all nPartitions on PA-RISC platforms, but will be present and settable only for the nPartition on which the provider is running on Itanium®-based platforms... User-settable. |
|
boolean AlternateAutosearch |
Local |
True if autosearch should be enabled for the alternate boot device. Present and settable for all nPartitions on PA-RISC platforms, not supported on Itanium®-based platforms. User-settable. |
|
boolean AlternateAutoboot |
Local |
True if autoboot should be enabled for the alternate boot device. Present and settable when BootPathsAreAvailable is true.. Note that on Itanium®-based platforms, all three of PrimaryAutoboot, Alternate Autoboot, and HAAlternateAutoboot must contain the same value. User-settable. |
|
string HAAlternateBootPath |
Local |
The HA alternate boot path for this nPartition. Present and settable when BootPathsAreAvailable is true.. User-settable. |
|
boolean HAAlternateAutosearch |
Local |
True if autosearch should be enabled for the HA alternate boot device. Present and settable for all nPartitions on PA-RISC platforms, not supported on Itanium®-based platforms. User-settable. |
|
boolean HAAlternateAutoboot |
Local |
True if autoboot should be enabled for the HA alternate boot device. Present and settable when BootPathsAreAvailable is true.. Note that on Itanium®-based platforms, all three of PrimaryAutoboot, Alternate Autoboot, and HAAlternateAutoboot must contain the same value. User-settable. |
|
uint8 OSSupportsGNI |
Local |
Does the operating system instance on which the nPartition provider is running support Global Non-Interleaved (GNI) memory or Cell Local Memory (CLM). Values are Unknown(0), Yes(1), No(2). |
|
uint8 OSSupportsCellOLA |
Local |
True when the operating system instance on which the nPartition provider is running supports Cell On-line Addition (OLA). Possible values are Unknown(0), Yes(1), No(2). |
|
uint8 OSSupportsCellOLD |
Local |
True when the operating system instance on which the nPartition provider is running supports Cell On-line Deletion (OLD). Values are Unknown(0), Yes(1), No(2). |
|
string MpPassword |
See Table 3. |
|
|
sint32 ErrorCode |
See Table 1. |
|
|
string ErrorMessage |
See Table 1. |
|
|
string LockOwner |
See Table 1. |
|
|
datetime LockTime |
See Table 1. |
|
Method Name |
Description |
Exceptions thrown |
|
uint32 ForcedUnlockProfile( string MpPassword ) |
See Table 4. |
See Table 4. |
|
uint32 ResetForReconfiguration( string MpPassword ) |
Requests a reset for reconfiguration of this nPartition. The reset for reconfiguration will reset the nPartition in the same manner as the “rr” command at the service processor command menu. The nPartition will be left in the inative state after this method is invoked, i.e. the Boot Inhibit Bit (BIB) will be set for all cells in the nPartition. If the nPartition is inactive, the method has no effect. Not supported on nPartitions with no assigned cells. Warning: This method will immediately terminate all operating system instances and all applications on the affected nPartition. It will not return if the provider is running on an affected nPartition, as the provider itself will be terminated. For that reason, this method should not be used for the local partition. See the 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. |
CIMOperationFailedException if the operation fails. |
|
uint32 BootPartition( string MpPassword ) |
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. Depending on the value of the autoboot flag for this nPartition, the operating system may not be booted. If the nPartition is already active, the method has no effect. Not supported on nPartitions with no assigned cells. 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. |
CIMOperationFailedException if the operation fails. |
HP_NParDynamicProfile is a subclass of HP_NParProfile. This class is currently used by HP Instant Capacity software for proprietary purposes. Client applications may not modify this profile without authorization from Instant Capacity software. There is only one instance of this class in any complex. This class supports the same extrinsic methods as HP_NParProfile.
|
Property Name |
Property Inheritance |
Property Value (and data source) |
|
uint32 ProfileID [Key] |
Local |
ID of this profile. Always 0. |
|
uint32 SequenceNumber |
See Table 3. |
|
|
uint64 IcodCheckSum |
Local |
Write-only property. Not present when the instance is read by the system, but a valid value obtained from Instant Capacity software must be added to any instance that will be modified to authorize the modification. User-settable. |
|
uint8 IcodData[] |
Local |
Array of un-interpreted bytes stored in this profile. User-settable. |
|
String MpPassword |
See Table 3. |
|
|
sint32 ErrorCode |
See Table 1. |
|
|
string ErrorMessage |
See Table 1. |
|
|
string LockOwner |
See Table 1. |
|
|
datetime LockTime |
See Table 1. |
|
Method Name |
Description |
Exceptions thrown |
|
uint32 ForcedUnlockProfile( string MpPassword ) |
See Table 4. |
See Table 4. |
Instances of the HP_NParCabinet class represent cabinets in a partitionable system complex.
|
Property Name |
Property Inheritance |
Property Value (and data source) |
|
uint32 ID [Key] |
Local |
ID of this cabinet in the complex. |
|
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. |
|
uint8 CoolingDomainCount |
Local |
Number of cooling domains in this cabinet. |
|
uint8 CabinetType |
Local |
Values are: Unknown(0), Other(1), 8-cell full height cabinet(2), 4-cell full height cabinet(3), 4-cell half-height cabinet(4), 2-cell cabinet(5), I/O expansion cabinet(6). Examples of these cabinet types: 8-cell full height cabinet (SD-32000), 4-cell full-height cabinet (SD-16000), 4-cell half-height cabinet (rp8620), 2-cell cabinet (rx7620). |
|
boolean IsPairedCabinet |
Local |
True if this cabinet is paired with another compute cabinet in the complex. False if the cabinet is standalone, is an I/O expansion cabinet, or is paired only with an I/O expansion cabinet. |
|
string Label |
Local |
Display string containing the cabinet number, e.g. "cab0". |
|
string ServiceProcessorLongLabel |
Local |
Long display name for the service processor in this cabinet, e.g "Maintenance Processor" or "Guardian Service Processor". |
|
string ServiceProcessorShortLabel |
Local |
Abbreviated display name for the service processor in this cabinet, e.g "MP" or "GSP". |
|
string ServiceProcessorCount |
Local |
Number of service processors in this cabinet. |
|
string ServiceProcessorLocation[] |
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. On cabinets where the service processor is located on a core I/O card, it will include a specification of which core i/O card, e.g. "cab0, coreio0". |
|
string ServiceProcessorStatus[] |
Local |
Array of the status of any service processors in this cabinet, in the same order as ServiceProcessorLocation above. Values are: Unknown(0), Other(1), Active(2), Backup(3). |
|
uint8 LEDState |
Local |
State of the attention indicator for this cabinet. Values are: Unknown(0), Other(1), Unsupported(2), Steady(3), Flashing(4). Unsupported is used if the cabinet does not have an attention indicator, e.g on the rp8410. Platforms are not required to support this property. |
|
Method Name |
Description |
Exceptions thrown |
|
uint32 FlashLED( boolean Flash, string MpPassword ) |
When the Flash argument is true, change the state of the cabinet attention indicator to Flashing. When false, change the cabinet attention indicator to Steady. 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. |
CIMNotSupportedException if the cabinet does not have a cabinet attention indicator. CIMOperationFailedException if the operation fails. |
The HP_NParSlot class is an abstract class. No instances exist. Queries to get names or instances of this class are not directly supported.
|
Property Name |
Property Inheritance |
Property Value (and data source) |
|
uint32 ID [Key] |
Local |
ID of the cell slot in the complex |
|
uint8 Number |
Local |
Number of the slot within its container. |
|
uint32 CabinetID |
Local |
ID of the cabinet in which this slot is located. |
|
string ShortLabel |
Local |
Display name for this slot within its container, e.g. "slot1". |
|
string LongLabel |
Local |
Display name for this slot including its containers, e.g. "cab0, slot1". |
|
boolean Populated |
Local |
True if this slot is occupied by a component. |
|
uint8 LEDState |
Local |
State of the attention LED for this slot. Values are Unknown(0), Other(1), Unsupported(2), Steady(3), Flashing(4), Off(5). Unsupported is used if the slot does not have an attention indicator, e.g. an I/O chassis slot on an rp7410 cabinet. Platforms are not required to support this property |
|
Method Name |
Description |
Exceptions thrown |
|
uint32 SetLED( uint8 newState, string MpPassword ) |
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. If the operation fails, an exception will be thrown and no value returned. |
CIMOperationFailedException if the operation fails. CIMNotSupportedException if the slot does not have an attention indicator. |
HP_NParCellSlot is a subclass of HP_NParSlot. This class represents cell slots in a cellular, partitionable complex.
|
Property Name |
Property Inheritance |
Property Value (and data source) |
|
uint32 ID [Key] |
Global cell ID of the cell slot within the complex. |
|
|
uint8 Number |
Number of the cell slot within its cabinet. |
|
|
uint32 CabinetID |
ID of the cabinet in which this slot is located. |
|
|
string ShortLabel |
Display name for this cell slot within its cabinet, e.g. "cell1". |
|
|
string LongLabel |
Display name for this slot including its cabinet number, e.g. "cab0, cell1". |
|
|
boolean Populated |
See Table 13. |
|
|
uint8 LEDState |
See Table 13. |
|
Method Name |
Description |
Exceptions thrown |
|
uint32 SetLED( uint8 newState , string MpPassword) |
See Table 14. |
See Table 14. |
|
uint32 MakeID( uint8 CabinetID, uint8 SlotNumber ) |
Return the correct ID for a cell slot in cabinet CabinetID and slot number SlotNumber within that cabinet. |
None. |
HP_NParIOChassisSlot is a subclass of HP_NParSlot. This class represents I/O Chassis slots in a partitionable complex.
|
Property Name |
Property Inheritance |
Property Value (and data source) |
|
uint32 ID [Key] |
Global ID of the I/O chassis slot within the complex. |
|
|
uint8 Number |
Number of the I/O chassis slot within its I/O bay |
|
|
uint8 IOBayNumber |
Local |
Number of the I/O bay within the cabinet where the slot is located. |
|
uint32 CabinetID |
ID of the cabinet in the complex where the slot is located. |
|
|
string ShortLabel |
Display name for this chassis slot within its container, e.g. "chassis1". |
|
|
string LongLabel |
Display name for this chassis slot including its container, e.g. "cab0, bay1, chassis1". |
|
|
boolean Populated |
See Table 13. |
|
|
uint8 LEDState |
See Table 13. |
|
Method Name |
Description |
Exceptions thrown |
|
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 is a subclass of HP_NParPotentialErrorObject. This is an abstract base class for the HP_NParCell and HP_NParIOChassis classes. No instances exist. Queries to get names or instances of this class are not directly supported.
|
Property Name |
Property Inheritance |
Property Value (and data source) |
|
uint32 SlotID [Key] |
Local |
ID of the HP_NParSlot in which this component is located. |
|
uint8 ComponentStatus |
Local |
Status of this component. Values are: Unknown(0), Other(1), Powered Off(2), Powering On(3), Inactive(4), Active(5). A component is powering on when power has been turned on, but it is still performing power-on self-tests (POST). A component is Inactive if it has completed POST, but has not joined its nPartition. This may be because the component is not assigned to a nPartition, if it is assigned to a nPartition and the nPartition is not active, if the component failed during nPartition boot, if the component was assigned to 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 component will be active, for example, while the OS is still in the boot process. The status will be unknown if a failure occurred while getting the data for this component. |
|
sint32 ErrorCode |
See Table 1. |
|
|
string ErrorMessage |
See Table 1. |
|
|
string LockOwner |
See Table 1. |
|
|
datetime LockTime |
See Table 1. |
|
Method Name |
Description |
Exceptions thrown |
|
uint32 PowerOn( boolean TurnOn, string MpPassword ) |
When TurnOn = true, turn on power to the component. When TurnOn = false, turn off power to the component. 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. |
CIMOperationFailedException if the operation fails. |
The HP_NParCell class is a subclass of HP_NParComponent. This class represents cells in a cellular, partitionable complex.
|
Property Name |
Property Inheritance |
Property Value (and data source) |
|
uint32 SlotID [Key] |
ID of the HP_NParCellSlot in which the cell is located. |
|
|
uint8 ComponentStatus |
See Table 19. |
|
|
sint32 ErrorCode |
See Table 1. |
|
|
string ErrorMsg |
See Table 1. |
|
|
string LockOwner |
See Table 1. |
|
|
datetime LockTime |
See Table 1. |
|
|
uint8 DIMMSlotCount |
Local |
Number of DIMM slots on this cell. NOTE: This property may not be available when the cell is powered off. |
|
uint64 TotalMemoryInstalled |
Local |
Amount of memory installed on the cell, in megabytes. NOTE: This property may not be available when the cell is powered off. |
|
uint64 TotalMemoryOK |
Local |
Amount of functional memory installed on the cell, in megabytes. NOTE: This property may not be available when the cell is powered off. |
|
boolean DIMMSlotPopulated[] |
Local |
Array, indexed by DIMM slot number, indicating whether the slot contains a DIMM. NOTE: This property may not be available when the cell is powered off. |
|
uint8 DIMMType[] |
Local |
Array, indexed by DIMM slot number, indicating the type of DIMM in the slot. A value of 0 indicates an “unknown” DIMM type. Otherwise, the meaning of 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. |
|
uint16 DIMMSize[] |
Local. |
Array, indexed by DIMM slot number, giving the size of the DIMM in the slot in megabytes. An element of this array is 0 if the corresponding element in DIMMSlotPopulated is false. NOTE: This property may not be available when the cell is powered off. |
|
string DIMMLabel[] |
Local |
Array, indexed by DIMM slot number, giving the label of the DIMM slot as stenciled on the cell board. NOTE: This property may not be available when the cell is powered off. |
|
uint8 DIMMStatus[] |
Local |
Array, indexed by DIMM slot number, giving the status of the DIMM in the slot. Values are: Unknown(0), Other(1), SWDeconfig(2), HWDeconfig(3), UnsupportedType(4), TypeMismatch(5), Failed(6), OK(7). The value is Other if the corresponding element of DIMMSlotPopulated is false. SWDeconfig is used when the operating system 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. NOTE: This property may not be available when the cell is powered off. |
|
uint32 ActualGNIMemory |
Local |
Amount of Global Non-Interleaved memory (GNI) actually allocated on this cell. (Note: GNI is another name for Cell Local Memory (CLM).) This value may differ from the amount requested in the GNIPerCell property of the HP_NParComplex object when the specific memory configuration on each cell requires system firmware to make adjustments for optimal interleaving or to satisfy minimum interleave size requirements. NOTE: This property may not be available when the cell is powered off. |
|
uint8 MaxInterleaveCount |
Local |
The maximum number of interleave regions supported by this platform. NOTE: This property may not be available when the cell is powered off. |
|
uint8 InterleaveCount |
Local |
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. |
|
uint32 InterleaveContribution[] |
Local |
An array of size InterleaveCount indexed by interleave region number. Specifies the amount of memory in megabytes allocated from this cell to the corresponding interleave region. For example, element 0 contains the amount of memory from this cell in interleave region 0. NOTE: This property may not be available when the cell is powered off. |
|
uint32 MaxCPUCount |
Local |
The maximum number of processors supported on this cell, accounting for both the number of processor module slots and the maximum number of processors per module supported by this platform. The value may not reflect the maximum number of processors in this cell given the number of processor per module actually installed. The maximum number of processors per module supported by this system can be computed by dividing this value by CPUModuleSlotCount. |
|
uint32 MaxThreadsSupportedByFW |
Local |
Maximum number of threads supported by the system firmware (FW). Note: on platforms that support multiple CPUs per module, and multiple threads per CPU, this is the number of module slots times the number of CPUs per module times the number of threads per CPU. This property has the same value as MaxCPUCount on platforms that do not support Multithreading. On platforms that support Multithreading this will be different than MaxCPUCount. NOTE: This property may not be available when the cell is powered off. |
|
uint32 ThreadsPerCPUSupportedByHW |
Local |
Maximum number of threads supported by the CPUs on this cell. NOTE: This property may not be available when the cell is powered off. |
|
Unit8 CPUModuleSlotCount |
Local |
The number of processor module slots on this cell. A processor module may contain 1 or more processors. |
|
uint8 CPUCount |
Local |
The actual number of processors on this cell. |
|
uint8 CPUCountOK |
Local |
The number of installed processors that are configured for use. Processors may be deconfigured by the OS or by system firmware. NOTE: This property may not be available when the cell is powered off. |
|
uint8 CPUCountPerModule |
Local |
The number of processors per processor module on this cell. Some platforms support more than one processor per module. The maximum number of processors that is supported on this cell can be computed by multiplying the CPUModuleSlotCount by this value. Note that this will not match the value of the MaxCPUCount property, if the currently installed processor modules contain fewer processors per module than the maximum supported by system firmware on the complex. |
|
uint32 CPUClockDomain |
Local |
The clock domain value of the processors. This property is valid only for PA-RISC processors. It will always be 0 for Itanium®-based processors. |
|
uint32 CPUSpeed |
Local |
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. |
|
uint8 CPUModuleNumber[] |
Local |
Array of size MaxCPUCount, indexed by CPU slot number. Maps CPU slots to their assigned CPU modules. Element [C] gives the ID of the CPU module to which CPU slot C is assigned. A value of 255 indicates a non-existent/un-assigned CPU slot. |
|
boolean CPUSlotPopulated[] |
Local |
Array, indexed by processor slot number. True when the processor slot is populated. Note that the processor slot number divided by the CPUCountPerModule will give the processor module slot number. All processor slots where that value is equal are in the same processor module. |
|
uint8 CPUStatus[] |
Local |
Array, indexed by processor slot number. Provides the status of the processor in that slot. Values are: Unknown(0), Other(1), Deconfigured(2), OK(3). Other is used if the processor slot is not populated. |
|
uint8 CPUModuleType |
Local |
The processor module compatibility value. This value must be the same for all cells in an nPartition. |
|
uint16 CPUFrequencyType |
Local |
The processor frequency compatibility value. This value must be the same for all cells in an nPartition. |
|
boolean MultithreadingActive |
Local |
True if Hyper-Threading is active on this cell. NOTE: This property may not be available when the cell is powered off. |
|
uint8 CellBoardType |
Local |
The cell board compatibility value. This value must be the same for all cells in an nPartition. |
|
uint8 CellComplexType |
Local |
The cell complex compatibility value. This value must be the same for all cells within the complex. |
|
string CompatibilityLabel |
Local |
A displayable string formed from the CellComplexType, CellBoardType, CPUModuleType, and CPUFrequencyType to indicate the compatibility of this cell with other cells. |
|
uint8 CellArchitecture |
Local |
The architecture of the processors on this cell. Values are Unknown(0), Other(1), PA-RISC(2), and Itanium®-based(3) |
|
uint8 CellUsage |
Local |
The type of cell based on how it is being used by its nPartition. This value may differ from the value requested in the CellType property of HP_NparComplex either because the nPartition is active and CellType has been changed since the nPartition booted, or because the cell usage was affected by the 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. Deconfigured indicates the cell has not joined the nPartition. This property is valid only when the nPartition is active (i.e, the cell is active). |
|
uint16 IODCVersion |
Local |
Cell IODC firmware version. This property is valid only for PA-RISC cells. It will be 0xFFFF for all cells that do not contain PA-RISC processors. |
|
uint32 FirmwareMajorNumber |
Local |
The most significant part of the system firmware revision. This value must be the same for all cells in an nPartition. |
|
uint32 FirmwareMinorNumber |
|
The least significant part of the system firmware revision. This value must be the same for all cells in an nPartition. |
|
string FirmwareRevision |
Local |
A displayable string for the firmware revision number consisting of the major number separated from the minor number by a period, for example 4.2. |
|
boolean ConnectedToIOChassis |
Local |
True if this cell is connected to an IO chassis |
|
uint32 ConnectedIOChassisID |
Local |
I/O Chassis ID of the chassis to which the cell is connected. The property is not present if ConnectedToIOChassis is false. |
|
boolean REOInitialized |
Local |
True if the System Bus Adapter (SBA) link between the cell and the I/O chassis connected to the cell has been initialized. False if the cell is not connected to an I/O chassis, if the link has not been initialized, or the link has failed. (Note: REO is another name for SBA ) |
|
boolean HasCoreIO |
Local |
True if the I/O chassis connected to the cell has a core I/O card. False if the cell is not connected to an I/O chassis or the I/O chassis does not have a core I/O card. |
|
boolean PCIOlradCapable |
Local |
True if system firmware on the cell supports PCI I/O card online replacement, addition, and deletion. |
|
boolean GSMSupportCapable |
Local |
True if system firmware on the cell supports Global Shared Memory (GSM). |
|
boolean CellPowerControlCapable |
Local |
True if system firmware on the cell supports powering cells on or off. |
|
boolean CellOlradCapable |
Local |
True if system firmware on the cell supports cell online replacement, addition and deletion. |
|
boolean IOChassisPowerControlCapable |
Local |
True if system firmware on the cell supports powering I/O chassis on and off. |
|
boolean IOChassisOlradCapable |
Local |
True if system firmware on the cell supports I/O chassis online replacement, addition and deletion. |
|
boolean CabinetOlradCapable |
Local |
True if system firmware on the cell supports cabinet online addition and deletion. |
|
boolean MultithreadCapable |
Local |
True if the CPUs on the cell support Hyper-Threading. |
|
sint32 ErrorCode |
See Table 1. |
|
|
string ErrorMessage |
See Table 1. |
|
|
string LockOwner |
See Table 1. |
|
|
datetime LockTime |
See Table 1. |
|
Method Name |
Description |
Exceptions thrown |
|
uint32 PowerOn( boolean TurnOn, string MpPassword ) |
See Table 20. |
See Table 20. |
The HP_NParIOChassis class is a subclass of HP_NParComponent. This class represents the I/O chassis that contain I/O cards.
|
Property Name |
Property Inheritance |
Property Value (and data source) |
|
uint32 SlotID |
ID of the HP_NParIOChassisSlot in which this chassis is located. |
|
|
uint8 ComponentStatus |
See Table 19. |
|
|
boolean Connected |
Local |
True if the chassis is connected to a cell. |
|
uint32 ConnectedCellID |
Local |
ID of the cell to which the chassis is connected, or 255 if the chassis is not connected to a cell. |
|
boolean HasCoreIO |
Local |
True if this chassis contains a core I/O card. |
|
uint8 PCISlotCount |
Local |
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. |
|
uint8 PopulatedPCISlotCount |
Local |
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. |
|
string PCISlotLabel[] |
Local |
A displayable string giving the label of the PCI I/O card slot. The string contains the cabinet number, I/O bay number, chassis number, and slot number separated by dashes, each as stenciled on the system. For example, 0-1-2-3 is slot 3 in I/O chassis 2 in I/O bay 1 of cabinet 0. NOTE: This property may not be available when the connected cell is powered off. |
|
boolean PCISlotPopulated[] |
Local |
Array indexed by PCI I/O card slot number within the chassis that contains the slot. True, if this PCI slot is populated with a card. NOTE: This property may not be available when the connected cell is powered off. |
|
uint32 PCICardVendorID[] |
Local |
Array indexed by PCI I/O card slot number within the chassis that contains the slot. Provides the vendor 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. |
|
uint32 PCICardDeviceID[] |
Local |
Array indexed by PCI I/O card slot number within the chassis that contains the slot. 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. |
|
uint32 PCICardClass[] |
Local |
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 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. |
|
uint32 PCICardLabel[] |
Local |
Array indexed by PCI I/O card slot number within the chassis that contains the slot. Provides a display string based on the PCI class of the card from the PCI config header on the card in the slot. For example, "PCI SCSI host bus adapter" might be a value used for a SCSI card. The value is the empty string if the slot is empty. NOTE: This property may not be available when the connected cell is powered off. |
|
sint32 ErrorCode |
See Table 1. |
|
|
string ErrorMessage |
See Table 1. |
|
|
string LockOwner |
See Table 1. |
|
|
datetime LockTime |
See Table 1. |
|
Method Name |
Description |
Exceptions thrown |
|
uint32 PowerOn( boolean TurnOn, string MpPassword ) |
See Table 20. |
See Table 20. |
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.
|
Property Name |
Property Inheritance |
Property Value (and data source) |
|
uint32 ID [Key] |
Local |
A unique ID for this domain within the complex |
|
uint32 CabinetID |
Local |
The ID of the cabinet in which this domain is located. |
|
uint8 DomainNumber |
Local |
The number of this domain within the cabinet |
|
uint8 DomainType |
Local |
The type of this domain. Values are: Unknown(0), Other(1), Power(2), Cooling(3) |
|
uint8 DomainSubtype |
Local |
The portion of the cabinet on which this domain operates. Values are: Unknown(0), Other(1), Cabinet(2), I/O (3), Backplane(4) |
|
uint8 SlotCount |
Local |
The number of slots for units in this domain. Power domains contain power supply units. Cooling domains contain fan or blower units. |
|
uint8 UnitCount |
Local |
The number of units installed in this domain. |
|
uint8 FailedCount |
Local |
The number of installed units in this domain that have failed. |
|
uint8 RedundancyState |
Local |
The redundancy state of this domain. Values are: Unknown(0), Other(1), N+ (2), N(3), N-(4), Housekeeping only(5), Not Applicable(6). N+ indicates 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. It indicates that only housekeeping power is available. Housekeeping power is sufficient to operate the service processor, but not any other components. Not applicable indicates that redundancy state does not apply to that domain. For example, I/O cooling domains do not have a redundancy state. |
|
string UnitTypeLabel |
Local |
The display name for the kind of units in the domain, for example, "fan" or "blower". |
|
boolean UnitPresent[]; |
Local |
An array indexed by slot number indicating whether a unit is installed in that slot. |
|
boolean UnitFailed[]; |
Local |
An array indexed by slot number indicating whether the unit installed in the slot has failed. If no unit is installed in the slot, the value will be false. |
|
string ShortUnitLabel[] |
Local |
An array indexed by slot number giving a short label 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". |
Class HP_NParPowerCoolingDomain contains no extrinsic methods.
The HP_NParRemoteComplex class represents remote service processors that this provider can access. It provides a mechanism for clients to transmit the necessary access control data for a remote service processor to the provider. The provider will use this data to access the remote service processor via the LAN.
Before accessing a remote complex, the client must first create an instance of this class with the address and password in the main namespace for the provider, root/cimv2/npar. At that time, the provider will cache the access data and retrieve and cache some complex configuration data from the remote complex. This data is static in nature, and as long as the given address is assigned to the same complex service processor, it will be valid for that complex.
To retrieve data for remote complex, the client must make requests of the provider using the namespace as returned by the NameSpaceName method. The provider will create this namespace and ensure that the provider is registered for this namespace when the HP_NParRemoteComplex object is created. When finished, the client should delete the remote complex instance. However, the new namespace is left in place, as well as the cached configuration data, since these will not change.
In the rare event of an IP address being reassigned, the provider can either be disabled and then re-enabled or the CIM server can be stopped and then restarted to clear all caches, or a client can call the UpdateComplex method to cause the provider to update its cache of static configuration data.
If the password for the remote service processor is changed via the command menu for that processor, the provider can be updated to the new password with the ChangePassword method.
|
Property Name |
Property Inheritance |
Property Value (and data source) |
|
string Address [Key] |
Local |
A hostname or IP address for 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. |
|
Method Name |
Description |
Exceptions thrown |
|
uint32 ChangePassword( string OldPassword, string newPassword ) |
Change the password for this remote complex from oldPassword to NewPassword. This method changes only the value of the password that the provider uses to access the remote service processor. It does not change the password on the service processor itself. When the password for the service processor is changed through the service processor Command Menu, the provider may be updated with this method. If the operation is successful, 0 will be returned. If the operation fails, an exception will be thrown and no value returned. |
CIMOperationFailedException if the operation fails. CIMAccessDeniedException if the old password does not match the one stored by the provider, or if the new password is incorrect for the target service processor. |
|
uint32 UpdateComplex( string MpPassword ) |
Update the cached information that the provider holds about the remote complex configuration. Use of this method should be necessary only when IP address associated with the Address value for the service 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. |
CIMOperationFailedException if the operation fails. |
|
string NameSpaceName() |
Retrieve the namespace name that a client should use to access this remote complex through the provider. |
None. |
|
string NameSpaceAddress( string RemoteNameSpace ) |
Return the IP address for a given namespace. This is a class wide method and does not have to be called on a specific HP_NParRemoteComplex instance. |
CIMInvalidParameterException if RemoteNameSpace is not a valid namespace for a remote complex. |
Table 29 describes the supported intrinsic methods of the classes in this schema.
|
Method Name |
Supported By |
|
createInstance |
|
|
deleteInstance |
|
|
modifyInstance |
|
|
getInstance |
All classes |
|
enumerateInstances |
All classes |
|
enumerateInstanceNames |
All classes |
·
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)
HP_NParComponentInSlot (Abstract Association Class)
HP_NParCellInSlot (Association Class)
HP_NParIOChassisInSlot (Association Class)
HP_NParSlotInCabinet (Abstract Association Class)
HP_NParCellSlotInCabinet (Association Class)
HP_NParIOChassisSlotInCabinet (Association Class)
HP_NParCellSlotInPartition (Association Class)
HP_NParDomainInCabinet (Association Class)
HP_NParLocalPartition Class (Association Class)
Intrinsic Methods (Association Classes)
Table 30 lists the properties of an association between cells and their connected I/O chassis. This data is also embedded in the HP_NParCell and HP_NParIOChassis classes, which both contain properties giving the ID of the component to which they are connected.
|
Property Name |
Property Inheritance |
Property Value (and data source) |
|
HP_NParCell ref ConnectedCell |
Local |
Reference to an HP_NParCell connected to an I/O chassis. |
|
HP_NParIOChassis ref ConnectedIOChassis |
Local |
Reference to the HP_NParIOChassis connected to the cell. |
Table 31 lists the properties of an association between slots and their installed components. This is an abstract class. The provider does not support obtaining instances of this class directly.
|
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. |
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.
|
Property Name |
Property Inheritance |
Property Value (and data source) |
|
HP_NParCellSlot ref ContainingSlot |
Reference to an HP_NParCellSlot containing a cell. |
|
|
HP_NParCell ref ContainedComponent |
Reference to the HP_NParCell contained in the slot. |
Table 33 lists the properties of an association between I/O chassis slots and their installed chassis. This data is also encoded in the ID's. The ID of an HP_NParIOChassis will be equal to the ID of the HP_NParIOChassisSlot in which it is installed.
|
Property Name |
Property Inheritance |
Property Value (and data source) |
|
HP_NParIOChassisSlot ref ContainingSlot |
Reference to an HP_NParIOChassisSlot containing a chassis. |
|
|
HP_NParIOChassis ref ContainedComponent |
Reference to the HP_NParIOChassis installed in the slot. |
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.
|
Property Name |
Property Inheritance |
Property Value (and data source) |
|
HP_NParCabinet ref ContainingCabinet |
Local |
Reference to an HP_NParCabinet containing a slot. |
|
HP_NParSlot ref ContainedSlot |
Local |
Reference to the HP_NParSlot contained in the cabinet. |
Table 35 lists the properties of an association between cabinets and their contained cell slots. This data is also encoded in the HP_NParCellSlot objects. Each has a property for the cabinet in which it is located.
|
Property Name |
Property Inheritance |
Property Value (and data source) |
|
HP_NParCabinet ref ContainingCabinet |
Local |
Reference to an HP_NParCabinet containing a cell slot |
|
HP_NParCellSlot ref ContainedSlot |
Local |
Reference to the HP_NParCellSlot contained in the cabinet. |
Table 36 lists the properties of an association between cabinets and their contained I/O chassis slots. This data is also encoded in the HP_NParIOChassisSlot objects. Each has a property for the cabinet in which it is located.
|
Property Name |
Property Inheritance |
Property Value (and data source) |
|
HP_NParCabinet ref ContainingCabinet |
Local |
Reference to an HP_NParCabinet containing an I/O chassis slot |
|
HP_NParIOChassisSlot ref ContainedSlot |
Local |
Reference to the HP_NParIOChassisSlot contained in the cabinet. |
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.
|
Property Name |
Property Inheritance |
Property Value (and data source) |
|
HP_NParPartition ref ContainingPartition |
Local |
Reference to an HP_NParPartition containing a cell slot |
|
HP_NParCellSlot ref ContainedCellSlot |
Local |
Reference to the HP_NParCellSlot contained in the nPartition. |
Table 38 lists the properties of an association between cabinets and their contained power and cooling domains. This data is also encoded in the HP_NParPowerCoolingDomain objects. Each has a property for the cabinet in which it is located.
|
Property Name |
Property Inheritance |
Property Value (and data source) |
|
HP_NParCabinet ref ContainingCabinet |
Local |
Reference to an HP_NParCabinet containing a power or cooling domain |
|
HP_NParPowerCoolingDomain ref ContainedDomain |
Local |
Reference to the HP_NParPowerCoolingDomain contained in the cabinet. |
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. If the provider is not running on an nPartition, there will be no instances of this class.
|
Property Name |
Property Inheritance |
Property Value (and data source) |
|
HP_NParComplex ref ContainingComplex |
Local |
Reference to an HP_NParComplex |
|
HP_NParPartition ref ContainedPartition |
Local |
Reference to the HP_NParPartition in this complex on which the provider is running. |
Table 40 lists the intrinsic methods supported for each association class.
|
Method Name |
Supported Classes |
|
createInstance |
None |
|
modifyInstance |
None |
|
deleteInstance |
None |
|
getInstance |
All associations |
|
enumerateInstances |
All associations |
|
enumerateInstanceNames |
All associations |
·
Additional Provider Documentation
There is currently no additional documentation for this provider.
·
WBEM information
For a CIM tutorial, go to http://www.dmtf.org/education/cimtutorial.
For information about the Pegasus WBEM infrastructure, see http://www.opengroup.org/pegasus.
For information about WBEM and a list of providers/clients available, see the Pegasus Home Page. For information
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.
· Performance Considerations.
o The retrieval of the static configuration data fetched by the provider when a new HP_NParRemoteComplex object is created may take a significant amount of time, ranging from a few seconds to more than a minute, depending on the network distance from the provider to the remote complex. This data, however, will only be fetched once and will remain cached either until the provider is disabled, the CIM server stopped, or the UpdateComplex method called on the HP_NParComplex.
o A similar delay may be encountered even for the local complex. The same set of static configuration data is retrieved and cached for the local complex. This occurs when the first request for any data from the local complex occurs. This data, as in the remote case, is fetched once and remains in effect until the provider is disabled or the CIM server is stopped.
o While this static configuration data may be as large as 250 KB or more, only the minimum set of necessary data is cached by the provider. The long-term caching of this data should not be a memory usage consideration.
o When it is necessary to request more than a single instance of a class defined in this schema, it is more efficient to use enumerateInstances than to use enumerateInstanceNames and then getInstance for each instances name returned. In some cases, particularly for power/cooling domains, cells and I/O chassis, the difference may be significantly more than simply the overhead of the extra WBEM requests needed for the second approach.
· Known Defects
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.
o JAGae78437: On Superdome systems with dual compute cabinets, the 2nd cabinet (cabinet 1) reports a service processor with state=”Backup”(3), when in fact the service processor is not present (HP_NParCabinet.ServiceProcessorCount for cabinet 1 should be 0).