HP Scripting Tools for Windows PowerShell User Guide OA Cmdlets Abstract This document contains instructions for using HP Scripting Tools for Windows PowerShell to manage HP Onboard Administrator (OA). It is intended for system administrators who use the HP Scripting Tools for Windows PowerShell to manage their IT infrastructure.
© Copyright 2014 Hewlett-Packard Development Company, L.P. Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. The information contained herein is subject to change without notice.
Contents 1 Introduction to HP Scripting Tools for Windows PowerShell...............................4 Windows PowerShell.................................................................................................................4 Features..................................................................................................................................4 2 Installation.................................................................................................5 System prerequisites....
1 Introduction to HP Scripting Tools for Windows PowerShell The HP Scripting Tools for Windows PowerShell provides a simplified and consistent infrastructure management experience. These sets of PowerShell utilities provide comprehensive HP integration tools. These tools are designed for IT experts with experience in PowerShell scripting and configuring HP ProLiant server hardware.
2 Installation System prerequisites The following prerequisites must be met before installing HP OA Cmdlets for Windows PowerShell. There are also several items to consider in the install. • • Microsoft Management Framework 3.0 or later (which includes PowerShell 3.0 or later) must be installed on your system before installing the HP Scripting Tools for Windows PowerShell. Microsoft .NET Framework 4 or later must be installed before installing Microsoft Management Framework 3.0 or later.
2. In the Run dialog enter the path and filename of the correct installer for your system, either the 64-bit (HPOACmdlets-x64.msi) or the 32-bit (HPOACmdlets-x86.msi). • Close any PowerShell windows and open new ones after the installation is complete. • It might be necessary to change the execution policy for PowerShell.
3 HP Scripting Tools for Windows PowerShell cmdlets Table 1 provides a list and brief description of all the HP OA Cmdlets for Windows PowerShell. Cmdlet Help The HP OA Cmdlets are supported by help, which is used in the same way as other PowerShell cmdlets.
Table 1 HP OA Cmdlets for Windows PowerShell (continued) Cmdlet Description Clear-HPOAVCMode All servers in the enclosure should be powered off before clearing the VCMODE. Connect-HPOA Connects to an OA and creates an SSH session. Disconnect-HPOA Closes an SSH session with the OA. Find-HPOA Find list of OA in a specified subnet. Get-HPOABladeDeviceSerialNumber Shows the specified direct attached blade device serial number. Get-HPOACACertificate Displays a list of installed CA certificates.
Table 1 HP OA Cmdlets for Windows PowerShell (continued) Cmdlet Description Get-HPOAInterconnectSession Displays which users have serial console sessions in progress for each interconnect. Get-HPOAInterconnectStatus Displays interconnect status information; UID state and health state. Get-HPOALanguage Displays all language support packs installed. Get-HPOALDAPCertificate Displays all LDAP certificates that are in effect on the OA.
Table 1 HP OA Cmdlets for Windows PowerShell (continued) 10 Cmdlet Description Get-HPOAUpgradableDevice Displays enclosure devices that are available for firmware upgrade. Get-HPOAUpTime Displays uptime for the OA. Get-HPOAUSB Displays which USB controller is currently enabled. Get-HPOAUSBKey Displays a list of firmware images, configuration scripts, ISO images and other binary files present on the enclosure USB media. Get-HPOAUser Displays all the user list or the specified user's details.
Table 1 HP OA Cmdlets for Windows PowerShell (continued) Cmdlet Description Set-HPOAEBIPA Enables or disables the OA to provide IP addresses to the devices in the bays using DHCP. This cmdlet also modifies EBIPA settings for bay device(s). Set-HPOAEnclosure Sets the Enclosure details. Set-HPOAEnclosureiLOFederationSupport Enables or disables OA support required to allow peer-to-peer network communication necessary for iLO Federation. Set-HPOAEnclosureIPMode Enables or disables Enclosure IP Mode.
Table 1 HP OA Cmdlets for Windows PowerShell (continued) 12 Cmdlet Description Set-HPOASessionTimeout Sets the number of minutes before inactive sessions are removed. Set-HPOASLAAC Enables or disables the auto-configuration of IPv6 addresses from SLAAC messages. Set-HPOASNMP Enables or disables SNMP and modifies SNMP settings. Set-HPOAStrongPassword Enables or disables strong password requirements for user passwords. Set-HPOASysLogRemote Enables or disables remote system logging.
IPv6 support Consider the following when using IPv6. • IPv6 is supported on OA firmware version 3.5 or later • IPv6 is supported in addition to IPv4 for network addresses on all cmdlets that have an IP address parameter. The double colon zero subnet format for IPv6 addresses is supported. For example, 1a00::1fe8 equates to 1a00:0000:0000:0000:0000:0000:0000:1fe8. • Address ranges are supported with the dash character.
StatusMessage : OK Firmware : 3.11 ProductName : c3000 Tray with embedded DDR2 Onboard Administrator IP Hostname StatusType StatusMessage Firmware ProductName : : : : : : 192.168.242.63 westwind.company.net OK OK 4.11 BladeSystem c7000 DDR2 Onboard Administrator with KVM IP Hostname StatusType StatusMessage Firmware ProductName : : : : : : 192.168.242.64 southwind.company.net OK OK 4.
Get-HPOAPower -Verbose $EncInfo Script output: The following is typical output from this script. Warning : It might take a while to search all the HP OA servers if the input is a very large range. Use Verbose for more information. VERBOSE: Using 6 threads for search VERBOSE: Pinging 192.168.242.60 VERBOSE: Pinging 192.168.242.61 VERBOSE: Pinging 192.168.242.62 VERBOSE: Pinging 192.168.242.63 VERBOSE: Pinging 192.168.242.64 VERBOSE: Pinging 192.168.242.65 VERBOSE: No OA at 192.168.242.
found by Find-HPOA. Without the –Verbose parameters you would see the Warning line from Find-HPOA and the power information for the three OAs found in that range of addresses. Using the Get-HPOAModuleVersion and Update-HPOAModuleVersion cmdlets These cmdlets are used to determine the current version of the HPOACmdlets module installed and update the HPOACmdlets module if necessary. The Get-HPOAModuleVersion cmdlet has no parameters.
Connect-HPOA : Failed for 192.168.242.61:A connection attempt failed because the connected party did not properly respond after a period of time, or established connection failed because connected host has failed to respond 192.168.242.61:22 At line:1 char:1 + Connect-HPOA 192.168.242.61 -Username Administrator -Password Admin + ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + CategoryInfo : InvalidData: (:) [Connect-HPOA], HPOAErrorMsg + FullyQualifiedErrorId : HPOACmdlets.
$sevcnts | Format-Table } Disconnect-HPOA $conObj This script again uses the Find-HPOA cmdlet to locate OAs. It adds username and password and then connects to the OAs. The Get-HPOASysLog cmdlet is used with the -Target parameter set to iLO and the -Bay parameter set to 4. This gets the iLO logs from Bay 4 in the two OAs found. (You may notice that this code is very similar to log processing code in the HP Scripting Tools for Windows PowerShell User Guide iLO Cmdlets.
$sevcnts = $ilo.Bay[$b].Syslog | group-object -property SEVERITY –noelement "There are " + $uniqsev.Count + " type(s) of events in the IML log in Bay $($b+1).” $sevcnts | Format-Table } } } Disconnect-HPOA $conObj Script output: Warning : It might take a while to search all the HP OA servers if the input is a very large range. Use Verbose for more information. VERBOSE: Using 3 threads for search VERBOSE: Pinging 192.168.242.63 VERBOSE: Pinging 192.168.242.64 VERBOSE: Pinging 192.168.242.
2. 3. 4. 5. 6. Execute the appropriate command interactively to retrieve the data. After viewing the command results, decide what part of the object you are interested in. Determine OAs or other sources of information that will drive the process. Create the main processing loop. Summarize or output the data in the desired format. If there are many steps, repeat the process until all of the requirements of the data collection or setting have been completed.
4 Troubleshooting General issues Verifying OA firmware versions If a problem occurs, your first action should be to verify that the most current versions of OA firmware are installed. Updating to the most current firmware might solve the problem. For information on updating OA firmware, see the HP BladeSystem Onboard Administrator User Guide or the Update-HPOAFirmware cmdlet..
5 Support and other resources Contacting HP For worldwide technical support information, see the HP support website: http://www.hp.com/support Before contacting HP, collect the following information: • Error messages • Operating system type and revision level • Detailed questions Support Information HP offers a number of additional software support services, many of which are provided to our customers at no additional charge.
6 Documentation feedback HP is committed to providing documentation that meets your needs. To help us improve the documentation, send any errors, suggestions, or comments to Documentation Feedback (docsfeedback@hp.com). Include the document title and part number, version number, or the URL when submitting your feedback.
Index C T cmdlet help, 7 contact support, 22 contacting HP, 22 troubleshooting, 21 iLO firmware versions, 21 D uninstalling, 6 U documentation providing feedback on, 23 W E Windows PowerShell, 4 resources, 22 examples log processing , 17 F features, 4 Find-HPOA cmdlet, 13 H HP OA Cmdlets for Windows PowerShell, 12 HP Scripting Tools for Windows PowerShell features, 4 installation, 5 introduction, 4 HP Support Center, 22 I iLO firmware versions, 21 installation, 5 prerequisites, 5 supported ope