HPE Apollo Platform Manager User Guide Abstract This guide provides installation and operation guidance for the HPE Apollo Platform Manager. This guide is for the person who installs, administers, and troubleshoots servers and storage systems. Part Number: 800013-007 Published: July 2018 Edition: 7 © Copyright 2014-2018 Hewlett Packard Enterprise Development LP Notices The information contained herein is subject to change without notice. The only warranties for Hewlett Packard Enterprise products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. Hewlett Packard Enterprise shall not be liable for technical or editorial errors or omissions contained herein. Confidential computer software. Valid license from Hewlett Packard Enterprise 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. Links to third-party websites take you outside the Hewlett Packard Enterprise website. Hewlett Packard Enterprise has no control over and is not responsible for information outside the Hewlett Packard Enterprise website. Acknowledgments Microsoft® and Windows® are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries. Contents Introduction................................................................................................11 HPE Apollo Platform Manager overview............................................................................................11 APM kit contents................................................................................................................................12 APM front view..................................................................................................................................12 APM rear view...................................................................................................................................14 APM connections...............................................................................................................................14 Required connections.............................................................................................................16 RDM1 port identification.........................................................................................................23 RDM2 and RDM3 port identification.......................................................................................24 HPE SL Advanced Power Manager Rack Distribution Module.........................................................24 HPE Intelligent Modular PDU-Managed Extension Bar.....................................................................25 HPE APM Environmental Module for Apollo w6000..........................................................................26 Using RJ-45 connections...................................................................................................................27 Naming and numbering conventions.................................................................................................27 Rack chassis numbering...................................................................................................................28 Automatic discovery..........................................................................................................................30 Installation and configuration.................................................................. 31 Prerequisites for installation..............................................................................................................31 APM installation guidelines................................................................................................................31 Configuring the serial port.................................................................................................................31 Configuring the APM.........................................................................................................................32 Using the configuration wizard................................................................................................32 Network configuration.............................................................................................................33 User accounts....................................................................................................................................35 Adding an account..................................................................................................................35 Removing an account.............................................................................................................36 Showing accounts...................................................................................................................37 RADIUS authorization.............................................................................................................37 Configuring LDAP authentication............................................................................................38 Using the GUI.............................................................................................40 Enabling the APM GUI......................................................................................................................40 Accessing the GUI.............................................................................................................................40 Secure web access.................................................................................................................41 Accounts............................................................................................................................................41 Accessing the User Maintenance page..................................................................................42 Interface components........................................................................................................................48 Icon classifications and color status indicators.......................................................................48 Main menu navigation bar.................................................................................................................51 APM Information.....................................................................................................................52 Linked APMs...........................................................................................................................54 Power Usage Report..............................................................................................................55 Log..........................................................................................................................................63 Inventory/Single Sign-On........................................................................................................65 Configuration..........................................................................................................................67 Cooling Distribution (CDU).....................................................................................................70 Rack Thermal Status..............................................................................................................71 Contents 3 Consolidated Management Ports......................................................................................................73 Accessing the Consolidate Management Ports page.............................................................73 Component details..................................................................................................................74 Rack Distribution Module...................................................................................................................76 Accessing the Rack Distribution Module page.......................................................................76 Component details..................................................................................................................77 Alerts.................................................................................................................................................79 Viewing alerts with the Consolidated Management Port page...............................................79 Viewing the Alert Log..............................................................................................................80 Logging off.........................................................................................................................................81 Accessing help..................................................................................................................................82 Using the Command Line Interface......................................................... 83 Command line conventions...............................................................................................................83 Accessing the APM CLI.....................................................................................................................83 Accessing the CLI using SSH.................................................................................................83 Accessing the CLI using Telnet...............................................................................................84 Accessing the CLI using the APM serial port..........................................................................84 Saving configurations........................................................................................................................85 General commands...........................................................................................................................85 Working with passwords.........................................................................................................85 Working with zones.................................................................................................................87 Basic configuration information...............................................................................................89 Reboot and Reset commands................................................................................................92 Topology and inventory...........................................................................................................93 Linked APM modules............................................................................................................105 Using the help.......................................................................................................................107 Using iLO Single Sign-On.......................................................................108 iLO Single Sign-On overview...........................................................................................................108 Requirements for using SSO...........................................................................................................108 Security access modes....................................................................................................................108 Enabling SSO..................................................................................................................................108 Showing the SSO certificate............................................................................................................109 Disabling SSO.................................................................................................................................109 Logging.....................................................................................................111 Overview of logging..........................................................................................................................111 Internal logging.................................................................................................................................111 Showing and clearing the event log......................................................................................111 Showing and clearing the fault log........................................................................................112 External logging...............................................................................................................................113 Power capping......................................................................................... 114 Power capping overview..................................................................................................................114 Power capping and measurement tolerance...................................................................................114 Invalidating a power baseline..........................................................................................................114 APM and APM Distribution Module cabling.....................................................................................115 Rack-level power capping................................................................................................................115 Power baseline.....................................................................................................................115 Setting power capping..........................................................................................................116 Power commands............................................................................................................................123 4 Contents Displaying the rack power status..........................................................................................124 Setting power........................................................................................................................126 Polling servers for power values...........................................................................................126 Disabling the polling of servers for power values.................................................................127 Using SNMP............................................................................................. 128 SNMP overview...............................................................................................................................128 SNMP commands............................................................................................................................128 Enabling SNMP....................................................................................................................128 Displaying SNMP parameters...............................................................................................128 Setting the SNMP read-only community string.....................................................................129 Setting the SNMP read-write community string....................................................................129 Setting the SNMP contact.....................................................................................................129 Setting the SNMP location....................................................................................................129 Setting SNMP trap destinations............................................................................................130 SNMP support of cpqHoSwRunningTable.......................................................................................130 Using XML................................................................................................132 XML overview..................................................................................................................................132 XML headers........................................................................................................................132 XML output...........................................................................................................................132 Data types.............................................................................................................................132 Response definitions............................................................................................................132 Enabling XML..................................................................................................................................134 Showing and resetting keys.............................................................................................................134 Logging in through XML..................................................................................................................134 Modifying the user account..............................................................................................................135 Interacting with the APM using XML................................................................................................135 Requesting firmware version................................................................................................135 Requesting configuration information...................................................................................135 Modifying configuration information......................................................................................136 Requesting rack topology.....................................................................................................139 Requesting rack information.................................................................................................141 Requesting power load information......................................................................................142 Requesting compute node power status..............................................................................142 Requesting compute power node status..............................................................................143 Requesting and modifying pollpower information.................................................................143 Requesting the MAC address...............................................................................................144 Modifying the UID.................................................................................................................144 Requesting the event log......................................................................................................146 Requesting the event log......................................................................................................146 Requesting the fault log........................................................................................................147 Clearing the fault log.............................................................................................................147 Requesting thermal status....................................................................................................147 Requesting thermal setpoints...............................................................................................148 Requesting iCDU information...............................................................................................148 Requesting Linked APM information....................................................................................148 Requesting baseline information..........................................................................................148 Requesting zone information................................................................................................149 Setting a global power cap...................................................................................................149 Setting a power cap for a specific zone................................................................................149 Requesting the onboard clock..............................................................................................150 Setting the onboard clock.....................................................................................................150 Resetting APM.................................................................................................................................150 Contents 5 Using APM RESTful API..........................................................................152 APM RESTful API overview............................................................................................................152 Tips for using the RESTful API.............................................................................................152 Accessing the APM RESTful API....................................................................................................152 RESTful API discovery....................................................................................................................153 RESTful API Authentication.............................................................................................................153 Basic authentication..............................................................................................................153 Redfish session login authentication....................................................................................153 RESTful API eventing......................................................................................................................153 RESTful API commands..................................................................................................................154 Firmware...................................................................................................155 Upgrading the APM firmware..........................................................................................................155 Upgrading the HPE Apollo Environmental Module firmware...........................................................155 Upgrading the APM and the Environmental Module firmware together..........................................157 Troubleshooting.......................................................................................159 Devices not discovered...................................................................................................................159 Alert messages................................................................................................................................159 CLI commands.........................................................................................160 Add account.....................................................................................................................................160 Add APM.........................................................................................................................................160 Add iCDU.........................................................................................................................................160 Add RADIUS server.........................................................................................................................160 Add zone.........................................................................................................................................161 Clear faults......................................................................................................................................161 Clear log..........................................................................................................................................161 Clear name......................................................................................................................................161 Clear screen....................................................................................................................................162 Disable Ethernet..............................................................................................................................162 Disable Linked APM........................................................................................................................162 Disable NTP....................................................................................................................................162 Disable password............................................................................................................................162 Disable pollpower............................................................................................................................163 Disable RADIUS..............................................................................................................................163 Disable Redfish...............................................................................................................................163 Disable Redfish discovery...............................................................................................................163 Disable SNMP.................................................................................................................................163 Disable SSH....................................................................................................................................164 Disable SSO....................................................................................................................................164 Disable Telnet..................................................................................................................................164 Disable XML....................................................................................................................................164 Enable Ethernet...............................................................................................................................164 Enable GUI......................................................................................................................................164 Enable Linked APM.........................................................................................................................165 Enable NTP.....................................................................................................................................165 Enable password.............................................................................................................................165 Enable pollpower.............................................................................................................................165 Enable RADIUS...............................................................................................................................165 Enable Redfish ...............................................................................................................................165 6 Contents Enable Redfish discovery................................................................................................................166 Enable SNMP..................................................................................................................................166 Enable SSH.....................................................................................................................................166 Enable SSO.....................................................................................................................................166 Enable telnet....................................................................................................................................166 Enable XML.....................................................................................................................................167 Enable XML secure.........................................................................................................................167 Exit...................................................................................................................................................167 Help.................................................................................................................................................167 Logout..............................................................................................................................................167 Ping.................................................................................................................................................167 Quit..................................................................................................................................................168 Reboot.............................................................................................................................................168 Reboot CM......................................................................................................................................168 Remove account..............................................................................................................................168 Remove APM..................................................................................................................................169 Remove iCDU..................................................................................................................................169 Remove RADIUS server..................................................................................................................169 Remove SSO...................................................................................................................................169 Remove zone..................................................................................................................................169 Reset...............................................................................................................................................170 Reset buddy....................................................................................................................................170 Reset factory...................................................................................................................................170 Reset keys.......................................................................................................................................170 Reset port........................................................................................................................................170 Save................................................................................................................................................171 Save config......................................................................................................................................171 Save zones......................................................................................................................................171 Set APM target................................................................................................................................171 Set ChassisFRU..............................................................................................................................171 Set door close front.........................................................................................................................172 Set door close rear..........................................................................................................................172 Set door open front..........................................................................................................................172 Set door open rear...........................................................................................................................172 Set IP...............................................................................................................................................172 Set asset info...................................................................................................................................172 Set gateway.....................................................................................................................................173 Set name.........................................................................................................................................173 Set NTP poll....................................................................................................................................173 Set NTP server................................................................................................................................174 Set password...................................................................................................................................174 Set power........................................................................................................................................174 Set power baseline..........................................................................................................................175 Set power cap..................................................................................................................................175 Set power cap mode........................................................................................................................175 Set power cap poll...........................................................................................................................176 Set RADIUS pollnum.......................................................................................................................176 Set RADIUS pollsec........................................................................................................................176 Set serial..........................................................................................................................................176 Set SNMP contact...........................................................................................................................177 Set SNMP location..........................................................................................................................177 Set SNMP RO.................................................................................................................................177 Set SNMP RW.................................................................................................................................177 Set SNMP trapdest..........................................................................................................................177 Set syslog........................................................................................................................................178 Set time...........................................................................................................................................178 Set timeout......................................................................................................................................179 Contents 7 Show accounts................................................................................................................................179 Show APM.......................................................................................................................................179 Show asset info...............................................................................................................................179 Show Chassis Bootloader...............................................................................................................180 Show config.....................................................................................................................................180 Show fan info...................................................................................................................................180 Show faults......................................................................................................................................181 Show iCDU......................................................................................................................................181 Show iCDU full................................................................................................................................181 Show iCDU status...........................................................................................................................181 Show info.........................................................................................................................................181 Show iLO.........................................................................................................................................181 Show keys.......................................................................................................................................182 Show log..........................................................................................................................................182 Show MAC address.........................................................................................................................182 Show name......................................................................................................................................182 Show NTP server............................................................................................................................182 Show NTP poll.................................................................................................................................183 Show power.....................................................................................................................................183 Show power baseline......................................................................................................................183 Show rack........................................................................................................................................183 Show RADIUS.................................................................................................................................184 Show servers...................................................................................................................................184 Show SNMP....................................................................................................................................184 Show SSO certificate.......................................................................................................................185 Show syslog....................................................................................................................................185 Show thermal status........................................................................................................................185 Show throttle....................................................................................................................................185 Show time........................................................................................................................................185 Show topology.................................................................................................................................186 Show version...................................................................................................................................186 Show zones.....................................................................................................................................186 Upgrade Chassis Bootloader...........................................................................................................186 Upgrade image................................................................................................................................187 XML commands.......................................................................................188 Disable pollpower............................................................................................................................188 Disable Telnet..................................................................................................................................188 Disable SSH....................................................................................................................................188 Enable DHCP..................................................................................................................................189 Enable pollpower.............................................................................................................................189 Enable SSH.....................................................................................................................................190 Enable Telnet...................................................................................................................................190 Get all compute node power............................................................................................................191 Get APM information.......................................................................................................................191 Get compute node...........................................................................................................................191 Get configuration.............................................................................................................................192 Get firmware version.......................................................................................................................192 Get iCDU info..................................................................................................................................192 Get iLO IP address..........................................................................................................................193 Get node identification.....................................................................................................................194 Get power load................................................................................................................................194 Get rack information........................................................................................................................194 Get rack topology............................................................................................................................195 Get session information...................................................................................................................195 8 Contents Get thermal status...........................................................................................................................195 Login................................................................................................................................................196 Modify all compute node power.......................................................................................................196 Modify compute node power...........................................................................................................196 Modify configuration........................................................................................................................197 Modify compute node power...........................................................................................................197 Poll power........................................................................................................................................198 Reset APM......................................................................................................................................198 Set power cap mode........................................................................................................................198 Set power cap poll...........................................................................................................................199 LDAP commands.....................................................................................200 Add LDAP group..............................................................................................................................200 Enable LDAP...................................................................................................................................200 Remove LDAP group ......................................................................................................................200 Set LDAP group description ...........................................................................................................200 Set LDAP port..................................................................................................................................200 Set LDAP search.............................................................................................................................201 Set LDAP server..............................................................................................................................201 Show LDAP group information .......................................................................................................201 Show LDAP information .................................................................................................................201 Test LDAP........................................................................................................................................201 RESTful API Data Model Reference.......................................................203 Resource map.................................................................................................................................203 RESTful API Data Model Reference.....................................................................................203 RESTful API Data Model Reference.....................................................................................203 /redfish/v1/AccountService/Accounts...................................................................................203 /redfish/v1/AccountService/Accounts/{username}................................................................204 /redfish/v1/Chassis...............................................................................................................204 /redfish/v1/Chassis/HPE-APM..............................................................................................204 /redfish/v1/Chassis/RDM{RDMport}Enc{DMport}.................................................................204 /redfish/v1/Chassis/RDM{RDMport}Enc{DMport}/Power......................................................204 /redfish/v1/Chassis/RDM{RDMport}Enc{DMport}/Thermal...................................................205 /redfish/v1/Chassis/RDM{RDMport}Enc{DMport}Node{Node}.............................................205 /redfish/v1/Managers............................................................................................................205 /redfish/v1/Managers/HPE-APM...........................................................................................205 /redfish/v1/Managers/HPE-APM/EthernetInterfaces............................................................205 /redfish/v1/Managers/HPE-APM/EthernetInterfaces/{item}..................................................206 /redfish/v1/Managers/HPE-APM/LogServices......................................................................206 /redfish/v1/Managers/HPE-APM/LogServices/Events..........................................................206 /redfish/v1/Managers/HPE-APM/LogServices/Events/Entries..............................................206 /redfish/v1/Managers/HPE-APM/NetworkProtocol...............................................................206 /redfish/v1/Managers/HPE-APM/SerialInterfaces.................................................................206 /redfish/v1/Managers/HPE-APM/SerialInterfaces/{item}.......................................................206 /redfish/v1/Managers/RDM{RDMport}Enc{DMport}..............................................................207 /redfish/v1/Managers/RDM{RDMport}Enc{DMport}Node{Node}..........................................207 /redfish/v1/SessionService...................................................................................................207 /redfish/v1/SessionService/Sessions....................................................................................207 /redfish/v1/SessionService/Sessions/{item}..........................................................................207 /redfish/v1/Systems..............................................................................................................207 /redfish/v1/Systems/RDM{RDMPort}Enc{DMPort}Node{Node}............................................208 Data Model Type reference overview..............................................................................................208 Navigating the data model....................................................................................................208 Contents 9 AccountService.....................................................................................................................209 Chassis.................................................................................................................................209 Managers..............................................................................................................................209 Systems................................................................................................................................209 Message reference overview...........................................................................................................209 Supported MIB objects............................................................................216 Supported cpqRack MIB objects.....................................................................................................216 Supported cpqHostOs MIB objects.................................................................................................220 Supported rfc1213 MIB objects.......................................................................................................221 PDU identity table............................................................................................................................226 PDU input table...............................................................................................................................226 Support and other resources................................................................. 227 Accessing Hewlett Packard Enterprise Support..............................................................................227 Accessing updates..........................................................................................................................227 Customer self repair........................................................................................................................228 Remote support...............................................................................................................................228 Warranty information.......................................................................................................................228 Regulatory information....................................................................................................................229 Documentation feedback.................................................................................................................229 10 Contents
Description: