User Guide Pigeon Point Shelf Manager Release 3.7.1 May 15, 2018 nVent Schroff GmbH [email protected] www.pigeonpoint.com schroff.nVent.com This document is furnished under license and may be used or copied only in accordance with the terms of such license. The content of this manual is furnished for informational use only, is subject to change without notice, and should not be construed as a commitment by nVent. nVent assumes no responsibility or liability for any errors or inaccuracies that may appear in this book. Except as permitted by such license, no part of this publication may be reproduced, stored in a retrieval system, or transmitted, in any form or by any means, electronic, manual, recording, or otherwise, without the prior written permission of nVent. The Pigeon Point Shelf Manager uses an implementation of the MD5 Message-Digest algorithm that is derived from the RSA Data Security, Inc. MD5 Message-Digest algorithm. All nVent marks and logos are owned or licensed by nVent Services GmbH or its affiliates. All other trademarks are the property of their respective owners. nVent reserves the right to change specifications without notice. Pigeon Point Shelf Manager User Guide (May 15, 2018) Page 1 / 321 Table of contents 1 About this document 9 1.1 Shelf Manager documentation 9 1.1.1 Conventions used in this document 9 1.2 Additional resources 10 2 Introduction 11 2.1 In this section 11 2.2 Intelligent Platform Management: an ATCA overview 11 2.3 Pigeon Point Board Management Reference: hardware and firmware 14 2.4 Pigeon Point Shelf Manager and ShMM 15 2.4.1 Pigeon Point Shelf Manager features 15 2.4.2 Support for dual redundant operation 16 2.4.3 System Manager Interface 18 2.4.4 Pigeon Point ShMM Shelf Management Mezzanines 19 3 Configuration 22 3.1 In this section 22 3.2 Setting up U-Boot 22 3.2.1 U-Boot environment variables 24 3.2.2 Assigning values to environment variables 34 3.2.3 Configuring U-Boot environment variables for the Shelf Manager 34 3.2.4 Establishing the secondary RC script 37 3.3 Setting up Shelf Manager configuration file 38 3.3.1 Carrier-specific configuration file 96 3.3.2 Obtaining configuration variables from Shelf FRU Information 96 3.3.2.1 Using the FRU Info Compiler to place configuration variables in the Shelf FRU Information 96 3.3.2.2 Using the Shelf Manager Command Line Interface to place configuration variables in the Shelf FRU Information 97 3.3.3 Verbosity level description 97 3.3.4 Verbosity console level description 98 3.4 Setting up Ethernet 98 3.4.1 Usage of the first Ethernet interface 98 3.4.1.1 Assigning an additional IP address to the first network interface 98 3.4.1.2 RMCP address propagation 99 3.4.2 Usage of the second Ethernet interface 99 3.4.2.1 Active-standby usage of the two network interfaces 100 3.4.2.2 Active-active usage of the two network interfaces 101 3.4.2.3 Support for site-dependent ShMC cross-connects 102 3.4.2.4 Bonded usage of the two network interfaces 103 3.4.3 Setting up the HPM.2 client channel 104 3.4.4 Using the ShMM-500 and ShMM-700 alternate software redundancy interface 107 3.4.5 Using the ShMM-1500 alternate software redundancy interface 109 3.4.6 Changing the default ShMM network parameters 110 Pigeon Point Shelf Manager User Guide (May 15, 2018) Page 2 / 321 3.4.7 Assigning VLAN IDs 118 3.4.8 Assigning IP addresses to the Shelf Manager via DHCP (version 4) 119 3.4.9 Using IPv6 for shelf-external access to the Shelf Manager (ShMM-700 only) 126 3.4.10 Assigning IPv6 addresses to the Shelf Manager via DHCPv6 (ShMM-700 only) 128 3.4.10.1 Handling DHCPv6 options 129 3.5 Configuring the FRU Information 132 3.5.1 Accessing the Shelf FRU Information 132 3.5.2 Setting up the Shelf FRU Information 134 3.5.3 Setting up the Shelf FRU Information using the CLI 136 3.5.4 Other FRU Information repositories 137 3.6 Configuring carrier and shelf attributes using HPDL 137 3.6.1 Compiling HPDL definitions 138 3.6.2 Compiling SDRs 139 3.6.3 Deploying HPDL data to the ShMM file system 139 3.6.4 Deploying HPDL Data to FRU Information areas 139 3.6.4.1 Specifying the location of the Carrier FRU Information 140 3.6.4.2 Using the FRU Info Compiler to place HPDL and SDR data in FRU Information 141 3.6.4.3 Using the Shelf Manager Command Line Interface 141 3.6.4.4 Placing HPDL data and SDRs in the FRU Information for specific FRUs 142 3.7 Configuring the cooling management strategy 142 3.7.1 Default cooling management strategy 143 3.7.2 Configuring a specific cooling management strategy 145 3.8 Configuring local sensors 145 3.9 Setting the Auxiliary Firmware Revision 151 3.10 Setting up the clock 151 3.10.1 Obtaining date and time from a time server 152 3.11 Setting up and using ShMM Power On Self Tests 153 3.12 Configuring external event handling 154 3.12.1 Detailed steps to configure external event handling 155 3.12.2 External event handler operation 156 3.13 Configuring the Platform Event Trap format 157 3.13.1 Parsed example of SNMP Trap 159 3.14 Configuring the IntegralHPI interface 160 3.14.1 HPI domain support in IntegralHPI 160 3.14.2 HPI SNMP subagent support 160 3.14.3 IntegralHPI client configuration 160 3.15 Configuring system services 161 3.16 Configuring the speed of I2C buses (ShMM-700 only) 165 4 Using the Shelf Manager 167 4.1 In this section 167 4.2 ShMM login 167 4.3 Starting the Shelf Manager 167 4.4 Redundant operation 176 Pigeon Point Shelf Manager User Guide (May 15, 2018) Page 3 / 321 4.4.1 Initialization of the redundant Shelf Managers 178 4.4.2 Redundancy and CPLD State sensor 179 4.4.3 Reboot Reason sensor 182 4.5 Operation in shelves with radial IPMB-0 183 4.5.1 Operation in ShMM-500-based shelves with radial IPMB-0 183 4.5.2 Operation in ShMM-1500-based shelves with radial IPMB-0 185 4.5.3 Operation in ShMM-700-based shelves with radial IPMB-0 189 4.5.3.1 Upgrading the routing element SmartFusion cSoC(s) 190 4.6 Automatic SEL truncation 191 4.7 Cooling state sensors 191 4.8 Deadlock detection 193 4.9 I2C Bus fault isolation 197 4.9.1 I2C bus fault isolation – original approach (single multiplexer or switch, not HPDL-based) 198 4.9.2 I2C bus fault isolation – HPDL-based approach (multiple multiplexers or switches) 199 4.10 Assignment of LAN configuration parameters to boards and modules 200 4.10.1 Structure and composition of the supported parameters 201 4.10.2 Obtaining LAN configuration parameters on the Shelf Manager level 201 4.10.2.1 Using the FRU Info Compiler to place LAN configuration data in the Shelf FRU Information 203 4.10.2.2 Using the Shelf Manager Command Line Interface to place LAN configuration parameters in the Shelf FRU Information 203 4.10.2.3 Configuring a Linux DHCP server for obtaining LAN configuration parameters 203 4.10.3 Dispatching LAN configuration parameters to boards 205 4.10.4 Synchronous assignment of LAN configuration parameters to boards 206 4.11 HPI System Event sensor 207 4.12 ShMM tests available via the diagnostic infrastructure 207 5 Using the IPMI analysis tools 211 5.1 In this section 211 5.2 IPMB trace collection daemon (ipmb_traced) 211 5.3 IPMI trace analyzer 215 5.3.1 Introduction to the Wireshark GUI 215 5.3.2 Introduction to terminal-oriented Wireshark 218 5.3.3 Installing IPMI analyzer software 219 5.4 Collecting and analyzing a trace using the GUI and command line tools 219 5.4.1 Collecting IPMI traces on IPMB-0 in unattended mode 219 5.4.2 Collecting IPMI traces on IPMB-0 in controlled mode 224 5.4.3 Collecting an IPMI trace in board trace mode 227 5.4.4 Collecting traces of IPMI traffic over the network 227 5.4.5 Analyzing a trace using the GUI 230 5.4.6 Analyzing a trace using command-line tools 232 6 Re-initializing the ShMM 235 6.1 In this section 235 6.2 Re-initializing the U-Boot environment 235 6.3 Re-initializing the file system 236 Pigeon Point Shelf Manager User Guide (May 15, 2018) Page 4 / 321 6.4 Resetting the login password 237 7 Re-programming the ShMM-500/1500 238 7.1 In this section 238 7.2 Firmware reliable upgrade procedure overview 238 7.3 Flash partitioning 239 7.4 The /var/upgrade file system 245 7.5 Reliable upgrade procedure status file 245 7.6 Reliable upgrade utility 245 7.7 Reliable upgrade utility use scenarios 252 7.8 Reliable upgrade examples 253 7.8.1 Example 1 253 7.8.2 Example 2 256 7.8.3 Example 3 259 8 Re-programming the ShMM-700 263 8.1 In this section 263 8.2 Firmware reliable upgrade procedure overview 263 8.3 Flash partitioning and image layout 265 8.4 Changing the ‘user’ flash partition format to JFFS2 267 8.5 Reliable upgrade procedure status file 270 8.6 Reliable upgrade utility 271 8.7 Reliable upgrade of SmartFusion cSoC image 278 8.8 Reliable upgrade utility use scenarios 279 8.9 Finding out component versions via the imls utility 280 8.10 Reliable upgrade examples 282 8.10.1 Example 1 282 8.10.2 Example 2 289 8.10.3 Example 3 293 8.10.4 Example 4 300 9 HPI-based Shelf Manager upgrades 307 Appendix A Converting to ShMM-700-based Shelf Managers in ShMM-500 shelves 308 Appendix B Customer support 310 Appendix C Revision history 311 C.1 Release 2.1.0 311 C.2 Release 2.2.0 311 C.3 Release 2.3.0 311 C.4 Release 2.4.0 312 C.5 Release 2.4.1 312 C.6 Release 2.4.2 313 C.7 Release 2.4.4 313 C.8 Release 2.5.0 313 C.9 Release 2.5.2 313 Pigeon Point Shelf Manager User Guide (May 15, 2018) Page 5 / 321 C.10 Release 2.5.3 314 C.11 Release 2.6.0 314 C.12 Release 2.6.1 314 C.13 Release 2.6.4 315 C.14 Release 2.6.4.2 315 C.15 Release 2.6.4.4 315 C.16 Release 2.7.0 315 C.17 Release 2.7.1 316 C.18 Release 2.7.2 316 C.19 Release 2.7.3 316 C.20 Release 2.7.4 317 C.21 Release 2.8.0 317 C.22 Release 2.8.1 317 C.23 Release 2.8.2 317 C.24 Release 3.0.0 317 C.25 Release 3.1.1 318 C.26 Release 3.2.0 318 C.27 Release 3.3.0 319 C.28 Release 3.4.0 319 C.29 Release 3.5.0 320 C.30 Release 3.5.0.1 320 C.31 Release 3.5.1 320 C.32 Release 3.6.0 320 C.33 Release 3.6.1 320 C.34 Release 3.6.1.2 321 C.35 Release 3.6.1.5 321 C.36 Release 3.6.1.6 321 C.37 Release 3.7.0 321 C.38 Release 3.7.1 321 List of figures Figure 1: Management aspects and potential Pigeon Point product sites in an example AdvancedTCA shelf ..............................................................................................................