Home

ATCA-7368 Basic Blade Services Programmer`s Reference

1. iv i Q danger encountered attention to important information Summary of Changes See the table below for manual revisions and changes Part Number 6806800L95A January 2011 Description First Version 6806800L95B December 2011 GA Version 6806800L95C June 2014 Re branded to Artesyn Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C 17 About this Manual eee 18 Basic Blade Services Software 7368 Programmer s Reference 68068001956 Chapter 1 Introduction 1 1 This manual is applicable to the following part numbers ATCA 7368 0GB ATCA 7368 0GB LS ATCA 7368 0GB CE ATCA 7368 0GB LS CE ATCA 7368 L CE ATCA 7368 LSL CE The Basic Blades Services BBS software provides a set of services that support the blade on which the software is installed BBS includes BSP package to build WindRiver PNE Linux 4 0 for the ATCA 7368 blade Several custom hardware management functions for the unique hardware of the blade and firmware upgrading facilities A set of management routines for Linux and all hardware interfaces Management access includes support for SNMP and a local console interface base
2. 81 5 5 hpmcmd HPM Command Utility 82 5 5 1 Command 2 2 84 5 5 2 Supported 5 24 2 2 22 86 LE E X r ccm 87 5 5 2 2 bootbankget ee Ere rete be ee e m ed es 87 5523 bootbankset wees 88 55 24 bootpadramerase dees 88 5 5 2 5 ibootparamqget seeker mem ER RR e PARAR RESTOS S E t 89 55 26 AAT EUR EE E CE ES 90 55 27 CHINO 91 4 Basic Blade Services Software 7368 Programmer s Reference 6806800L95C Contents MEA GC URS 93 5 5 2 9 deviceid UR OFEN ESPERE 94 5 5 2 T0 Exit Eire be ppp 94 5 5 2 11 dr daka 95 5 5 2 12 95 96 5 5 2 14 odis 97 98 5 5 2 ened ae 98 5 5 2 17 ipmbaddress 99 55 218 Ipimiedevice vue 99 55 2 19 IPMCSEALUS 99 5 5 2220 Tol H
3. 24 47 3 7 1 ATCA 7368 47 3 87 49 3 8 1 Performance TOOL oe rere RR REF x a EPRPPU AERE ex e Ur ee pta 49 3 8 2 e Ete tite ed p e ts te e d ea OR Re Pru ind aces 52 4 Firmware Upgrade Facility eorr SEES ET T n SERRE NE ses 59 2E MP M 59 4 2 Firmware Recovery Image Files 59 43 rrr RUOTE RE Re E e FS 61 4 4 fcu Firmware Upgrade Command Line Utility 66 4 5 Upgrading a Firmware Image 2 2 2 71 451 BIOS Upgrade vice seen ee ber De RA RU eis 71 4 5 2 IPMC MMC Firmware Bootloader and FRU Data 73 4 5 3 FPGA Upgrade RR REPERI ERR EX VERDE Ee ET RERO PEE rS 74 5 Hardware Platform 77 5 1 sese UO EEEE E ESEU CERNE 77 5 2 hpmagentd HPM Agent Daemon me mee 78 5 3 hpm Start Up Script 2 2 2 2 24 2 2 80 5 4 hpm Shutdown and Reboot Scripts
4. 25 Table 3 1 Long POST Standard Test Routines Generated IPMI Data 44 Table 3 2 Long POST Default Test 2 45 Table 3 3 Long POST Script LPmain sh Options 46 Table 3 4 Generic Linux Run Levels 22 22 46 Table 5 1 Command OVERVIOW 84 Table 8 1 7368 specific kernel patches 125 Table B 1 Artesyn Embedded Technologies Embedded Computing Publications 145 Table B 2 Related Specifications 24 4 146 Table B 3 Additional Resources 7 24 146 Table B 4 Additional Resources 2 24 2 2 2 2 147 Basic Blade Services Software 7368 Programmer s Reference 6806800195 9 List of Tables eee 10 Basic Blade Services Software 7368 Programmer s Reference 6806800L95C List of Figures eee Figure 1 1 BBS Architecture fence coy 20 Figure 5 1 Software Levels of the HPM Architecture 78 Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C 11 List of Figures
5. 2 2 2 128 8 1 7 Getting Root File System 5 129 Installingiand Configuring re rrt n them rrr eer UESTRE e ET 131 Installing BBS Using Hard 131 2 Setting up the kdump Utility on a Hard Disk Driver Installed System 138 Related Documentation soos sa nre RE REA IRE naan es 145 Artesyn Embedded Technologies Embedded Computing Documentation 145 B 2 Related 5 2 4 22 4 146 B 3 References yews ia dened bonded UBER RR Enn 146 6 Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C Contents eee B 4 Additional Resources 2 1 147 Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C 7 Contents eee 8 Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C List of Tables EN Table 2 1 BBS Installation Boot Options Main Set Up and Configuration Steps 23 Table 2 2 Installation Scripts S EE EE ey rs 24 Table 2 3 BBS Distribution
6. 116 Basic Blade Services Software 7368 Programmer s Reference 6806800195 5 Contents 5 5 2 44 upgrade 2 117 5 9 2 45 VERSION Mawes ote bento UD e Ue eg 117 5 5 2 46 Watchdog 2 t e e e 118 HPEBSoltWale 119 6 1 OVeIVIeW KS 119 7 BoardControl Module hr e he EP TEES 121 MEMO Du TT 121 7 2 Board Control TOO ewe eae 123 7 2 LEDCTR ier epe speed ai thane ER REC 123 7 2 2 due d pcm 123 8 Kernel and Root File System Config using 4 0 125 8 1 Building Kernel and Root File System 125 Ski Prerequisites ueterem em e bbick epe sese bobine Ae weis oben 125 8 1 2 Additional Kernel 125 9 1 3 Project Setup 126 8 1 3 1 Project Configure Script 126 8 1 4 Kernel Configuration 24 2 2 127 8 1 5 Root File System Configuration 128 8 1 6 Making BBS modules
7. RESUL SUCCESS MESSAGE Device artm 7368 hpm 1 ipmc Part number 0106867303A Part revision REV A IPMI address MMC 0x72 BANK Operational Firmware Name AVR AMCm F W Firmware Version 2 0 01000000 Installed IPMI FW for ARTM on Bank1 BANK Rollback Firmware Name AVR AMCm F W Firmware Version 2 0 01000000 Installed IPMI FW for ARTM on Bank2 BANK D Operational Firmware Name AVR AMCm B L Firmware Version 2 0 01000000 Installed IPMI Booter FW for ARTM BANK Operational 64 Basic Blade Services Software 7368 Programmer s Reference 6806800L95C Firmware Upgrade Facility 2 Firmware Name AVR AMCm F I Firmware Version 2 0 01000000 gt Internal IPMI Bank FRU Info BANK H Rollback Firmware Name AVR AMCm F I Firmware Version 2 0 01000000 gt Internal IPMI Bank FRU Info esee Basic Blade Services Software 7368 Programmer s Reference 6806800195 65 Firmware Upgrade Facility 4 4 fcu Firmware Upgrade Command Line Utility Description The Firmware Upgrade Command line Utility FCU allows you to e Query the current versions of firmware installed on the ATCA 7368 and determine which firmware devices are active e Verify that a specified upgrade image is sound and compatible with the current hardware Upgrade a firmware image
8. 2 2 22 2 39 2 5 Adapting the BBS Software to Customer s Needs 39 2 5 1 Modifying the NetBoot Root File System 39 2 5 2 Modifying Hard Disk Installation 40 2 5 3 Modifying the Hard Disk Installation 40 2 5 4 Modifying the Configuration of the Artesyn Supplied PNE Linux Kernel 41 Linux Distribution EN RE 43 Ball OVeIVI W aoe 43 3 2 Distribution Description 2 2 2 2 2 2 43 3 3 Reliability ziii re 43 3 4 LOJN 43 3 5 LongPOST Diagnostics 2 4 2 44 3 5 1 Default Test 2 44 Basic Blade Services Software 7368 Programmer s Reference 6806800195 3 Contents 3 5 2 Configuring the Long POST Behavior 45 3 6 Linux Services Initialization 2 4 2 2 46 3 6 1 RC SIPI rrr 47 3 7 Network Services Configuration
9. Upgrade the firmware image fcu upgrade f opt bladeservices rom atca 7368 em bios_ lt verision gt fri or fcu upgrade f opt bladeservices rom atca 7368 bios verision hpm FCU writes the new image and then reads back the image and performs a binary compare to ensure that the write was successful Ifthe upgrade was not successful you will see an error message Try the upgrade again If it is still not successful contact your Artesyn representative Query the new image to ensure that the version information is correct fcu qd atca 7368 cpu Markthe new image as active so that it will be used for the next boot for example Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C ML 4 5 2 Firmware Upgrade Facility fcu mark b bank letter d atca 7368 cpu where lt bank letter gt is the letter of the upgraded bank for example ATCA 7368 payload should be power cycled after a BIOS upgrading to make the updated BIOS active Note that the installed AMC and RTM will also be power cycled automatically when the ATCA 7368 payload is power cycled IPMC MMC Firmware Bootloader and FRU Data Upgrade Upgrading the IPMC MMC Firmware Follow these steps to upgrade an IPMC MMC The shown file names and paths are only meant as an example and should be replaced with file names and paths applicable to your configuration The general procedure to upgrade the MMC image of an
10. to www artesyn com computing Under SUPPORT click TECHNICAL DOCUMENTATION Under FILTER OPTIONS click the Document types drop down list box to select the type of document you are looking for In the Search text box type the product name and click GO Table B 1 Artesyn Embedded Technologies Embedded Computing Publications Document Title Publication Number ATCA 7368 Installation and Use Guide 6806800M12 RTM ATCA 7360 Installation and Use 66806800 08 Centellis 2000 Preliminary Installation and Use 6806800G45 Centellis 4440 Installation and Use 6806800H23 Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800195 145 Related Documentation B 2 Related Specifications For additional information refer to the following table for related specifications As an additional help a source for the listed document is provided Please note that while these sources have been verified the information is subject to change without notice Table B 2 Related Specifications Document Title Source IPMI Specifications http www intel com design servers ipmi IPMI Spec V 2 0 Intel Corporation Hewlett Packard DEC NEC IPMI Platform Management FRU Information Storage Definition V1 0 Intel Corporation September 27 1999 PCI Industrial Computer Manufacturers Group PICMG Specifications http www picmg org PICMG 3 0 Revision 2 0 Advanced Telecommunications Computing PICMG Architec
11. 7368 Programmer s Reference 6806800L95C Chapter 4 Firmware Upgrade Facility __ 4 1 4 2 Firmware Upgrade Facility FUF provides a uniform way to upgrade firmware Artesyn hub blades and node blades It consists of a Firmware Upgrade Command line Utility FCU flash device drivers and specially prepared firmware recovery image files On the ATCA 7368 FUF allows you to upgrade the following firmware types 8105 firmware e firmware e MMC firmware e FPGA image e FRU data Firmware Recovery Image Files FCU supports specially prepared firmware recovery image FRI files as well as firmware images in the 1 format 1 is a PICMG standard to upgrade 5 By default the image files for the current hardware configurations are loaded as part of the BBS software in opt bladeservices rom when the blade specific firmware support packages are installed Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C 59 Firmware Upgrade Facility The following image files are currently supported Filename atca 7368 em bios version fri atca 7368 em bios version hpm atca 7368 em ipmc version hpm atca 7368 em ibbl version hpm atca 7368 em frud version hpm atca 7368 em fpga version hpm artm 7368 em mmcf version hpm Description FRI format BIOS image for ATCA 7368 Only upgra
12. 16 Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C About this Manual Notation Description Omission of information from example command that is not necessary at the time being Ranges for example 0 4 means one of the integers 0 1 2 3 and 4 used in registers Logical OR XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX Indicates a hazardous situation which if not avoided could result in death or serious injury Indicates a hazardous situation which if not avoided may result in minor or moderate injury Indicates a property damage message
13. is the same except that you need to use artm 7368 hpm 1 ipmc as device ID 1 Query the current IPMC firmware images on the blade fcu q d atca 7368 hpm 1 ipmc Showthe version of the new IPMC file to verify that it has actually a newer version than the already installed image fcu show f opt bladeservices rom board type atca 7368 em version hpm Upgrade the firmware image fcu upgrade f opt bladeservices rom board type atca 7368 em ipmc version hpm Once the new firmware is programmed the IPMC resets itself to boot from the new image The boot loader validates the new IPMC firmware Provided the IPMC can power up successfully the current image is made active and the previously active image is made backup In case of power up failures the boot loader automatically recovers from crisis and boots from the previous image Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C 73 Firmware Upgrade Facility 4 5 3 74 4 Query the new image to ensure that the version information is correct fcu qd atca 7368 hpm 1 ipmc If the version you just installed is now the active image the upgrade was successful FPGA Upgrade Upgrading the FPGA Firmware The ATCA 7368 uses an EEPROM which contains the FPGA firmware The following procedure describes how to upgrade the FPGA image stored in the user programmable EEPROM The shown file names and paths are onl
14. Firmware Upgrade Facility u Tells FCU to upgrade the currently inactive bank of the device specified by the target FRI file The file option and i are required The upgrade operation may be combined with the verify mark operations YE You must specify the to be upgraded firmware filename and a right corresponding M filename in the same time to run the upgrade FCU will not check whether the IIF information really matches the firmware files or not verify Tells FCU to verify the image file specified by the required option This operation verifies that the specified file is sound and compatible with the current hardware The verify operation may be combined with the upgrade and mark operations version Displays version information forthe utility This option is exclusive and should not be used with other options Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C 69 Firmware Upgrade Facility Usage 70 Some FCU options can be combined Some options are exclusive The following list describes the valid option combinations compare file lt i1lename gt e full upgrade file irmware filename A full upgrade combination will perform verify upgrade and mark actions together The operation will automatically upgrade and specify the currently Rollback bank as the bank to be used for next power up e help e mark banke bank l
15. This section describes the steps you need to take for performing diskless client boot of the BBS software Configuring BIOS for Diskless Client Boot To configure BIOS for diskless client boot proceed as follows 1 Connectto the blade via the serial interface Power up or reboot the blade Quickly hold down the F2 key on your keyboard until the BIOS menu appears Scroll down to BOOT FEATURES by using the arrow keys 2 3 4 Select ADVANCED on the top menu 5 6 Press ENTER 7 Make sure that the following settings are enabled Base Interface Network bootorFront Panel Network Boot depending on the interface you want to boot from If any of these settings is disabled enable the setting s and press lt 10 gt or select Exit Saving Changes This will save the new settings and restart the BIOS After the restart press F2 to enter BIOS again and continue with the BIOS configuration Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C Installing the Basic Blade Services Software 2 3 2 8 Depending on which interface you want to boot from put either Base Network 1 Base Network 2 FrontPanel Network 1 or FrontPanel Network 2 tothefirst position oftheBoot priority order list 9 Save and exit Rebooting the Blade To reboot a blade proceed as follows 1 Reboot the blade via e Shelf manager e Opening and closing the lower handle switch on the face plate e Pr
16. USERID server bin in tftpd Server args r blksize tftpboot disable no protocol udp 2 Create the directory t ft pboot and add the needed files as described in Create tftpboot Directory and Copy Target Files on page 27 3 If there are any TFTP daemons that have not timed out you need to stop them Enter the following command to do so killall in tftpd 4 Enter the following command to have inetd re read its configuration file etc rc d init d inetd restart Your TFTP server is now configured 2 2 3 Configuring DHCP The DHCP configuration file on an TFTP server for example ATCA F120 or an external TFTP server resides in etc dhcpd conf Make sure this file contains the following entries addresses may be different in your configuration Sample dhcpd configuration file db allow bootp allow booting authoritative filename pxelinux 0 ddns update style ad hoc option domain name booting com Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C 29 Installing the Basic Blade Services Software 2 2 4 30 option subnet mask 255 255 255 0 default lease time 600 max lease time 7200 1 interfaces subnet 192 168 21 0 netmask 255 255 255 0 range 192 168 21 100 192 168 21 125 option broadcast address 192 168 21 255 2 interfaces subnet 192 168 22 0 netmask 255 255 255 0 range 192 168 22 100
17. Manufacturer IPMI Interface Type Control Style IPMI Spec Rev I2C Slave Addr NV Stor Dev Addr Base Addr IRO 4096 Mbyte 64 Bit Samsung 1 KCS Keyboard 2 0 0 9 Not Present 0x00000CA3 0 0 Board Control Module 7 2 7 2 1 7 2 2 Board Control Tool The board control module provides an interface which can be used by the userland applications The following sections describes userland applications such as LEDCTRL and FPGA_TEST LEDCTRL Description Allows to control the 3 front panel LEDs according to their capabilities LEDCTRL can be found at opt bladeservices bin ledctrl Synopsis ledctl options 1 1 led2 Here 1ed n are zero based LED numbers If no LED numbers are given the option is applied to all the available LEDs The options can have following values Print number of available LEDs Display information about LED capabilities Print current LED settings c color Set LED s color to g reen y ellow b lue a mber hdd or eth Set blink frequency to off or p ermanent FPGA TEST Description Dumps the FPGA register set TEST can be found at opt bladeservices bin fpga test Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C 123 Board Control Module eee Synopsis fpga_test Here d option is used to dump the complete FPGA register set 124 Basic Blade Se
18. Valid values are Valid Value Description ETHER for fabric interface OEM for the update interface which is Artesyn specific typex Always current implementation Valid values 0 for 1000Base BX 1 for 10GBase BX4 2 for FCPI ports A sequence of ports to act on For base and update channels port is always 0 For fabric channels port can specify up to 4 ports as specified in PICMG 3 1 Option 1 0 Option 2 01 Option 9 0123 oper Valid values are DISABLE or ENABLE Example hpmemd c portset base 1 0 base 0 0 enable 5 5 2 31 quit Description This command is for exiting the hpmcmd program when running in interactive mode 108 Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800195 Hardware Platform Management Synopsis quit 5 5 2 32 rebootpath Description This command retrieves the path and filename of the current hpmagentd reboot script Synopsis rebootpath Example hpmemd rebootpath opt bladeservices bin hpmreboot 5 5 2 33 sdr Description This command shows the SDR records Synopsis sdr Example hpmemd c sdr 1 management controller device locator record I2C slave addr 49 Channel number 00 Power state 06 Global init Capabilities 2D Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C 109 Hardware Platform Management Entity Id PICMG front board Entity instance 60 OE
19. 1 0 17 Build 0004 no B AMI BIOS 1 0 16 yes OPERATION Query RESUL SUCCESS MESSAGE Device atca 7368 hpm 1 ipmc Part number 0106866303A Part revision REV A BANK A Operational Firmware Name Firmware Version gt Installed IPMI FW on BankO BANK 62 Basic Blade Services Software on H8S AMCc F W 2 0 15040000 B Rollback ATCA 7368 Programmer s Reference 6806800195 Firmware Upgrade Facility Firmware Name H8S AMCc F W Firmware Version 2 0 15040000 gt Installed IPMI FW Bank1 BANK D Operational Firmware Name H8S AMCc B L Firmware Version 2 0 15020000 Installed IPMI FW Boot Loader BANK Operational Firmware Name H8S AMCc F I Firmware Version 2 0 15040000 gt Internal IPMI Bank FRU Info BANK J Operational Firmware Name 85 F C Firmware Version 0 0 00000000 gt Internal IPMI Bank FRU Info Carrier No subject to be updated BANK Operational Firmware Name FPGA Firmware Version 16 0 00000000 gt Installed FPGA Version BANK P Operational Firmware Name BIOS Firmware Version 1 0 17000000 gt Installed BIOS Version seen IPMC Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C 63 Firmware Upgrade Facility BANK S Operational Firmware Name BIOS Firmware Version 0 0 00000000 gt Second BIOS Bank currently not seen by IPMC OPERATION Query
20. 3 5 3 5 1 44 The following table lists available default login accounts Login Name Password Description admin emerson Non privileged user account Long POST Diagnostics The long POST Power On Self test is an extension to the standard POST which the ATCA 7368 executes after power up It is executed during the booting of the Linux operating system and includes higher level tests This section describes which tests are by default executed during the long POST how to obtain the results of these tests and how to add your own test routines Default Test Routines The long POST test routines are implemented as Linux scripts which are invoked during the Linux boot phase The test scripts which are to be executed need to be defined in the IPMI boot parameter variable runLP or as additional parameter in the kernel command line runLP Further details are given in Configuring the Long POST Behavior page 45 Each test routine displays the test status on the console and writes it to the Linux log module via Logger Furthermore each test routine writes status information to the IPMI sensor System Firmware Progress type 0 0 The used event data values are Artesyn specific The following table provides details Table 3 1 Long POST Standard Test Routines Generated IPMI Data Action Data Written to System Firmware Progress Sensor Test routine is started Offset 0 0x02 Offset 1 OXFD Offset 2 Ox1E Te
21. Description This command is for exiting the hpmcmd program when running in interactive mode Synopsis 94 Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C Hardware Platform Management exit 5 5 2 11 frudata Description This command dumps the content of the FRU data in hexadecimal format Synopsis frudata lt fruid gt t ipmbAddr mmcAddr Parameters fruid 150 for the main blade and 1 for the rear transition module Sends the command to ipmbAddr mmcAddr ipmbAddr is the string Ic if it is a local mmcAddr Example hpmemd c frudata 0 5 5 2 12 fruinfoget Description This command retrieves information from the specified FRU Synopsis fruinfoget fruid field v t ipmbAddr mmcAddr Parameters fruid Is 0 for the main blade and 1 for the rear transition module Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C 95 Hardware Platform Management field Is one of the following data fields If no field is specified it retrieves the whole fruinfo for that FRU Field Description bproductname Board product name bserialnumber Board serial number bpartnumber Board part number pmanufacturer Product manufacturer pproductname Product product name ppartnumber Product part number Product version number pserialnumber Product serial number passettag Product inventory asset identifier Verbose mode to get point to point c
22. eee 12 Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C About this Manual Overview of Contents This manual is divided into the following chapters and appendices Chapter 1 Introduction on page 19 provides an overview of Basic Blade Services BBS software Chapter 2 Installing the Basic Blade Services Software on page 23 describes the procedure to install the BBS software Chapter 3 Linux Distribution Description on page 43 describes the Linux distribution of ATCA 7368 BBS Chapter 4 Firmware Upgrade Facility on page 59 describes the Firmware Upgrade Facility FUF Chapter 5 Hardware Platform Management on page 77 describes the Hardware Platform Management HPM and lists the HPM commands Chapter 6 HPI B Software on page 119 provides an overview of HPI B Software Chapter 7 Board Control Module on page 121 describes the Board Control Module Chapter 8 Kernel and Root File System Config using PNE 4 0 on page 125 describes the procedure to build the Linux kernel and root file system for the ATCA 7368 Appendix A Installing and Configuring BBS page 131 describes the procedure to install and configure BBS Appendix B Related Documentation on page 145 lists the related documents of ATCA 7368 Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C 13 About this Manual Abbreviations This document uses the following abbrev
23. 6806800L95C 127 Kernel and Root File System Config using 4 0 8 1 5 8 1 6 128 Root File System Configuration The file system provided with ATCA 7368 supports the multilibs feature of Wind River PNE 4 0 that allows running of both 32 bit and 64 bit applications on the board As a result the package list contains 32 bit packages also You can adapt the packages used in your projects as per the requirement The ATCA 7368 pkglist addand pkglist remove files are stored in atca7368_em_bsp templates board atca7368 directory The original PNE 4 0 does not include a tftp server Therefore an open source tftp server is incorporated see ateca7368_bsp_em dist tftp The onboard Intel 82576 82599 ethernet controller driver igb ixgbe is built as an loadable Linux module by the script of atca7368_em_bsp bbs scripts atca7368_make_bbs sh instead of building from PNE kernel Check the source code and adapted Makefiles at atca7368_em_bsp bbs src igb tgz and atca7368_em_bsp bbs src ixgbe tgz Making BBS modules BBS modules delivered to you in source code format and igb ixgbe driver source code are available here atca7368_em_bsp bbs src You may need to modify the script of atca7368_em_bsp bbs scripts atca7368_make_bbs sh delete those modules you do could not need to be built from source or adapt the source code repository directory according to your building environment and project requirement Please run the script of atca7368_
24. Package Manager RTM Rear Transition Module SAF Service Availability Forum SAS Serial Attached SCSI SATA Serial ATA SCSI Small Computer System Interface SDR Sensor Data Record SMI Serial Management Interface SNMP Simple Network Management Protocol Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C 15 About this Manual Abbreviation TAR Definition Solid State Disk Secure Shell Synchronization Supply Unit Tape Archive Transmission Control Protocol Trivial File Transfer Protocol Conventions User Datagram Protocol Universal Serial Bus The following table describes the conventions used throughout this manual Notation 0x00000000 0 0000 Description Typical notation for hexadecimal numbers digits are 0 through F for example used for addresses and offsets Same for binary numbers digits are 0 and 1 bold Used to emphasize a word Screen Courier Bold Reference Used for on screen output and code related elements or commands in body text Used to characterize user input and to separate it from system output Used for references and for table and figure descriptions File gt Exit Notation for selecting a submenu lt text gt Notation for variables and keys Notation for software buttons to click on the screen and parameter description Repeated item for example node 1 node 2 node 12
25. Panel Base blade No IP address assigned Interface ETH1 48 Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C Linux Distribution Description 3 8 Tools This section describes CPUSpeed and IPMIBPAR tools that can be used to change the processor performance governors Boot Parameter list 3 8 1 Performance Tool The performance tool CPUSpeed allows to change the processor performance governors and the core frequency for userspace governor on a per core base It utilizes data stored in the sys device system cpu directory The following table describes various governors Governor Description Performance Core is running with maximum frequency Ondemand Cores in idle state are running at lowest frequency When the core is changed to the utilized state the frequency of the core is changed to maximum Powersave Core is running with minimum frequency Userspace Core frequency can be adjusted by the user in steps If the P States are limited by BIOS the required driver is not loaded and therefore the l CPUSpeed tool cannot work Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C 49 Linux Distribution Description CPUSpeed supports the following options Description Dump CPU Frequency Governor Info Print supported governors Set governor frequency It supports the following options Specifies
26. Reference 6806800195 135 Installing and Configuring BBS 9 Set the time zone if necessary The time zone 24 hour clock is by default set to US Eastern on all the blades In order to change the time zone enter y for Yes when being prompted See the following output example Your current time zone is set to US Eastern Do you want to change that n y 1 Africa 2 Americas 3 Antarctica 4 Arctic Ocean 5 Asia 6 Atlantic Ocean 7 Australia 8 Europe 9 Indian Ocean 10 Pacific Ocean 11 none I want to specify the time zone using the Posix TZ format 28 Please select a country 1 Aaland Islands18 Greece 35 Norway 2 Albania 19 Guernsey 36 Poland 3 Andorra 20 Hungary 37 Portugal 4 Austria 21 Ireland 38 Romania 5 Belarus 22 Isle of Man 39 Russia 6 Belgium 23 Italy 40 San Marino 7 Bosnia amp Herzegovina 24 Jersey 41 Serbia 8 Britain UK 25 Latvia 42 Slovakia 9 Bulgari 26 Liechtenstein 43 Slovenia 10 Croatia 27 Lithuania 44 Spain 11 Czech Republic28 Luxembourg 45 Sweden 12 Denmark 29 Macedonia 46 Switzerland 13 Estonia 30 Malta 47 Turkey 14 Finland 31 Moldova 48 Ukraine 15 France 32 Monaco 49 Vatican City 16 Germany 33 Montenegro 17 Gibraltar 34 Netherlands 216 136 Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C Installing and Configuring BBS Choose a time zone out of the list that is displayed and enter the corresp
27. and fabric1 This renaming is done in the etc init d ethDevOrdering sh script before the network startup Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C 47 Linux Distribution Description The following table specifies the Ethernet devices supported by ATCA 7368 Device Name Description Speed Location IP address Base 1GbE Base blade gt Obtained by the DHCP client Interface 1 Backplane request base2 Base Base blade gt Obtained by the DHCP client Interface 2 Backplane request fabric Fabric Base blade gt Static IP address Interface 1 FabricInterface on It is computed as Backplane 192 168 lt fabricIf gt lt slotn umber 10 gt fabricIf can have value 711 for Fabric Interface 1 and 12 for Fabric Interface2 slotnumber specifies the logical slot number converted to decimal The setup of the IP Addresses for Fabric IF is done in the etc init d bbsvlan sh file fabric2 Fabric Base blade gt Static IP address Interface 2 FabricInterfaceon computed as Backplane 192 168 lt fabricIf gt lt slotn umber 10 gt fabricIf can have value of 11 for Fabric Interface 1 and 12 for Fabric Interface2 slotnumber specifies the logical slot number converted to decimal The setup of the IP Addresses for Fabric IF is done in the etc init d bbsvlan sh file Front Panel Base blade No IP address assigned Interface ETHO Front
28. atca 7368_em_frud_ lt CPU type gt _ lt version gt rpm atca 7368_em_frud_ lt CPU type gt noamc_ lt version gt rpm IPMI firmware package RTM ATCA 7368 artm 7368 em mmcf version rpm IPMI firmware booter package RTM ATCA 7368 Blade FRU data RTM ATCA 7368 MMcC all Firmware RTM ATCA 736X DD 7368 mmcb version rpm artm 7368 em frud version rpm artm 736xdd em mmcall version rpm MMC Firmware RTM ATCA 7360 artm 7360_em_mmcf_ lt version gt rpm Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C 25 Installing the Basic Blade Services Software Table 2 3 BBS Distribution Packages continued Description File Name MMC Boot loader Firmware RTM artm 7360_em_mmcb_ lt version gt rpm ATCA 7360 FPGA firmware package atca 7368 em fpga version rpm ash Drive support package Firmware Upgrade functionality bbs fuf atca7368 version rpm Upgrade tool for BIOS FPGA and IPMC on front blade and RTM Hardware Platform Management bbs hpmagentcmd atca7368 version rpm consisting of daemon and client Board control utility to get FPGA bbs boardctrl atca7368 version rpm data Flashrom package update tool for bbs f lashrom atca7368 version rpm BIOS flash via SPI interface Flash driver for SFMEM module bbs sfmem atca7368 version rpm package bbs hpib version HPI B client package bbs
29. by using the arrow keys Press ENTER Make sure that the following settings are enabled Base Interface Network bootorFront Panel Network Boot depending on the interface you want to boot from If any of these settings is disabled enable the setting s and press lt 10 gt or select Exit Saving Changes This will save the new settings and restart the BIOS After the restart press F2 to enter BIOS again and continue with the BIOS configuration Depending on which interface you wantto boot from put eitherBase Network 1 Base Network 2 FrontPanel Network 1 orFrontPanel Network 2tothe first position ofthe Boot priority order list Save and exit Installing Files and Configuring TFTP on the ATCA 7368 After the system has come up install Linux with the following procedure 1 2 Login as root Identify the Linux device name of the hard disk on which you want to install BBS To do so enter disk 1 This displays available hard disks their Linux device names and also the storage capacity Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C Installing the Basic Blade Services Software 3 1inuxrc script from the opt bladeservices tools directory linuxrc The hard disk installation begins by checking for necessary commands on the system 4 Enterthe information requested by the script such asthe TFTP server address from where the software is loaded NT
30. e Diskless client boot via network e Installation and booting from SATA SAS hard disk e Installation and booting from on board USB disk On ATCA 7368 the SAS HDD and SATA HDD can reside in the AMC Bay or RTM when an RTM ATCA 7368 RTM ATCA 7360 RTM ATCA 736X DD blade which has the HDD installed AMC Bay also supports SATA HDD AMC without the installation of any RTMs As an option a Solid State Disk SSD with SATA interface SATA cube can be placed on the front board For all these options you need to set up an external TFTP server to retrieve the required BBS files Furthermore you need to do some initial configurations Table 2 1 provides an overview ofthe main steps you need to take for the three installation boot options The detailed procedures can be found in the following sections Table 2 1 BBS Installation Boot Options Main Set Up and Configuration Steps Installation Boot Option Main Set Up and Configuration Steps Diskless client boot Refer 1 Setup and configure external TFTP boot server Configuring ATCA 7368 for 2 Configure DHCP server Diskless Client Boot of the BBS 3 Configure PXE boot options Software on page 32 4 Configure ATCA 7368 BIOS to boot from network Installation and booting from 1 Setup and configure external TFTP boot server 5 5 5 hard disk hard 2 Configure DHCP server disk can be located on the RTM 3 Confi PXE boot opti or locally as SATA cube on the front bo
31. kernel parameters In order to use the default file you need to link it to the MAC address of the ATCA 7368 as described below Example The following example shows how to set up the PXE environment for an ATCA 7368 blade This is done by creating a new default file and linking it to the MAC address of the ATCA 7368 boot Ethernet interface which is 00 80 42 1d da 07 in the example PXE expects that the file name should be prefixed with 01 and all the characters in the file name are lower case letters Setting up the PXE Environment Proceed as follows 1 Make anew subdirectory in t pboot mkdir p tftpboot ATCA7368 2 Copy the corresponding boot image and RPMs to this directory 3 Set up a new default files in t ftpboot pxelinux cfg for example default atca7368 The contents of default atca7368 are DEFAULT ATCA7368 kernel ramdisk size 716800 console ttyS0 9600n8 initrd ATCA7368 ramdisk image gz root dev ram0 ip none pci lastbus 255 quiet nopat Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C 31 Installing the Basic Blade Services Software 2 3 2 3 1 32 4 Link the MAC address of the blade to its boot default file for example fcd tftpboot pxelinux cfg 1n s default atca7368 01 00 80 42 1d da 07 Installation Procedures Thefollowing subsections list the different BBS installation procedures Configuring ATCA 7368 for Diskless Client Boot of the BBS Software
32. on the TFTP server to proceed the installation Only the location of these files on the TFTP server can be configured Note Please enter the directory name without leading or trailing slashes What is the installation files directory For example ATCA7368 8 Downloading of Files During the download of the files the following is displayed for example Downloading Downloading Downloading Downloading Downloading Downloading files shalsum from ATCA7368 Done kernel from ATCA7368 Done rootfs tar gz from ATCA7368 Done modules tar bz2 from ATCA7368 Done atca 7368 em bbs bios 1 0 0 rpm from ATCA7368 Done atca 7368 em bbs boardctrl 1 0 1 from 7368 Downloading Downloading Downloading Downloading Downloading Downloading atca 7368 em bbs flashrom 0 1 1l rpm from ATCA7368 Done atca 7368 em bbs fpga 1 0 0 rpm from ATCA7368 Done atca 7368 em bbs fuf 1 3 8 rpm from ATCA7368 Done atca 7368 bbs ibbl 2 0 1l rpm from ATCA7368 Done atca 7368 bbs ipmc 2 0 1l rpm from ATCA7368 Done atca 7368 em bbs hpmagentcmd 1 3 12 rpm from ATCA7368 Done Downloading Downloading Downloading Downloading artm 7368 em bbs mmcb 2 0 l rpm from ATCA7368 Done artm 7368 em bbs mmcf 2 0 l rpm from ATCA7368 Done initrd0 img from ATCA7368 Done vmlinux from ATCA7368 Done Basic Blade Services Software on ATCA 7368 Programmer s
33. the core Valid values are 0 15 Omitting this option means all cores f Specifies the frequency Valid values are 1596000 2129000 This parameter is ignored except for userspace governor g Specifies governors such as performance powersave ondemand and userspace 50 Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C Linux Distribution Description eee Example root ACPI4 C 9 xxxxxx opt bladeservices tools opt bladeservices tools cpuspeed CPU Frequency Info Number Of Cores 12 MinFrequency 1596000 MaxFrequency 1730000 Available Governors ondemand userspace powersave performance Frequency Info Per Core Core Governor CurrentFrequency 0 performance 1730000 1 performance 1730000 2 performance 1730000 3 performance 1730000 4 performance 1730000 5 performance 1730000 6 performance 1730000 7 performance 1730000 8 performance 1730000 9 performance 1730000 10 performance 1730000 11 performance 1730000 Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C 51 Linux Distribution Description 3 8 2 IPMIBPAR The IPMIBPAR tool can be used to change the IPMI Boot Parameter list when Linux is up and running It supports the following options Description Enable debug output IPMB Address if not present local IPMC is used Get device ID Get IPMI Boot Parameter USER are
34. the parameter Sends the command to ipmbAddr mmcAddr The ipmbAddris the string lc if it is a local mmcAddr Example c bootparamset USER bootboot_order sashdd sata3 satal 0 basenet1 usbonboard Successful bootparamset Operation 5 5 2 7 chinfo Description Retrieve channel information Synopsis chinfo channel t ipmbAddr mmcAddr Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C 91 Hardware Platform Management Parameters channel Channel number Sends the command to ipmbAddr mmcAddr ipmbAddr is the string lc if it is a local mmcAddr Example c chinfo 0 root ACPI4 C 9 hpmcmd c chinfo 0 Channel Medium Type IPMB 12 Channel Protocol Type IPMB 1 0 Session Support session less Active Session Count 0 Protocol Vendor ID 001 2 rootQACPIA4 C 9 4 hpmcmd c chinfo 4 Channel Medium Type System Interface KCS SMIC or BT Channel Protocol Type KCS Session Support session less Active Session Count 0 Protocol Vendor ID 001 2 rootQACPIA4 C 9 4 hpmcmd c chinfo 1 Channel Medium Type Asynch Serial Modem RS 232 92 Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C Hardware Platform Management Channel Protocol Type TMode Session Support session less Active Session Count 0 Protocol Vendor ID 00400AProtocol Vendor ID 00400 5 5 2 8 Descr
35. to the ATCA 7368 Installation and Use Guide Synopsis bootparamget section name t ipmbAddr mmcAddr Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C 89 Hardware Platform Management Parameters section Section within the IPMC storage area from which data is to be read Possible values are e USER e DEFAULT TEST 05 PARAM Name of the parameter whose value is to read Sends the command to ipmbAddr mmcAddr The ipmbAddris the string lc if it is a local mmcAddr Example hpmcmd c bootparamget USER boot order boot order sashdd sata3 satal basenet0 basenetl 5 5 2 6 bootparamset Description This command allows you to write data to the IPMC boot parameters storage area The data which is stored in this area can be accessed from the IPMI subsystem and also from the OS and boot firmware The storage area can for example be used in order to pass boot parameters to the boot firmware For further details refer to the 7368 Installation and Use Guide Synopsis bootparamset section name value t ipmbAddr mmcAddr 90 Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C Hardware Platform Management Parameters section Section within the IPMC storage area where to write the data to Possible values are e USER e DEFAULT TEST 05 PARAM Name of the parameter which is to be set value Value of
36. 0 0 00 72 74 5f 65 72 72 5f 6f 67 6f 66 66 lt n rt_err_log off gt 0000 00 70 63 69 5f 6f 67 6f 66 66 00 76 74 5f lt pci_log off vt_ gt 00 0 64 6f 66 66 00 69 74 5f 61 70 6f lt d off int_map on gt 00240 00 65 63 63 5f 73 75 70 70 6f 72 74 6f 00 lt ecc_support on gt 00 0 68 77 5f 65 5f 74 65 73 74 6f 0070 hw mem test on p 00 0 61 74 72 6f 6c 5f 73 63 72 75 62 3d 6f 0064 lt atrol_scrub on d gt 0100 65 61 64 5f 73 63 72 75 62 6f 66 66 00 lt emand_scrub off gt 0110 61 6c 6c 5f 75 73 62 5f 64 65 76 69 63 65 6 all usb gt 0120 00 75 73 62 5f 32 2e 30 5f 63 6f 74 5f n usb 2 0 cont m 0130 6 64 65 6 00 75 73 62 66 70 5 6 6 lt ode on usb fp_on gt 0140 2c 72 74 6d 5f 6f 6e 2c 6 62 6 61 72 64 5f rtm on onboard 0150 6f 00 75 73 62 5f 62 6f 6f 74 6f 00 62 on usb boot on b 0160 61 75 64 72 61 74 65 33 38 34 30 30 00 6f 73 lt audrate 38400 0s gt 0170 5f 62 6f 6f 74 5f 77 61 74 63 68 64 6f 67 6 lt boot watchdog o 0180 66 66 2c 35 2c 72 65 73 65 74 00 66 72 6f 74 ff 5 reset front 0190 65 74 5f 62 6f 6f 74 6f 00 62 61 73 65 net boot on base 01a0 65 74 5f 62 6f 6f 74 6f 00 66 61 62 72 net boot on fabr 01b0 69 63 65 74 5f 62 6f 6f 74 6f 00 61 72 icnet boot on
37. 0 sensors LUN 2 has 000 sensors LUN 3 has 000 sensors The LUN sensor number mentioned above in decimal format x L 5 5 2 37 shelfaddress Description This command retrieves the shelf address string from the shelf FRU Synopsis shelfaddress Example hpmemd c shelfaddress 01 5 5 2 38 shelfslots Description This command retrieves the total number of blade slots in the shelf Synopsis shelfslots Example hpmemd c shelfslots 112 Basic Blade Services Software ATCA 7368 Programmer s Reference 6806800195 Hardware Platform Management 14 slots e g in a Centellis 4440 System 5 5 2 39 shutdownpath Description This command retrieves the path and filename of the current hpmagentd shutdown script Synopsis shutdownpath Example hpmcmd shutdownpath opt bladeservices bin hpmshutdown 5 5 2 40 slotmap Description This command prints a slotmap table for the shelf the blade is installed in Synopsis slotmap Example hpmemd c slotmap Physical Slot 01 02 03 04 05 06 07 08 09 101112 13 14 Logical Slot 13 11 09 07 05 01 03 04 02 06 0810 12 14 Address 9A 96 92 8A 82 86 88 84 90 94 98 9 5 5 2 41 slotnumber Description This command retrieves the logical slot number of the slot where the blade is plugged in Synopsis Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C 113 Hardware Platform Management slotnumber E
38. 1 Hardware Platform Management operation ON enable override state and turn LED on OFF enable override state and turn LED off BLINK enable override state and blink LED off_duration and on_duration specify the blink duration the default on and off duration is 300 ms LOCAL cancel override state and restore LED control to the IPMC that is local state TEST run lamp test for specified on duration then restore prior state offms 10 2500 in 10 millisecond increments only valid if operation is BLINK onms Only valid if operation is BLINK or TEST If operation is BLINK 10 2500 in 10 millisecond increments If operation is TEST 100 12800 in 100 millisecond increments color LEDO BLUE LED1 lt RED LED2 GREEN LED3 AMBER t ipmbAddr Sends the command to ipmbAddr Example hpmemd c ledset 0 1 1 on 5 5 2 23 loglevelget 102 Description This command retrieves the current hpmagentd log level See loglevelset for more detail Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C Hardware Platform Management Synopsis loglevelget Example hpmcmd loglevelget Loglevel 5 NOTICE 5 5 2 24 loglevelset Description This command sets the level of message logging for hpmagentd Synopsis loglevelset lt newLogLevel gt Parameters newLogLevel Is one of the standard syslog levels Description Critical Error Warning Notice Infor
39. 192 168 22 125 option broadcast address 192 168 22 255 Restart DHCP service on your Linux DHCP server by issuing the following commands and make sure your DHCP service starts successfully against your configuration files f etc init d dhcp stop f etc init d dhcp start Configuring PXE PXE determines which kernel and root file system image a blade gets from the server The PXE environment as well as the bootable images usually reside in the t t pboot directory on the server The initial boot file is called 11 0 andthe PXE configuration directory is in the tftpboot pxelinux cfg The default configuration file is called tftpboot pxelinux cfg default Example default file DEFAULT ATCA7368 kernel ramdisk size 716800 console ttyS0 9600n8 initrd ATCA7368 ramdisk image gz root dev ram0 ip none ro pci lastbus 255 quiet nopat Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C Installing the Basic Blade Services Software 7 7 In this configuration the same images served to all blades in the chassis In order to distinguish between blades and to serve different images you can use different default files and link them to different MAC addresses of different blades Depending on the particular BBS release an example default file for the ATCA 7368 may be contained in the BBS package check the release notes applicable to your blade release This file contains all required
40. 507ac41937 net my server com export tmp net netdumpuser 192 168 16 100 path var crash core_collector makedumpfile link_delay 60 default shell Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C 139 Installing and Configuring BBS Configuration option and value description Option Value Description auto dump lt yes no gt Set to yes if you want the capture kernel to dump the core file proc vmcore to your specified location After dumping the kernel will reboot the system to a fresh state Set to will prevent the capture kernel from saving core files automatically And you have to save the core file manually to your preferred location after the capture kernel boots up It is always necessary to reboot after you finish saving raw lt partition gt This will store proc vmcore into given lt partition gt net lt nfs mount gt This will mount fs and copy proc vmcore to lt mnt gt var crash HOST DATE DNS supported net lt user server gt This will scp proc vmcore to lt user server gt var crash HOST DATE DNS supported NOTE make sure user has necessary write permissions on server lt fs type gt This will mount t fs type partition mnt lt partition gt proc vmcore to mnt var crash DATE NOTE lt partition gt can device node label or uuid 140 Basic Blade Services Softw
41. Basic Blade Services Software 7368 Programmer s Reference P N 6806800L95C June 2014 _ ss Copyright 2014 Embedded Technologies Inc All rights reserved Trademarks Artesyn Embedded Technologies Artesyn and the Artesyn Embedded Technologies logo are trademarks and service marks of Artesyn Embedded Technologies Inc 2014 Artesyn Embedded Technologies Inc All other product or service names are the property of their respective owners Intel is a trademark or registered trademark of Intel Corporation or its subsidiaries in the United States and other countries Java and all other Java based marks are trademarks or registered trademarks of Oracle America Inc in the U S and other countries Microsoft Windows and Windows Me are registered trademarks of Microsoft Corporation and Windows is a trademark of Microsoft Corporation PICMG CompactPCI AdvancedTCA and the PICMG CompactPCI and AdvancedTCA logos are registered trademarks of the PCI Industrial Computer Manufacturers Group UNIX is a registered trademark of The Open Group in the United States and other countries Notice While reasonable efforts have been made to assure the accuracy of this document Artesyn assumes no liability resulting from any omissions in this document or from the use of the information obtained therein Artesyn reserves the right to revise this document and to make changes from time t
42. C 8 1 4 Kernel and Root File System Config using PNE 4 0 4 DIR Directory where your BBS application making modules object files and eSW will be put PROJECT PATH Directory of your PNE platform project In this case home ec7538 atca7368 ga01 PROJECT LAYER PATH Directory where you have installed 7368 em bsp Inthis case home ec7538 atca7368 ga01 cml atca7368 em bsp WINDRIVER INSTALL PATH Directory where the WindRiver PNE 4 0 workbench installed and the WindRiver PNE 4 0 wrenv sh file can be found In this case opt windriver PNE4 0 To use this script you should create a new project directory in this case home ec7538 atca7368 ga01 prj After successfully set your building environment using set Env sh now you can run another script of atca7368 setup sh to configure your ATCA 7368 PNE 4 0 workspace against the configuration in the 7368 em bsp and build the project including kernel and root file system Kernel Configuration The 7368 uses the 64 bit kernel configuration The kernel configuration file is stored as atca7368 em bsp templates board atca7368 linux atca7368 sccandafile of atca7368 cfg is referred by the file 7368 scc You can directly modify atca7368 cfg to tune your own custom built kernel The kernel configuration will be applied automatically if you are using the layer structure Basic Blade Services Software on ATCA 7368 Programmer s Reference
43. Do you wish to begin the installation y n There is no default answer to this question Choosing y will begin the installation Choosing n will abort the installation Starting the installation will cause the hard disk drive to be partitioned and formatted while displaying the message Disk dev sda 4864 cylinders 255 heads 63 sectors track Old situation Units mebibytes of 1048576 bytes blocks of 1024 bytes counting from 0 Device Boot Start End MiB blocks Id System dev sdal 0 1004 1005 1028159 83 Linux dev sda2 1004 6008 5005 5124735 83 Linux dev sda3 6008 11013 5005 5124735 83 Linux dev sda4 11013 38154 27142 27792450 5 Extended dev sda5 11013 16017 5005 5124734 83 Linux dev sda6 16017 21022 5005 5124734 83 Linux dev sda7 21022 22560 1538 1574369 82 Linux swap Solaris dev sda8 22560 26560 4001 4096574 83 Linux 4 9 26560 27078 518 530144 83 Linux dev sda10 27078 27596 518 530144 83 Linux New situation Units mebibytes of 1048576 bytes blocks of 1024 bytes counting from 0 Device Boot Start End MiB blocks Id System Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C 133 Installing and Configuring BBS 134 dev sdal 0 1004 1005 1028159 83 Linux dev sda2 1004 6008 5005 5124735 83 Linux dev sda3 6008 11013 5005 5124735 83 Linux dev sda4 11013 38154 27142 27792450 5 Extended de
44. M 00 Id string AC4 MC Locator recID 2 full sensor record owner is IPMB 92 sensor num 00 on lun 00 channel 00 logical entity PICMG front board instance 60 AC4 HS Carrier FRU hot swap sensor specific discrete 5 5 2 34 sdr_dump Description This command shows the SDR records in binary and hex format Synopsis sdr_dump Example hpmemd c sdr dump SDR Records 01 00 51 12 19 92 00 29 00 00 00 0 60 00 Q i 41 43 34 20 4 43 20 4 6 63 61 74 6 72 4 Locator 5 5 2 35 sendcmd Description This command allows a user to send any of the commands supported in the IPMI spec to a remote IPMC 110 Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C Hardware Platform Management Synopsis sendcmd lt IPMBaddress gt lt netfn gt cmd data0 lt dataN gt Parameters IPMBaddress Destination IPMB address in hex digits netfn IPMI request net function in hex digits cmd request command in hex digits data0 dataN IPMI request data bytes if any in hex digits Example hpmemd c 90 06 59 07 59 Cl 5 5 2 36 sdrinfo Description This command shows the SDR information Synopsis sdrinfo Example hpmemd c sdrinfo SDR Information Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C 111 Hardware Platform Management LUN 0 has 054 sensors static sensor population LUN 1 has 00
45. OMMAND bash 0 ffff880216 f 83e40 handle sysrq at ffffffff8136ec6f 1 880216 83 80 write trigger at ffffffff8136edll Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C 143 Installing and Configuring BBS eee sg y _ 2 ffff880216f83e90 proc reg write at ffffffff8117623f 3 ffff880216f 83ee0 vfs write at ffffffff81118ce3 4 ffff880216 83f30 sys write at ffffffff81118f7a RIP 00000039986c2870 RSP 00007fffa9ef51e0 RFLAGS 00010206 0000000000000001 RBX ffffffff8100302b RCX 0000000000000400 RDX 0000000000000002 RSI 00007 2914 3000 RDI 0000000000000001 00007fffa9ef5a04 R8 000000000000000a R9 00007 291515700 R10 0000000000000022 R11 0000000000000246 R12 0000000000000002 R13 000000399894 780 R14 00007fa2914 3000 R15 0000000000000002 ORIG RAX 0000000000000001 CS 0033 SS 002b crash q 144 Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800195 Related Documentation B 1 Artesyn Embedded Technologies Embedded Computing Documentation The publications listed below are referenced in this manual You can obtain electronic copies of Artesyn Embedded Technologies Embedded Computing publications by contacting your local Artesyn sales office For released products you can also visit our Web site for the latest copies of our product documentation 1 2 3
46. P 100 5 5 2 2 lledpFOD isse rect EE NEAL SUE RR 100 52222 101 53 223 loglevelqet bero t 102 5 5 2 24 loglevelset 2 2 lt eee 103 5 5 2225 0 6 ree Ce e Ie ETE n 104 5 5226 motslielftype i i EXER ERE YN ERR ETE E AE 104 55 2 27 ERR EET rs 105 5 5 2 28 physlotnumber 2 Rem Ree hh ee xe e 105 5 5 2 29 pOLtget 105 5 5 2 30 NDOFESOE sioe E erede eae 107 fo ac Pc T 108 5 5 2 32 rebootpath 109 DEN Cr o eT US 109 5 2 2 34 sdr dU pe eiriaa A EP EDT TIE 110 5 5 2 35 hen 110 5 5 2 36 SAMO 1 111 5 5 2 37 5 2 I 112 55 238 shielislots i 112 5 5239 lt 5 113 5 5 2 40 re TRU 113 5 5 2 41 slotnumber 2 1 2 Ra err 113 5 5 2 42 solcIgget ae en Ce 114 5 5 2 43 501 6 52 64 e er
47. P server address and time zone 5 Above steps installs all the BBS packages that are available after tftpboot and Linux Boot loader on the hard disk Refer Installing BBS Using Hard Disk on page 131 for step wise output of the installation and configuration procedure Performing the Final Configuration on the ATCA 7368 The final configuration includes configuring the host name and password and setting the time zone 1 Configure the host name Choose a hostname for this machine There is no default hostname Enter a value here 2 Configure the root password Enter new UNIX password Retype new UNIX password There is no default root password Now the boot loader grub is installed After that you need to configure BIOS to boot from the hard disk as described in the following procedure Configuring the ATCA 7368 BIOS to Boot from Hard Disk To configure BIOS an ATCA 7368 blade proceed as follows 1 Connectto the blade via the serial interface 2 Power up or reboot the blade 3 Quickly hold down the F2 key on your keyboard until the BIOS menu appears Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C 35 Installing the Basic Blade Services Software 4 Select BOOT on the top menu 5 Scroll down to BOOT OPTIONS by using the arrow keys 6 Press ENTER 7 Depending on the hard disk type and the location where the hard disk is installed make sure that the correspondin
48. PNE4 0 tar xzvf atca7368_em_bsp_02_02_0000 tgz You can configure the ATCA 7368 platform project using either of the following e Project configure script e Wind River work bench for PNE 4 0 The ATCA 7368 BSP package is stored in the 7368 em folder The BSP consists of the following sub folders and files atca7368 em bsp bbs Itcontains the ATCA 7368 setup and configuration scripts along with the pre build BBS packages atca7368 em bsp distandatca7368 em bsp packages Itcontains modified tools services or specific patches atca7368 em bsp packages ltcontains the firmware packages in eSW format used by FUF to make the firmware upgrading atca7368 em bsp templates It contains the board specific configuration files It consists of the following files along with other sub folders and files atca7368 em bsp templates board atca7368 linux atca7368 scc The kernel configuration file atca7368 em bsp templates board atca7368 pkglist addand atca7368 em bsp templates board atca7368 pkglist remove RFS package list files Project Configure Script You can use the following script to configure the project atca7368 em bsp bbs scripts setEnv sh Parameters MUST be specified for this script setEnv ATCA7368 OBJ DIR PROJECT PATH PROJECT LAYER PATH lt INSTALL PATH Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95
49. The operating system comes with kernel 2 6 34 6 Various Linux services above the kernel will be activated by the BBS installation scripts e Hardware Platform Management Hardware Platform Management HPM in AdvancedTCA systems is based on Intelligent Platform Management Interface specification IPMI IPMI commands can be complex and cumbersome Using a certain set of commands HPM facilitates the blade or module level hardware management Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C Introduction e SNMP Agent As each BBS blade is individually managed the default installation script installs and initializes the Net SNMP agent e This release contains an RPM which contains all necessary files for developing HPI B applications For further information refer to the System Management Interface Based on HPI B Centellis 2000 4440 User s Guide Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C 21 Introduction eee 22 Basic Blade Services Software 7368 Programmer s Reference 6806800L95C Chapter 2 Installing the Basic Blade Services Software EMI 2 1 Overview Artesyn provides software images including software updates to its licensed customers In order to obtain the latest BBS software versions contact your local sales representative Generally there are three typical ways of installing booting the BBS software on ATCA 7368
50. a Store IPMI Boot Parameter USER area read from file Help The following example describes the steps required to change the BootOrder from SAS HDD to Base Network1 1 Read the IPMI boot parameter USER area from IPMC root ACPI4 C 9 ipmibpar g ipmibpar Version 1 02 IPMI Boot Parameter Demo Copyright 2008 Emerson Network Power Embedded Computing Inc Read System Boot Options from USER area local IPMC Hexdump IPMI Boot Parameter Size 608 0x260 0000 5c 02 77 68 65 61 3d 6f 00 68 79 70 65 72 lt whea on hyper_ gt 0010 74 68 72 65 61 64 69 67 6f 00 69 6d lt threading on 1lim gt 0020 69 74 5f 63 70 75 69 64 6f 66 66 00 65 64 5f lt it_cpuid off ed_ gt 0030 62 69 74 6f 00 68 77 5f 70 72 65 66 65 74 lt bit on hw_prefet gt 0040 63 68 65 72 6f 00 61 64 5f 63 61 63 68 lt cher on adj_cach gt 0050 65 5 70 72 65 66 65 74 63 68 6f 00 31 lt e_prefetch on 11 gt 52 Basic Blade Services Software 7368 Programmer s Reference 6806800195 Linux Distribution Description 0060 5f 70 72 65 66 65 74 63 68 6f 00 64 61 74 lt _prefetch on dat gt 0070 61 72 65 75 73 65 5f 6f 70 74 69 7a 65 6f areuse optmize o 0080 00 76 69 72 74 75 61 69 7a 61 74 69 6f lt n virtualization gt 0090 6f 00 74 75 72 62 6f 5f 6f 64 65 6 lt on turbo_mode o gt 0
51. ages Features Enhanced partition Simple partition Timezone NTP layout SMART layout and configuration Timezone and NTP autoconfig configuration Autoconfig Suitable for devices HDD SSD gt 30 GB HDD SSD or on On board USB flash or board USB flash USB stick 24 Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C Installing the Basic Blade Services Software 2 1 2 Package Information BBS software is packaged with the Red Hat Package Manager RPM and is installed as part of the standard installation In general you will not need to install or upgrade an individual package The BBS distribution contains the following packages Table 2 3 BBS Distribution Packages Description File Name Operating System Kernel Kernel version 2 6 34 6 kernel Ramdisk image for netboot Hard Disk Installation Root file system for hard disk installation ramdisk image gz rootfs tar gz Kernel command line default bbs atca7368 Check sum of all files and RPMs files shalsum BIOS package IPMI firmware package front blade 7368 bios version rpm 7368 em CPU type gt _ lt version gt rpm 7368 em CPU type gt noamc_ lt version gt rpm IPMI booter package front blade atca 7368_em_ibb_ lt CPU type gt _ lt version gt rpm atca 7368_em_ibbl_ lt CPU type gt noamc_ lt version gt rpm Blade FRU data
52. alues are enable authentication e char settings e nonvolatile bit rate e volatile bit rate payload channel payload port value The value which you want to set Sends the command to ipmbAddr mmcAddr ipmbAddr is the string Ic if itis a local mmcAddr 116 Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C Hardware Platform Management 5 5 2 44 upgrade Description This command is used to upgrade the IPMC firmware It is only possible to upgrade the firmware remotely from one blade to another not from the blade itself In case of an RTM upgrade the front blade will be powered down Synopsis upgrade lt image gt f lt filepath gt Parameters image Full path of the upgrade image file f filepath Full path of the upgrade image file This operation will make the current image the backup one 5 5 2 45 version Description This command retrieves the version of the hb mcmd software and sends a request to get the version of the hpmagent daemon that is running Once the information is gathered it is printed Synopsis version Example hpmemd c version hpmagentcmd version bbs 1 3 12 build 2 pne30 Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C 117 Hardware Platform Management 5 5 2 46 watchdog Description This command is used handle the payload BMC watchdog Synopsis watchdog set lt tmr_use gt lt tmr_action gt lt pr
53. and update the firmware version number string in FRU data accordingly referring to the IIF file e device to be used as the boot source on the next reset e Showtheversion of a specified firmware image file and compare the version of a specified firmware image file with the version of an installed firmware image By default the FCU binary executable is installed in opt bladeservices bin This directory has been added to the PATH environment variable FCU works in conjunction with device drivers created specifically for the flash devices on Artesyn blades The FCU verify and upgrade operations require specially prepared FRI or HPM files see Firmware Recovery Image Files on page 59 FCU also relies on the Hardware Platform Management Agent daemon to interact with the local IPMC Most commands will fail if the HPM Agent is not running For information on configuring and running HPM Agent see Chapter 5 Hardware Platform Management on page 74 Synopsis fcu help fcu version fcu d lt device id gt fcu v f filename fcu u f filename 66 Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C Firmware Upgrade Facility fcu filename fcu m b bank letter d lt device id gt Parameters a full upgrade This option is a shortcut for performing the verify upgrade and mark operations The file option f is required This option sh
54. annel quit Exit the hpmcmd program rebootpath Gets hpmagentd reboot script path sdr Shows the SDR records sdr_dump Shows the SDR records in raw format sdrinfo Shows SDR information sendcmd Sends an IPMI command shelfaddress Gets the Shelf Address String shelfslots Gets number of slots in the shelf shutdownpath Gets hpmagentd shutdown script path slotmap Prints the slotmap of the shelf slotnumber Shows the board logical slot number solcfgget Get SOL configuration parameter solcfgset Set SOL configuration parameter upgrade Allows to upgrade the IPMC firmware version Shows the hpmCmd version and the hpmagentd version watchdog Control Payload WDT functionality Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C 85 Hardware Platform Management 5 5 2 86 Supported Commands This section lists the supported commands All commands are case insensitive The examples illustrate the use of hpmcmd in single command mode If you start hpmcmd without the c or i options that is interactive mode you simply enter these commands at the HPM command prompt Some of the hpm commands can be sent to a remote IPMC by specifying the t option This option is not mandatory If it is not specified the command is sent to the local IPMC Basic Blade Services Software 7368 Programmer s Reference 6806800L95C Hardware Platform Management 5 5 2 1 bye Description This command
55. ar 0160 74 5f 65 74 5f 62 6f 6f 74 6f 66 66 00 tm net boot off 0190 61 72 74 5f 73 61 73 5f 62 6f 6f 74 6f artm sas boot on Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C 53 Linux Distribution Description 01 0 00 61 72 74 6d 5 0120 66 00 73 73 63 5f 0200 00 75 62 65 0210 62 6f 6f 74 5f 6f 0220 6e 65 74 2c 66 72 0230 65 6e 65 74 30 2c 0240 66 69 73 68 65 6c 0250 76 65 6e 74 5f 6c IPMI Boot Parameter whea on hyper threading on limit cpuid off ed bit on hw prefetcher on adj cache prefetch on 11 prefetch on datareuse optmize on virtualization on turbo mode on rt err log off pci log off vt d off int map on 73 72 72 63 5f 62 70 6f 72 3d 6f 66 3d 31 73 00 2 5 58 lt artm_fc_boot of gt lt f ssc_support on gt lt number_lock on gt lt boot_order front gt lt net frontnet gt lt enet0 basenetl e gt lt fishell smbios_e gt lt vent_log on X gt Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C Linux Distribution Description eco support on hw mem test on patrol scrub on demand scrub off all usb device on usb 2 0 cont mode on usb fp on rtm on onboard usb boot on baudrate 38400 os boot watchdog off 5 reset frontnet boot on basenet boot on fabricnet boot on artm net boot off artm sas boot on artm
56. ard Refer Installing BBS 4 Configure ATCA 7368 BIOS for network boot Software on Hard Disk Drive on 5 Boot BBS initrd image page 33 6 Install BBS image on hard disk via install script 7 Configure ATCA 7368 BIOS to boot from hard disk Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C 23 Installing the Basic Blade Services Software Table 2 1 BBS Installation Boot Options Main Set Up and Configuration Steps continued Installation Boot Option Main Set Up and Configuration Steps Installation and booting from on board USB flash Refer Installing BBS Software on On Board USB Disk on page 37 Set up and configure external TFTP boot server Configure DHCP server Configure PXE boot options Configure ATCA 7368 BIOS for network boot Boot BBS initrd image Install BBS image on USB flash via install script Configure ATCA 7368 BIOS to boot from USB flash SO ee NS For more information about the rpm command see its man page 2 1 1 Installation Scripts The following table describes the installation scripts required for installing the operating system and blade utilities for ATCA 7368 These installation scripts require a TFTP and a DHCP server to download the installation files Table 2 2 Installation Scripts linuxrc flashrfsrc flashrc Installed packages Kernel RFS and additional Kernel RFS and Kernel Ramdisk packages additional packages including BBS pack
57. ard flash device installs and configures the GRUB boot loader YE Executing the flashrfsrc script will erase all the data existing on the on board flash x 7 onfiguring BIOS for Diskless Network Boot To configure BIOS for network boot proceed as follows 1 Basic Blade Serv 2 3 4 5 6 7 Connect to the blade via the serial interface Power up or reboot the blade Quickly hold down the F2 key on your keyboard until the BIOS menu appears Select BOOT on the top menu Scrolldown to BOOT OPTIONS by using the arrow keys Press lt ENTER gt Ensure that the following settings are enabled Base Network 1 Base Network 2 FrontPanel Network 1 or FrontPanel Network 2 depending on interface you want to boot from If any of these settings is disabled enable the setting s and press lt F10 gt or select Exit Saving Changes to save the new settings and restart the BIOS After the restart press lt F2 gt to enter BIOS again and continue with the BIOS configuration ices Software on 7368 Programmer s Reference 6806800L95C 37 Installing the Basic Blade Services Software 38 8 9 Depending on which interface you want to boot from put eitherBase Network 1 Base Network 2 FrontPanel Network 1 OrFrontPanel Network 2 to the first position of the Boot priority order list Save and exit Installing Root File System on the on board Flash Optional To install the OS and BBS sof
58. are on ATCA 7368 Programmer s Reference 6806800L95C Installing and Configuring BBS Option Value Description path lt path gt Append path to the filesystem device which you are dumping to It is ignored for raw device dumps If unset it will use the default path var crash core_collector This directive allows you to use the dump filtering program makedumpfile makedump file to retrieve your core with reduced file size See lt options gt bin makedumpfile help list of options Note that the 1 and g options are not needed here as the initrd will automatically be populated with a config file for the running kernel link delay Some network cards may takes long time to initialize and some seconds spanning tree enabled networks do not transmit user traffic for long period after the link state changes This optional parameter defines a wait period after a link is activated in which the initramfs will wait before attempting to transmit user data default reboot Thiscommandis used to declare which action is to be performed shell either reboot or she11 instead of mounting root fs and running init process reboot It simply reboots the system and cancels the core that you are trying to retrieve shell If the default action is shell then drop to an msh session inside the initramfs from where you can try to record the core manually Exiting this shell reboots the system NOTE If no default action i
59. d on a standard Linux command shell 1 2 Software Building Blocks BBS services include a common set of functionality which is available for all AdvancedTCA blades and a unique set of functionality which is tailored to a particular blade Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C 19 Introduction 20 Figure 1 1 depicts the architecture of the BBS software Figure 1 1 BBS Architecture HPM CMD Customer Application FUF HPM Agent SNMP Agent Linux Distribution IPMC Firmware Processor Firmware HPM Hardware Platform Management FUF Firmware Upgrade Facility SNMP Simple Network Management Protocol IPMC Intelligent Peripheral Management Controller Application Middleware Operating System Firmware BBS for the ATCA 7368 consists of the following main software and services e Firmware Upgrade Facility The Firmware Upgrade Facility FUF provides a uniform way to upgrade firmware on Artesyn blades regardless on which flash locations the firmware is stored FUF upgrades the BIOS firmware as well as the IPMC firmware via HPM agent The FUF currently consists of a Firmware Upgrade Command Line Utility FCU flash device drivers and specially prepared firmware recovery image files The FUF can be used on switch and node blades e System Wind River Enterprise Linux 4 0 Carrier Grade Linux is the operating system for BBS blades and modules
60. dable through Artesyn FUF HPM 1 format BIOS image for ATCA 7368 IPMC firmware for ATCA 7368 The version include the presentations of CPU type with without AMC slot and the firmware version These image files were classified according to the CPU type and stored in different directories respectively IPMC boot loader for ATCA 7368 The version include the presentations of CPU type with without AMC slot and the firmware version These image files were classified according to the CPU type and stored in different directories respectively FRU data for ATCA 7368 The version include the presentations of CPU type with without AMC slot and the firmware version These image files were classified according to the CPU type and stored in different directories respectively FPGA image for ATCA 7368 IPMC Firmware for RTM ATCA 7368 Stored in directory artm 7368 artm 7368 em mmcb version hpm artm 7368 em frud version hpm artm 7360 mmcb version hpm IPMC boot loader for RTM ATCA 7368 Stored in directory artm 7368 FRU data for RTM ATCA 7368 Stored in directory artm 7368 MMC boot loader for RTM ATCA 7360 Stored in directory artm 7360 artm 7360_em_mmcf_ lt version gt hpm Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C artm 736xdd_em_mmcall_ lt version gt hpm 60 MMC firmware for RTM ATCA 7360 Stored in directory artm 7360 MMC firmware and b
61. e kernel in the file name Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C Installing the Basic Blade Services Software M 2 5 4 The packages from iles shalsumare installed in the same sequence as listed in the file files shalsum Theinstallation process re calculates the sha1sum of the packages on the blade and compares it to the shalsum determined by files shalsum This ensures a protection against errors and faults during file transmission The user will be notified in case of mismatch In that case you have to repeat the installation procedure The root file system must precede the rpm files the iles shalsumfile Modifying the Configuration of the Artesyn Supplied PNE Linux Kernel The current kernel configuration of arunning ATCA 7 368 installation can be retrieved using the Linux command zcat proc config gzor from atca7368_em_bsp template board atca7368 linux atca7368 cfginthe LSP directory of the Release package To modify the configuration of the CGL kernel supplied by Artesyn consult your local Artesyn sales representative for assistance and further information Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C 41 Installing the Basic Blade Services Software eee 42 Basic Blade Services Software 7368 Programmer s Reference 6806800L95C Linux Distribution Description 3 1 Overview This chapter describes the Linux distr
62. e copied out to disk by default in var crash lt YYYY MM DD HH MM vmcore then the system rebooted back into your normal kernel Once back to your normal kernel you can use the crash kernel in conjunction with the kernel debuginfo file to perform the postmortem analysis for example root ATCA 7368 13 crash no data debug boot vmlinux 2 6 34 6 grsec WR4 0 0 0 cgl var crash 2010 11 08 12N 05 vmcore crash 5 0 8 GNU gdb GDB 7 0 please wait gathering kmem slab cache data please wait gathering module symbol data WARNING invalid kernel module size 0 please wait gathering task table data Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800195 Installing and Configuring BBS please wait determining panic task KERNEL boot vmlinux 2 6 34 6 grsec WR4 0 0 0_cgl DUMPFILE var crash 2010 11 08 11 06 vmcore CPUS 6 DATE Mon Nov 8 19 05 52 2010 UPTIME 00 05 11 LOAD AVERAGE 0 00 0 02 0 00 TASKS 212 NODENAME ATCA 7368 13 RELEASE 2 6 34 6 grsec WRA4 0 0 0 cgl VERSION 41 SMP PREEMPT Wed Nov 3 02 08 00 HKT 2010 MACHINE x86 64 1994 Mhz MEMORY 8 GB PANIC Oops 0002 1 PREEMPT SMP check log for details PID 4982 COMMAND bash TASK ffff880214b5af40 THREAD INFO 880216 82000 CPU 0 STATE TASK RUNNING PANIC crash bt PID 4982 TASK ffff880214b5af40 CPU 0 C
63. e devices The procedures for upgrading BIOS and IPMC differ slightly The upgrade fails if the following is not taken into consideration Upgrade only one bank ata time then reboot and verify the upgrade using the query option If the upgrade fails and both banks become corrupted for any reason the ATCA 7368 will be rendered inoperable To prepare the ATCA 7368 for a BIOS upgrade the on board DIP switches of the ATCA 7368 must be set such that all BIOS flashes are writable This is the default configuration Refer to the ATCA 7368 Installation and Use guide for further details about DIP switch settings BIOS Upgrade The BIOS can only be upgraded from the ATCA 7368 on which the BIOS is running You have to upgrade the BIOS by using cu Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C 71 Firmware Upgrade Facility Upgrading the BIOS Firmware Follow these steps to upgrade the BIOS The shown file names and paths are only meant as an example and should be replaced with file names and paths applicable to your configuration 1 72 Query the current BIOS firmware images on the blade fcu qd atca 7368 cpu Showthe version of the new BIOS file to verify that it has actually a newer version than the already installed BIOS fcu show f opt bladeservices rom atca 7368 em bios_ lt verision gt fri or fcu show opt bladeservices rom atca 7368 em bios lt gt
64. e target file a standard ASCII file with one command per line comments are not supported The default is Standard Input stdin This option should not be combined with the option Once it has executed all commands in the file hpmcmd terminates output file Specifies the name of an output file where output file is the complete path and filename of the target file The default is Standard Output stdout command This option executes a single command and terminates where command is one of the supported commands This allows you to use the arrow history functions supported in the base shell a history is not available inside the hpmcmd program This option should not be combined with the i option Ifthis option is combined with o should last option entered since all arguments that follow c on the command line will be considered part of the command Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C 83 Hardware Platform Management 5 5 1 Command Overview The following table lists all commands from the hpmcmd program available on the ATCA 7368 You can display this list and a short command description using the help command see section help on page 98 A detailed description of the commands is given in section Supported Commands on page 86 Table 5 1 Command Overview Command Description bootbankget Gets the bootbank to boot from bootbankset Sets
65. e user mode Multiuser mode Multiuser mode with network default Not used Not used Reboot system Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C Linux Distribution Description 3 6 1 RC Scripts In addition to the rescripts of the Wind River PNE 4 0 Linux configuration the following start stop scripts are added to ATCA 7368 Run Level Script Name Description rc2 d S20kdump Starts the kdump service rc3 d S0lbbsrpms Installs bbs rpms during initial blade startup for example after blade installation or boot via network boot S02bbsinit Starts boardctrl driver and the optional persistent memory drivers pram and sfmem when the optional memory module is installed S03longPost Performs some basic blade tests before most of the OS services are started S10ethDevOrdering Performs the eth device reordering and renaming S57bbsvlan Configures ip addresses for the fabric interfaces and brings up the base and fabric interfaces S990sBootSensor Specifies the boot device and checks if watchdog is started or not It stops the watchdog if it is started already 3 7 Network Services Configuration The following sections describe the default configuration for network services 3 7 1 ATCA 7368 Ethernet Interfaces The ethernet devices such as ethO eth1 and eth2 in Linux distribution are renamed to more meaningful name in ATCA 7368 such as base1 base2
66. e_timeout gt lt flags gt lt lsb_val gt lt msb_val gt watchdog set default watchdog get watchdog start watchdog stop watchdog reset Parameters set Possible values are tmr_use dont_stop stop tmr_action no_action hard_reset power_cycle power_down pre_timeout 0 255 flags clear dont_clear Isb_val 0 255 msb val 0 255 118 Basic Blade Services Software ATCA 7368 Programmer s Reference 6806800195 Software 6 1 To help ease the implementation of highly available systems with off the shelf building blocks the Service Availability Forum SA Forum Hardware Platform Interface HPI specification HPI B defines a set of platform independent programming interfaces to monitor and control systems such as AdvancedTCA systems designed to provide high availability HPI provides applications and middleware a consistent standardized interface for managing hardware components This BBS release contains an HPI B library package For more information on Artesyn Embedded Technologies s HPI B implementation refer to the System Management Interface Based on HPI B User s Guide Basic Blade Services Software ATCA 7368 Programmer s Reference 6806800195 119 HPI B Software eee PP MM 120 Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C Board Control Module 7 1 Overview Board control is a kernel module which pr
67. ed led Is BLUE for the hot swap LED or LEDN for FRU LED lt n gt n is a number between 1 and the maximum FRU LEDs supported by the blade Sends the command to ipmbAddr mmcAddr ipmbAddr is the string Ic if itis a local mmcAddr Example hpmemd c ledget 0 1 1 5 5 2 21 ledprop Description This command displays the FRU LED properties under IPMC control Synopsis ledprop lt fruid gt Parameters fruid 100 Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C Hardware Platform Management 0 for the main board and 1 for the RTM Example c ledprop 0 FRU LEDs under IPMC control LEDO BLUE LED1 RED or AMBER LED2 GREEN 5 5 2 22 ledset Description This command controls the override state of a specific FRU LED The RTM FRU LEDs reflect the state of the main blade FRU 0 LEDs Therefore overriding the state to something different than the main FRU LED state will not have any effect The blue LED is the only one that can be controlled separately Synopsis ledset lt fruid gt led operation offms onms color t ipmbAddr mmcAddr Parameters fruid Is 0 for the main blade and 1 for the rear transition module if supported led Is BLUE for the hot swap LED or LEDN for FRU LED lt n gt n is a number between 1 and the maximum FRU LEDs supported by the blade Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C 10
68. ed BBS system With pre configured default settings user can easily configure their system to get and analysis the dumped vmcore dump file 138 Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800195 Installing and Configuring BBS Following are the list of files with procedure to perform the postmortem analysis 1 Configuration files File Configurable etc kdump conf YES etc sysconfig kd NO ump Comments Configures where to put the kdump vmcore files Default location is var crash Configures the capture kernel related options We use the same kernel for both the first kernel and the capture kernel with re locatable feature enabled etc init d kdump NO boot grub conf NO Start and stop kdump crash recovery service The kdump init script provides the support necessary for loading a capture kernel into memory at system boot up time and for copying away a vmcore at system panic time Boot parameters crashkernel to reserve a chunk of memory for the capture kernel in our case 256 64 2 kdump conf option description The kdump conf file configures manually or automatically to save the dumped core file proc vmcore It also configures the location to store the core file Typical kdump conf file looks like as follows auto_dump yes raw dev sdal ext3 dev sdal ext3 LABEL boot ext3 UUID 203138356 5e61 4ab3 b58e 27
69. eference 6806800L95C 39 Installing the Basic Blade Services Software 2 5 2 2 5 3 40 pushd mnt make all modifications and enhancements delete add or change files popd umount mnt gzip 9 ramdisk image The blade will now boot the modified root file system Modifying Hard Disk Installation The hard disk installation can be changed after the blade has been installed or by modifying the root s tar gz prior to the installation After modifying this file you have to compute and add the shal checksum of the modified root file system to the files shal1sum in the installation directory on the TFTP server The example below shows how to change the default login behavior cd tftpboot cd to the directory containing the rootfs tar gz you want to modify mkdir rootfs cd rootfs tar xzf rootfs tar gz Make your modifications and enhancements to the root filesystem in the current directory tar 2 rootfs tar gz shalsum rootfs tar gz Correct the shalsum for rootfs tar gz in files shal sum Modifying the Hard Disk Installation Procedure The hard disk installation procedure is based on the iles shalsumin the installation directory on the TFTP server All packages which are copied to the blade during installation are listed 1les shalsumtogether with their shalsum The standard installation process accepts rpm tar and tgz files and all files that hav
70. em_bsp bbs scripts atca7368_make_bbs shto build your BBS modules Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C Kernel and Root File System Config using 4 0 8 1 7 Getting Root File System and RAMDISK Image The root file system and RAMDSIK including BBS packages is created after successfully building kernel and root file system followed by post configuration of the root file system such as create admin user change ownership for ntp scripts create additional links to rescripts add additional device nodes and remove locals to save space in RAMDISK The post configuration tasks are performed by atca7368_make_image sh Script stored in atca7368_em_bsp bbs scripts directory Before executing the atca7368 make image sh script update PROJECT PATHandPROJECT LAYER PATH as per the location of atca7368 em bsp For example PROJECT PATH home ec7538 atca7368 ga01 prj PROJECT LAYER PATH home ec7538 atca7368 ga01 cml atca7368 em bsp A sample outputoftheatca7368 make image sh scriptis bash 3 2 sudo atca7368 make image sh Project Path home ec7538 atca7368 ga01 prj Project layer path home ec7538 atca7368 ga01 cml atca7368 em bsp Path to Result files home ec7538 atca7368 ga01 prj Path to Patch files home ec7538 atca7368 ga01 cml atca7368 em bsp bbs Path to Initramfs home ec7538 atca7368 ga01 cm1 atca7368 bsp bbs initramfs results fr
71. essing the reset button on the face plate 2 Observe that the blade is getting a DHCP address and is loading the kernel and ramdisk image Try to load pxelinux cfg lt address gt boot Loading blade module kernel Loading blade module ramdisk image gz 3 Once the blade has fully come up log on to the serial console as root with the default password root Installing BBS Software on Hard Disk Drive This section describes how to install and boot the BBS software from hard disk The BBS software can be installed on the following hard disk types SAS SATA hard disk drive installed on RTM or SATAcube on front board optional The installation process starts with the booting of an initial ramdisk via network The initial ramdisk is then used to copy via TFTP and interactively install the kernel the root file system and other BBS software on the disk Thefollowing procedures describe these steps in detail Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C 33 Installing the Basic Blade Services Software 34 Configuring BIOS for Diskless Network Boot To configure BIOS for network boot proceed as follows 1 9 2 3 4 5 6 7 Connect to the blade the serial interface Power up or reboot the blade Quickly hold down the F2 key on your keyboard until the BIOS menu appears Select ADVANCED on the top menu Scroll down to BOOT FEATURES
72. etter device lt device id gt e query query device lt device id gt e show file lt f ilename gt upgrade file ilename e upgrade mark file ilename e upgrade file ilename e verify file ilename verify upgrade file ilename verify upgrade mark file ilename version Multi character options may be abbreviated so long as they are unique For example u11 is equivalent to u11 upgrade Typing ver however will not work since it matches both verify and version Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C Firmware Upgrade Facility 4 5 4 5 1 Single character options may be combined without repeating the hyphen as in these examples fcu vf opt bladeservices rom lt filename gt fcu q d device id fcu q d lt device id gt fcu mb a d device id Options are not case sensitive For example he1p is equivalent to HeLp However option arguments such as filename and device ID are case sensitive When upgrading firmware it is strongly recommended that you upgrade only one device at a time While FCU performs many checks during upgrade to ensure success if something goes wrong and both firmware banks become corrupted the blade will be inoperable Upgrading a Firmware Image This section describes recommended procedures for upgrading firmwar
73. fc boot off support on number lock on boot order frontnet0 frontnetl basenet0 basenetl efishell smbios event log on 2 Savethe received IPMI Boot Parameter list into a file for example bootparam log and change the boot order as follow whea on hyper threading on Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C 55 Linux Distribution Description eee uu ns usse limit cpuid off ed bit on hw prefetcher on adj cache prefetch on 11 prefetch on datareuse optmize on virtualization on turbo mode on rt err log off pci log off vt d off int map on ecc support on hw mem test on patrol scrub on demand scrub off all usb device on usb 2 0 cont mode on 155 lt on rtm on onboard usb_boot on baudrate 38400 os_boot_watchdog off 5 reset frontnet_boot on basenet_boot on 56 Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C Linux Distribution Description eee fabricnet_boot on artm_net_boot off artm_sas_boot on artm_fc_boot off ssc_support on number lock on boot basenet0 basenetl frontnet0 frontnetl efishell smbios event log on 3 Write the IPMI parameter list file for example bootparam log ipmibpar s filename Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C 57 Linux Distribution Description eee 58 Basic Blade Services Software
74. force This option allows the installation of images with non matching part number and part revision FRU data fields This option should be used with extreme caution only because installing an incompatible image on a device may render it inoperable Displays a brief message describing command usage It also displays a list of the devices supported on the blade This option is exclusive and should not be used with other options This option needs a target destination t argument added when working with the IPMC or ARTM m Tells to set the boot select so that on the next boot the specified firmware bank will be active When mark is combined with the upgrade operation there is no need to specify a bank the bank just upgraded will be marked Otherwise you must specify a bank and a device Currently the mark operation only supports CPU firmware devices query Tells FCU to return firmware information for a specific device if used with or information about all firmware devices The query operation is exclusive and is not intended to be combined with other operations 5 show Shows detailed information about a specified file The information shown includes for example image type version manufacturer name etc This command may be useful before a firmware upgrade to determine the version of a new image file 68 Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C
75. g BIOS setting shown in the following table is enabled Hard Disk BIOS Menu and Setting Which Must Be Enabled SAS hard disk installed on RTM Boot Features gt ARTM SAS boot AS hard disk installed on AIV Boot Features gt ARITM SAS boo module in AMC bay 1 upper AMC bay ATA hard disk installed on AV Advanced Chipset Control gt Serial ATA module in AMC Bay 4 lower AMC bay If the desired setting was previously NOT enabled enable the desired setting and press lt 10 gt orselect Exit Saving Changes This will save the new settings and restart the BIOS After the restart press F2 to enter BIOS again and continue with the BIOS configuration 8 Putthe hard disk which you want to boot from to the first position of the Boot priority order list 9 Save and exit After a successful reboot you can logon as root using the password you have defined during the final configuration 36 Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800195 Installing the Basic Blade Services Software 2 3 3 Installing BBS Software on On Board USB Disk ATCA 7368 BBS supports network boot via tftp You can use 1ashrfsrc script to install the root file system on the ATCA 7368 on board flash and to boot from it The 1ashrfsrc script performs the following tasks formats the ATCA 7368 on board flash device transfers the kernel root file system and BBS packages from the tftp server to the on bo
76. hpib clientsrc version HPI B developer package bbs hpib devel version Uncompressed kernel image that vmlinux has accessible associated and debuginfo for crash dump analysis usage The following rpm commands are useful to review package information Command Description rpm List allinstalled packages Use rpm qa grep hpitolistonly packages rpm ql package name listthe content of a package where package name is name of a specific package for example rpm 41 openhpi rpm qi package name list information about a package where package name is the name of a specific package for example rpm qi openhpi rpm qf path to file Finds out which RPM a file belongs to 26 Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C Installing the Basic Blade Services Software 2 1 3 2 2 2 2 1 Accessing the ATCA 7368 via Serial Console In most procedures described in the following sections you need to invoke Linux commands or configure BIOS settings In order to do this you need to access the ATCA 7368 the face plate serial port If using a serial console or terminal emulator the default serial port settings are 9600 baud Noparity e Eight data bits One stop bit e Flow control xon xoff e Emulated terminal type VT100 If you wish to access Linux via a Linux shell the default account login is root with the pas
77. iations Application Programming Interface AdvancedTCA Advanced Telecommunications Computing Architecture ATCA Advanced Telecommunications Computing Architecture BIOS Basic Input Output System Carrier Grade Linux Central Processing Unit Dynamic Host Configuration Protocol Embedded Communications Computing FUF Command Line Utility Fault Management Field Programmable Gate Array Firmware Recovery Image Field Replaceable Unit Firmware Upgrade Facility General Purpose Input Output Hardware Platform Interface Hardware Platform Management Input Output Intelligent Platform Management IPMB Intelligent Platform Management Bus 14 Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C About this Manual Abbreviation Definition IPMC Intelligent Platform Management Controller IPMI Intelligent Platform Management Interface LED Light Emitting Diode LHC Link Health Check LSP Linux Support Package LUN Logic Unit Number MAC Media Access Control MIB Management Information Base NTP Network Time Protocol OEM Original Equipment Manufacturer OSDL Open Source Development Labs PC Personal Computer Peripheral Component Interconnect PCIx Express PICMG PCI Industrial Computers Manufacturers Group PXE Preboot Execution Environment RAM Random Access Memory ROM Read Only Memory RPM RedHat
78. ibution of ATCA 7368 BBS 3 2 Distribution Description The BBS for the ATCA 7368 is based on Wind River Enterprise Linux 4 0 which is a Linux distribution built on Linux 2 6 34 6 kernel technology 3 3 Reliability The hard disk installation is configured to use the journaling file system ext 3 In this distribution majority of errors that are caused due to improper shutdown are fixed automatically during the boot process Catastrophic errors that cannot be fixed automatically will yield to a command prompt allowing the super user to execute the command on the affected partition 3 4 Login A Linux shell can be accessed via the face plate serial port If you use a serial console or terminal emulator the serial RTM port settings are 9600 baud no parity 8 data bits and 1 stop bit If you use secure shell server it starts in run levels 2 5 and listens on all the Ethernet interfaces Root login for ssh is not permitted you need to log in as user admin If you use SSH refer Network Services Configuration on page 47 for default IP address assignments If you want to login as root via SSH you need to first configure SSH using the console serial port Set PermitRootLogininthefile etc ssh sshd_configto For this to take effect you must either reboot the blade or run the command etc init d ssh restart Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C 43 Linux Distribution Description
79. iption This command allows you to enter commands understood by the IPMC Commands are entered as a sequence of hexadecimal numbers as defined in the 1 5 Specification Synopsis cmd lt ipmi address gt lt netfn cmd gt lt cmd data gt Parameters ipmi address address specifies the that receives the command it can be the local IPMC or another IPMC on the IPMB The IPMI address for the local IPMC consists of f LUN where f is the BMC channel number The IPMI address for a remote IPMC consists of 0 SA LUN netfn cmd Identifies the command type cmd data Specifies the message data associated with the command Example GetDeviceld command to the local IPMC hpmcmd c cmd 0 6 1 Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C 93 Hardware Platform Management GetDeviceld command to the remote IPMC on address 9a c cmd 0 9a 0 6 1 GetDeviceld command to the remote IPMC on address 7a c cmd 0 7a 0 6 1 5 5 2 9 deviceid Description This command retrieves the raw IPMI Get Device ID response and decodes the IPMI message Synopsis deviceid t ipmbAddr mmcAddr Parameters t Sends the command to ipmbAddre mmcAddr ipmbAddr is the string lc if it is a local mmcAddr Example hpmemd c deviceid YE The least significant byte of the Auxiliary Revision indicates the build number inside the release 5 5 2 10 exit
80. is for exiting the hpmcmd program when running in interactive mode Synopsis bye 5 5 2 2 bootbankget Description This command retrieves the boot bank which is currently marked as active for the CPU specified by payload cpu selector Firmware for the CPU on Artesyn AdvancedTCA blades is stored in redundant persistent memory devices This allows the firmware image in one bank to serve as a backup for the other bank During normal operation the CPU on a blade determines which bankto boot from based on a GPIO signal controlled by the IPMC This bank is considered the active boot device Because you can change the active device with the hpmcmd bootbankset command active status does not necessarily indicate which device was used on the last boot It simply represents which device is set to be used on the next boot Synopsis bootbankget payload cpu selector Parameters payload cpu selector Is an integer between 0 and the number of CPU devices supported on the blade Example hpmemd c bootbankget 0 Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C 87 Hardware Platform Management 5 5 2 3 bootbankset Description This command sets the boot bank for a particular CPU from which the blade is supposed to boot Synopsis bootbankset payload cpu selector lt newBootBank gt Parameters payload cpu selector Is an integer between 0 and the number of CPU devices supported on the blade
81. ly an example of a possible packaging with example file names Please ensure that the file attributes are set to 755 so that PXE can access and load the files To ensure that the downloaded files are correct shal checksums are used If the shal checksums are not correct an error message is displayed during the installation process If you make changes to any of the files you need to remember to update the 5 1 checksum file as well If you still get an error message during the installation it is likely that one or more of the files have not been copied successfully Copy all the files to the t ftpboot directory again and restart the installation Configuring a TFTP Server The instructions in this section can be used to configure standard TFTP servers BSD compatible that are under the control of xinetd The exact configuration settings depend on the particular system configuration the following instructions are only meant as a general guideline Configuring a TFTP Server To configure TFTP as root on the host complete the following steps 1 Create or edit the file et c inetd d tftp Depending on the particular system environment it may contain the following entries etc inetd d tftp service tftp socket_type dgram Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C Installing the Basic Blade Services Software wait yes user root log_on_success USERID log_on_failure
82. mation Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C 103 Hardware Platform Management Example c loglevelset 7 5 5 2 25 macaddress Description This command retrieves a list of available MAC addresses Synopsis macaddress t ipmbAddr Parameters t ipmbAddr Sends the command to ipmbAddr Example hpmcmd c macaddress BASE Interface Channel 0 00 0E 0C 85 E9 91 BASE Interface Channel 1 00 0E 0C 85 E9 90 5 5 2 26 motshelftype Description This command retrieves the shelf FRU IPMB 20 Board Area Product Name FRU 254 Synopsis motshelftype Example hpmemd c motshelftype CHS1406 104 Basic Blade Services Software ATCA 7368 Programmer s Reference 6806800195 Hardware Platform Management 5 5 2 27 partnumber Description This command retrieves the part number of the main blade Synopsis partnumber t ipmbAddr mmcAddr Parameters t ipmbAddr Sends the command to ipmbAddr Example hpmcmd c partnumber 5 5 2 28 physlotnumber Description This command retrieves the physical slot number in which the blade is plugged in Synopsis physlotnumber 5 5 2 29 portget Description This command shows the current state of interfaces governed by e keying If no channel is specified portget returns data for all channels in the specified interface If neither interface nor channel are specified portget will return data for all interfaces Synopsi
83. newBootBank Can be set to BANKO or Example c bootbankset 0 1 5 5 2 4 bootparamerase Description This command allows you to erase data which is stored in the IPMC boot parameters storage area The data which is stored in this area can be accessed from the IPMI subsystem and also from the OS and boot firmware The storage area can for example be used in order to pass boot parameters to the boot firmware For further details refer to the ATCA 7368 Installation and Use Guide Synopsis bootparamget section name t ipmbAddr mmcAddr 88 Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C Hardware Platform Management Parameters section Section within the IPMC storage area in which data is to be erased Possible values are e USER e DEFAULT TEST 05 PARAM Name of the parameter which is to be erased Sends the command to ipmbAddr mmcAddr The ipmbAddris the string lc if it is a local mmcAddr Example hpmcmd c bootparamerase USER boot order Successful bootparamerase Operation 5 5 2 5 bootparamget Description This command allows you to read data which is stored in the IPMC boot parameters storage area The data which is stored in this area can be accessed from the IPMI subsystem and also from the OS and boot firmware The storage area can for example be used in order to pass boot parameters to the boot firmware For further details refer
84. nteractively that is it will not run as daemon 4 A Displays a brief message about command usage Displays the version of hpmagentd and the version of the OpenIPMI library it is linked against 5 3 hpm Start Up Script Description An HPM agent init script hpm allows you to start stop and restart the HPM agent daemon using the agent s default option settings By default this script is installed in the opt bladeservices etc init ddirectory during installation of the BBS software It is also linked to etc rec d recS dto automatically start the agent when the system boots Synopsis hpm start stop restart force reload Parameters start Starts the hpm agent daemon stop 80 Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C Hardware Platform Management Terminates the hpm agent daemon restart Terminates and then starts the hpm agent daemon force reload Terminates and then starts the hpm agent daemon 5 4 hpm Shutdown and Reboot Scripts Description At any time during normal operation a shelf manager may issue a shutdown FRU Activation Deactivate or graceful reboot FRU Control Reboot request to the IPMC on a given blade The IPMC then forwards this information to the HPM agent The HPM agent listens for such requests from the IPMC When it receives a request it calls the respective script to run the reboot or shutdown sequence In case of a shutd
85. ny results in the IPMI System firmware progress sensor as done by the default test scripts The IPMI boot parameter can be set by using the hpm command bootparamset hpm c bootparamset When Linux is booted the Linux start up script etc init d LPmain shis executed It reads and analyses the IPMI boot parameter variable runLP and invokes the listed test scripts if any in the given order For more advanced customizations you may want to modify the etc init d rd d LPmain sh script Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C 45 Linux Distribution Description 3 6 46 The LPmain sh provides the following options Table 3 3 Long POST Script LPmain sh Options Starts the Long POST for the specified test cases status Gives information about the test cases to be executed during long POST and shows whether longPOST is switched on enableLP Enables the long POST The Long POST will be executed during the next OS startup disableSP Disables the long POST The long POST will not be executed during the next OS startup Linux Services Initialization Table 3 4 describes the generic Linux run levels Table 3 1 describe the services configured to start in the various Linux run levels Per default the blade first runs run level S and then boots into run level 3 as configured by the factory Table 3 4 Generic Linux Run Levels Run Level Description Startup Halt system Singl
86. o time in the content hereof without obligation of Artesyn to notify any person of such revision or changes Electronic versions of this material may be read online downloaded for personal use or referenced in another document as a URL to an Artesyn website The text itself may not be published commercially in print or electronic form edited translated or otherwise altered without the permission of Artesyn It is possible that this publication may contain reference to or information about Artesyn products machines and programs programming or services that are not available in your country Such references or information must not be construed to mean that Artesyn intends to announce such Artesyn products programming or services in your country Limited and Restricted Rights Legend If the documentation contained herein is supplied directly or indirectly to the U S Government the following notice shall apply unless otherwise agreed to in writing by Artesyn Use duplication or disclosure by the Government is subject to restrictions as set forth in subparagraph b 3 of the Rights in Technical Data clause at DFARS 252 227 7013 Nov 1995 and of the Rights in Noncommercial Computer Software and Documentation clause at DFARS 252 227 7014 Jun 1995 Contact Address Artesyn Embedded Technologies Artesyn Embedded Technologies Marketing Communications Lilienthalstr 17 19 2900 S Diablo Way Suite 190 85579 Neubiberg Munich Tempe A
87. oaded files are compared to their expected values and if they are correct the root file system is un compressed and finally the BBS software s RPMs are installed Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800195 137 Installing and Configuring BBS A 2 Setting up the kdump Utility on a Hard Disk Driver Installed System Kexec and kdump are new features in the 2 6 mainstream kernel The purpose ofthese features is to ensure faster boot up and creation of reliable kernel vmcores for postmortem diagnostic purposes in case the system crashes Kexec Kexec is a fastboot mechanism which allows booting a Linux kernel from the context of already running kernel without going through BIOS Kdump Kdump is a new kernel crash dumping mechanism andis very reliable because the crash dump is captured from the context of a freshly booted kernel and not from the context of the crashed kernel Kdump uses kexec to boot into a second kernel whenever system crashes This second kernel often called as capture kernel boots with very little memory and captures the dump image The first kernel reserves a section of memory that the second kernel uses to boot in our case the memory region is 64 256 Kexec enables booting the capture kernel without going through BIOS hence contents of first kernel s memory are preserved which is essentially the kernel crash dump This feature has been integrated for Hard Disk Driver install
88. oader validates the new IPMC firmware Provided the IPMC can power up successfully the current image is made active and the previously active image is made backup In case of power up failures the boot loader automatically recovers from crisis and boots from the previous image BIOS BootBlock shall verify BIOS integrity by checksum calculation If the active BIOS is found corrupt a switch to the backup BIOS shall occur initiated by BIOS BootBlock The switch shall also occur in case the BootBlock code is missing or corrupt This BIOS independent switch is triggered by IPMC watchdog logic The FPGA bank can be updated via FCU or IPMC This means that a corrupt FPGA image can be restored using IPMC The following sample output displays the information regarding BIOS IPMI and FPGA Depending on your setup you may get a different output fcu q Ck ck ck ck ck KK KKK KKK ck ck ck ko kk BEGIN 1 1 1 1 KKKKKKKKKKKKKKKKK KKK OPERATION Query Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C 61 Firmware Upgrade Facility RESULT SUCCESS MESSAGE Device atca 7368 cpu Part number 0106866J03A Part revision REV A BANK A Firmware Name AMI BIOS Firmware Version Marked for next use gt Installed BIOS Version on BANK Firmware Name Firmware Version Marked for next use gt Installed BIOS Version on Bank1
89. om build process Symbol Files home ec7538 atca7368 ga01 prj export atca7368 vmlinux symbols WR4 0 0 0 cgl System Map home ec7538 atca7368 ga01 prj export atca7368 System map WR4 0 0 0_cgl Kernel home ec7538 atca7368 ga01 prj export atca7368 default kernel image WR4 0 0 0 cgl RootFileSystem home ec7538 atca7368 ga01 prj export atca7368 cgl glibc cgl dist tar bz2 Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C 129 Kernel and Root File System Config using 4 0 eee LinuxModules home ec7538 atca7368 ga01 prj export atca7368 linux modules WR4 0 0 0 cgl tar bz2 Building rootfs and ramdisk image for ACPI4 C 130 Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C Installing and Configuring BBS A 1 Installing BBS Using Hard Disk After the system comes up install Linux with the following procedure 1 Login as root 2 Identify the Linux device name of the hard disk on which you want to install BBS To do so enter disk 1 This displays available hard disks their Linux device names and also the storage capacity An easy way to identify a particular hard disk is by its storage capacity Refer to the respective hardware user manuals for information about the storage capacities of the hard disks used in your configuration Another way to identify a particular hard disk is via the device name Linux uses different device names f
90. on ATCA 7368 Programmer s Reference 6806800195 Hardware Platform Management This daemon has an init script called hpm that will start the daemon in run level 2 with the default settings When hpmagentd receives a graceful reboot or shutdown alert from the IPMC it will call the respective script to run the reboot or shutdown sequence Synopsis hpmagentd l log level r reboot script s shutdown script hpmagentd i u h v Parameters 1 log level Specifies the level of message logging where log level is one of the standard syslog levels Log Level Description Critical Error 2 3 4 Warning 5 Notice default r reboot script Specifies a graceful reboot script that will be called when a blade graceful reboot request is received by the IPMC where reboot script is the complete path and filename of the target script The default is opt bladeservices bin hpmreboot see hpm Shutdown and Reboot Scripts on page 81 Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C 79 Hardware Platform Management shutdown script Specifies a shutdown script that will be called when a blade shutdown request is received by the IPMC where shutdown script is the complete path and filename of the target script The default is opt bladeservices bin hpmshut down see hpm Shutdown and Reboot Scripts on page 81 hpmagentd runs i
91. onding number After choosing Germany for example the following output would be displayed The following information has been given Germany Therefore TZ Europe Berlin will be used Local time is now Sun Jan 2 12 58 05 CET 2005 Universal Time is now Sun Jan 2 11 58 05 UTC 2005 Is the above information OK 1 Yes 2 No 21 10 5 the time used on the blade It is possible to set the time automatically using an NTP server if an NTP server is available or to set it manually It is strongly advised that one of two methods is used to ensure that a valid date and time is set on the system before the installation of files begins If a valid NTP server is available answer the following question with y and enter the IP address of the NTP server Do you wish to use NTP to set the current time Y n Pleas nter the NIP server address If a NTP sever is not available then the time can be set manually To do so answer the following question with y and enter the date and time manually Do you wish to set the date manually Y n y Enter date in MM DD YYYY format Enter time in HH MM and 24 hour format The values entered are validated and ensure accuracy The value that is either gathered from the NTP server or entered manually is written to the hardware clock of the blade 11 Check SHA1 Checksums and Install Once the files have been downloaded the SHA1 checksums of the downl
92. onnectivity information where no specific field is requested Sends the command to ipmbAddr mmcAddr ipmbAddr is the string Ic if itis a local mmcAddr Example hpmemd c fruinfoget 1 bmanufacturer The following example for fruinfoget is without fields and v option c fruinfoget 0 5 5 2 13 fruinv Description 96 Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C Hardware Platform Management This command retrieves the FRU size and the addressable unit for the specified FRU Synopsis fruinv lt fruid gt t ipmbAddr mmcAddr Parameters feud Is 0 for the main blade and 1 for the rear transition module if supported sends the command to ipmbAddr mmcAddr ipmbAddristhe string Ic if itis a local mmcAddr Example hpmemd c fruinv 0 5 5 2 14 fruread Description This command gets a range of data from the specified FRU Synopsis fruread lt fruid gt lt startAddress gt nBytes t ipmbAddr mmcAddr Parameters fruid Is 0 for the main blade and 1 for the rear transition module if supported startAddress Is the starting address in decimal nbytes Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C 97 Hardware Platform Management Number of bytes to read in decimal cannot exceed 16 because of IPMI message size limitations Example hpmemd fruread 0 0 8 5 5 2 15 fruwrite Description This command allows to write x n
93. oot loader for RTM ATCA 736X DD Stored in directory artm 736xdd 4 3 Firmware Upgrade Facility Backup Concept The BIOS firmware for the ATCA 7368 is stored in redundant persistent memory devices This allows the firmware image in one bank to serve as a backup for the other bank This is particularly useful for firmware upgrades During normal operation the CPU on the ATCA 7368 determines which bank to boot from based on a chip select signal controlled by the IPMC This bank is considered the active boot device FCU will only allow you to upgrade an inactive device FUF allows you to upgrade only the BIOS boot bank from which the blade has not booted This means that you need to reboot the blade in case you want to upgrade both the banks of the BIOS flash The BIOS firmware image can be programmed via the payload by using FUF or via IPMC The IPMC firmware consists of a boot loader as well as an active and a stand by IPMI firmware The boot loader maintains both the active and stand by firmware in the flash memory of the ATCA 7368 Please note that the BootLoader Firmware is not installed in the BBS by default as the BootLoader update must be performed on Artesyn request only Each time the IPMC firmware is upgraded the most recent firmware version is kept in flash memory and the older firmware version is overwritten by the new one Once the new IPMI firmware is programmed the IPMC resets itself to boot from the new image The boot l
94. or different hard disk types The exact format however differs between Linux versions and distributions Refer to your Linux documentation for further details 3 Linuxrc script from the opt bladeservices tools directory linuxrc The hard disk installation begins by checking for necessary commands on the system The screen output will look similar to this Checking for necessary commands awk exists chroot exists mount exists umount exists tar exists gzip exists mkdir exists rmdir exists rm exists cp exists mv exists Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800195 131 Installing and Configuring BBS date exists chmod exists chown exists grep exists dd exists stty exists sed exists Necessary commands found safe to continue The following disks are available dev sda 40 0 GB dev sdb 4110 MB Following default settings were found export AUTO_DEV_NAME sda export AUTO_TFTPSRV 192 168 22 55 export AUTO TFTPLOC ATCA7368 export AUTO 2 export AUTO NTPUSE n export AUTO MDATEUSE n Do you want to use predefined values y n n Select the disk flash device where you want to have the filesystem installed e g sdc sda Verifying disk device dev sda done 132 Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800195 Installing and Configuring BBS 4 Start the installation by entering y for yes
95. ould not be combined with other operations b bank letter bank bank letter Specifies the bank to mark for next boot where lt bank letter gt is the letter designating a specific bank For BIOS banks possible values are A and B This option is used with the mark operation Use the query option q to display available banks compare Compares the image contained in the specified device with a specified file in the file system This may be useful after an image upgrade to verify that the device actually contains a new and different image d device id device lt device id gt Specifies a target firmware device where lt device id gt isthe name of the device This option is used with the mark or query operations Device ID values vary by hardware You can display supported devices on a given blade by using feu Currently supported values are listed in the following table Device ID Description atca 7368 cpu BIOS firmware image on ATCA 7368 atca 7368 hpm 1 ipmc IPMC firmware and FPGA image on ATCA 7368 artm 7368 hpm 1 ipmc RTM MMC firmware on RTM ATCA 7368 Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C 67 Firmware Upgrade Facility lt filename gt file lt filename gt Specifies the FRI file where lt fi Lename gt is the complete path and filename of the image file This option is used with the verify and upgrade operations
96. ovides access to the board FPGA The board control module creates a boardinfo directory and a file of BSP_VERSION_INFOin the proc file system that contains general information on the ATCA 7368 The following table describes the information in boardinfo directory File Description Sample output proc BSP VE Shows the BSP version 02_02_0000 RSION_INFO board_name Shows the boardname PCA ATCA 7368 0GB 6E as provided by the BIOS board versio Shows the board version 0106866J03A n as provided by the BIOS Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C 121 Board Control Module 122 File Description Sample output bios_version Shows the BIOS version 220220 board_serial Showstheserialnumber be filled by number of the board as provided by the BIOS fpga Shows additional FPGA FPGA version 0x10 information summary Shows asummary ofthe Board Vendor Emerson board state FPGA Board Name PCA ATCA registers and BIOS 7368 0GB 6E provided information Board Version 0106866J03A Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C Board Serial Number O E M BIOS Vendor BIOS Version BIOS Release Date To be filled by Emerson 1 0 10 01 07 2011 Last Reset Sourc Memory Module Device Bank PowerOn Reserved DIMM Socket P05 DIMM CPU O Size Data Width
97. own indication all running processes should be notified about the shutdown In case of a reboot notification the payload is responsible for invoking the reboot procedure The IPMC is not involved in this process This allows processes currently running on the blade to prepare for shutdown After the notification it takes roughly 30 seconds before the payload is powered off Two default scripts npmshutdown and hpmreboot are installed by default in the opt bladeservices bin directory Currently these scripts simply print a banner indicating they have run and then issue shutdown h now hpmshutdown script or reboot hpmreboot script You may modify the default scripts to suit the needs of your system application or create new scripts If you create new scripts use the s and r options when starting hpmagentd to specify the new locations and names ofthe scripts You may also need to update the hpm start up script in opt bladeservices etc init d hpm Synopsis hpmshutdown hpmreboot Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C 81 Hardware Platform Management 5 5 hpmcmd HPM Command Utility Description The HPM command utility uses a socket to send commands to the HPM agent The HPM agent takes care of translating the user friendly commands into the elaborated IPMI commands that the is able to understand Those IPMI commands are transferred to the local IPMC Only one HPM command can be o
98. r product or service names are the property of their respective owners 2014 Artesyn Embedded Technologies Inc
99. reboot scripts in response to cold reset or graceful reboot requests e Communicating local slot location information Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C 77 Hardware Platform Management The hpmagent d makes use of OpenIPMI to talk to the local consists of two main parts A device driver that goes into the Linux kernel and a user level library The following picture shows the software levels that are involved in the HPM architecture Figure 5 1 Software Levels of the HPM Architecture Hpmagentd User Space OpenIPMI library IPMI driver SMI BT KCS SIP Kernel Space IPMC BT Block Transfer Interface Serial Interface Protocol SMI System Management Interface KCS Keyboard Control Style The SMI System Management Interface driver provides the low level interface for communicating to IPMC with a KCS driver If you need more information about the software aspects of the blade IPM controller refer to the respective IPMI manual 5 2 hpmagentd HPM Agent Daemon Description TheHPM agent daemon handles local communication to the intelligent platform management controller on a blade using the SMI This SMI gets set up by the driver By default the hpmagentd binary executable is installed in opt bladeservices bin This directory has been added to the PATH environment variable 78 Basic Blade Services Software
100. rence 6806800L95C 75 Firmware Upgrade Facility eee 76 Basic Blade Services Software ATCA 7368 Programmer s Reference 68068001956 Chapter 5 Hardware Platform Management EN 5 1 Overview Hardware management in AdvancedTCA systems is based on the Intelligent Platform Management Interface IPMI specification IPMI commands can be complex and cumbersome To facilitate blade level management Artesyn provides the Hardware Platform Management HPM package that provides a set of commands that are based on IPMI commands but which are easier to use than the IPMI command itself An HPM command can encapsulate a sequence of IPMI commands for example upgrade the firmware or read the FRU data An HPM command can be the unifier for OEM IPMI commands that are different on different blade types for example reading the CPU boot bank For a catalogue of supported IPMI commands of the blade refer to the respective IPMI manual The HPM package consists of e HPM daemon called hpmagentd e Command line client called hpmcmd e Scriptframework for managing shutdown and reboot events The hpmcmd sends a given HPM command to the hpmagentd and displays the received response on the console The hpmagentd executes the incoming commands and returns the result to a client HPM commands include e Retrieving and modifying FRU data e Reading and controlling status of IPMI controlled LEDs Executing shutdown and
101. rizona 85282 Germany Contents About this Manual 13 Y introductions aiio e CONCERN DRE DOCE 19 IMEE CDUI PPM 19 1 2 Software Building Blocks 2 2 24 2 4 4 19 2 Installing Basic Blade Services Software 23 AME JUI METUIT 23 2 1 1 installation Scripts Den s bereke 24 2 1 2 Package Information 2 24 4 24 2 25 2 1 3 Accessing the ATCA 7368 Serial 27 2 2 Configuring TFTP DHCP 2 27 2 2 1 Create tftpboot Directory and Copy 27 2 2 2 Configuring TFTP 5 2 28 2 2 3 Configuring DHGP ORE RR ERE 29 2 24 Configuring PXE PR YE aS NT ERE 30 2 3 Installation Procedures 55 ER DM 32 2 3 1 Configuring ATCA 7368 for Diskless Client Boot of the BBS Software 32 2 3 2 Installing BBS Software on Hard Disk Drive 33 2 3 3 Installing BBS Software on On Board USB 37 2 4 Upgrading the Software
102. rvices Software on ATCA 7368 Programmer s Reference 6806800L95C Chapter 8 Kernel and Root File System Config using PNE 4 0 EN 8 1 8 1 1 8 1 2 Building Kernel and Root File System This section provides an introduction for building the Linux kernel and root file system for the ATCA 7368 with Wind River PNE 4 0 Prerequisites Thelocal RedHat Linux system should have Wind River PNE 4 0 installed The latest release of LSP is delivered and verified with the following Wind River 4 0 GA release packages PNE4 0 Base Package DVD R159194 1 1 00 DVD R159195 1 1 00 Additional Kernel Patches Table 8 1 describes the additional kernel packages required for ATCA 7368 These patches are storedinatca7368 em bsp templates board atca7368 1linux andare applied automatically during project configuration Table 8 1 7368 specific kernel patches Patch name Description dma ioat patch Add DMA IOAT support 18042 patch Suppress invalid error message i7core edac patch Add EDAC driver for Westmere coretemp patch Uses correct tjmax temperature RS Implicit source change warning message is not needed Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C 125 Kernel and Root File System Config using 4 0 8 1 3 8 1 3 1 126 Project Setup To setup the project extract the ATCA 7368 BSP package on your build machine You need access to Wind River
103. s portget interface channel t ipmbAddr mmcAddr Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C 105 Hardware Platform Management Parameters interface Valid values are BASE FABRIC UPDATE channel an integer in the following range 1 16 for Base 1 15 for Fabric 1 for Update The value of channel must be valid for the blade For example node blades have only 2 channels for the base interface using a value of 4 will return an error t ipmbAddr Sends the command to ipmbAddr Example hpmcmd c portget AMC 0 106 Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800195 Hardware Platform Management 5 5 2 30 portset Description This command enables and disables ports in a channel The following table lists the valid values for each parameter Synopsis portset intf chan lt grpid gt type typeX ports oper t ipmbAddr mmcAddr Parameters intf Valid values are BASE FABRIC UPDATE chan an integer in the following range 1 16for Base 1 15for Fabric 1 for Update The value of channel must be valid for the blade For example node blades have only 2 channels forthe base interface using a value of 4 will return an error grpid Always 0 according to current shelf FRU information type Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C 107 Hardware Platform Management
104. s specified the initramfs will mount the root file system and runs init You use as prefix to comment out those options which you do not want to use Q 3 Debug information files To support postmortem analysis the kernel debuginfo file have been provided as boot vmlinux in an HDD installed BBS system The uncompressed kernel image file has kernel symbols built in for debug purpose usage 4 Make your own configuration Basic Blade Services Software ATCA 7368 Programmer s Reference 6806800L95C 141 Installing and Configuring BBS 142 All the users need to modify the configuration et c kdump conf to specify the location where vmcore dumped files to be put up Restart the kdump service by running of the following command to make your modified configuration activated root ATCA 7368 13 service kdump restart Make the analysis Use the analysis tool crash with the option of no_data_debug to make the postmortem analysis For example root ATCA 7368 13 crash no data debug boot vmlinux 2 6 34 6 grsec WR4 0 0 0 cgl var crash 2010 11 08 11 06 vmcore An example You can force crash your system by echo ing a cinto proc sysrq trigger root ATCA 7368 13 echo c gt proc sysrq trigger You should see some panic output followed by the system restarting into the kdump kernel When the boot process gets to the point where it starts the kdump service your vmcore should b
105. sts routine detects an error Offset 0 0x00 Offset 1 OXFD Offset 2 Ox1E Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C Linux Distribution Description 3 5 2 The following table lists the names of the default long POST test routines and describes which tests each routine performs Table 3 2 Long POST Default Test Routines Test Routine Name Description cpuspeed This tool gives an overview on the active performance governors and the frequency per core memsSize Checks the amount of memory physically installed and the memory seen by the Operating system rtctest Tests the functionality of the real time clock eccTest sh This scripts tests checks the ECC Error counter in the memory controller Configuring the Long POST Behavior The names of the test scripts which are to be executed have to be defined in the IPMI system boot parameter variable runLP as comma separated list for example as follows runLP cpuspeed memSize sh rtctest eccTest sh The scripts are expected to be located in the following directory opt bladeservices tools LP Soinorderto add your own scripts simply add an entry to the IPMI boot variable runLP or add an appropriately defined kernel boot parameter run LP and place the script s in opt bladeservices tools LP Depending on your system configuration you may want to design your test scripts to generate console output write to the log module and store a
106. sword root Refer Login on page 43 for more information Configuring TFTP DHCP and PXE For all installation and boot options you need to set up and configure a TFTP server Furthermore for the diskless client and hard disk installation boot option you need to configure the system s DHCP server and configure PXE boot options All related steps are described in the following section Create tftpboot Directory and Copy Target Files It is customary to place TFTP files in a t ftpboot directory Regardless of the file system node you specify as the root for your TFTP service the installation scripts expect a certain directory structure when retrieving files Creating the tftpboot Directory and Copying the Target Files To create the expected directory structure and copy the needed files follow these steps 1 host create a t ft pboot directory if it does not already exist mkdir tftpboot Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C 27 Installing the Basic Blade Services Software 2 2 2 28 2 Create a subdirectory for ATCA 7368 for example mkdir tftpboot ATCA7368 3 Depending on the boot installation option copy or move the required installation files to the subdirectory Refer Table 2 3 on page 25 for BBS distribution packaging The exact file names in your BBS release may be different Refer the release notes applicable to your particular release Table 2 3 on page 25 is on
107. the blade copy the new RPM file to the blade stop the application using this rpm remove the original files using the rpm e package command and install the newly copied rpm using the command rpm Uvh package name command To upgrade the BBS software for diskless clients you have to delete the installation files in the t tpboot directory the tftpserver copy the new installation files into this directory and follow the instructions in Configuring 7368 for Diskless Client Boot of the BBS Software page 32 2 5 Adapting the BBS Software to Customer s Needs The BBS software structure allows a maximum flexibility with regards to customer s adaptations Software packages can easily be installed into or removed from existing installations Thefollowing adaptations are possible Modifying the NetBoot root file system Modifying the hard disk installation Modifying the hard disk installation procedure Modifying the Configuration of the Artesyn Supplied CGL Kernel 2 5 1 Modifying NetBoot Root File System The netboot root file system is stored in the file ramdisk image gz the TFTP server In order to change the system s behavior regarding network booting blades you have to modify the root file system As root cd tftpboot blade or module to be modified mkdir mnt gunzip ramdisk image gz mount o loop ramdisk image mnt Basic Blade Services Software on ATCA 7368 Programmer s R
108. the bootbank to boot from bootparamerase Erase boot parameter value bootparamget Get boot parameter value bootparamset Set a boot parameter value bye Exit the hpmCmd program chinfo Retrieve channel info cmd Execute any IPMI command deviceid Gets the Device 14 exit Exit the hpmcmd program frudata Allows to get FRU info in hex numbers fruinfoget Gets string fields from the FRU fruinv Allows to get the FRU size and addressable units fruread Allows to read x number of bytes from the FRU fruwrite Allows to write x number of bytes from the FRU help List of hpmcmd commands ipmbaddress Shows the local board IPMB address ipmcdevice Shows the payload interface to the IPMC ipmcstatus Gets the IPMC Status ledget Gets the state of a specific FRU LED ledprop Get the LED properties for this FRU ledset Controls the state of a specific FRU LED 84 Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800195 Hardware Platform Management Table 5 1 Command Overview continued Command Description loglevelget Gets the hpmagentd log level loglevelset Sets the hpmagentd log level 0 7 macaddress Lists the MAC addresses motshelftype Gets the Artesyn Shelf Type from the Shelf FRU Board Product Name partnumber Gets the board part number physlotnumber Gets the board physical slot number portget Shows the current state E Key governed intfs portset Enables Disables ports in a ch
109. ture AdvancedTCA Base Specification B 3 References The following table lists references documentations for which the BBS software is implemented Table B 3 Additional Resources Document Title Source Embedded SW Delivery Format Description for ATCA HW Platform Jarmo Kant NSN 146 Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C Related Documentation B 4 Additional Resources The following table lists additional resources which may be useful in working with Artesyn s AdvancedTCA systems Table B 4 Additional Resources Resource Source OpenHPI open source software project http openhpi org OpenHPI 1 0 Manual OpenHPI OpenHPI NetSNMP Subagent Development Manual OpenHPI Net SNMP http net snmp sourceforge net Pigeon Point Systems http www pigeonpoint com IPM Sentry Shelf External Interface Reference Pigeon Point Systems IPM Sentry Shelf Manager User Guide Pigeon Point Systems OpenIPMI http openipmi sourceforge net Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C 147 Related Documentation eee 148 Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C A mS Z arna Eu EMBEDDED TECHNOLOGIES Artesyn Embedded Technologies Artesyn and the Artesyn Embedded Technologies logo are trademarks and service marks of Artesyn Embedded Technologies Inc All othe
110. tware on the on board flash 1 2 8 Start the blade using ft p boot Execute flashrfsrc script available in the directory of opt bladeservices tools afteraninitial netboot It allows an automatic installation of the OS and BBS packages on the on board USB flash disk Provide the device name on which the software is to be installed when you are prompted for it You can modify the configuration file lashConfig default as per your requirement and use it for the installation Enterthe information requested by the script such as the TFTP server address from where the software is loaded NTP server address and time zone Above steps installs all the BBS packages that are available after tftpboot and Linux Boot loader on the hard disk Reboot the blade Press F2 to configure the BIOS In the Boot menu move onboard USBHdd SMART eUSB to the first option the Boot Priority Order list Save and exit BIOS settings and continue booting After successful installation the OS is loaded from the on board USB flash disk drive Refer Appendix A Installing and Configuring BBS on page 131 for step wise output of the installation and configuration procedure Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C Installing the Basic Blade Services Software 2 4 Upgrading the Software Software updates are usually delivered as rpm files To install the files on the disk of
111. umber of bytes to a FRU Synopsis fruwrite lt fruid gt lt startAddress gt lt nBytes gt t ipmbAddr mmcAddr Parameters fruid Is 0 for the main blade startAddress Starting address in decimal numbers nBytes is the number of bytes to write in decimal nBytes cannot exceed16 because of IPMI message size limitations 5 5 2 16 help Description This command lists the available commands from the hpmcmd program with a brief explanation about the command Synopsis help 98 Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800195 Hardware Platform Management 5 5 2 17 ipmbaddress Description This command retrieves the blade IPMB address Synopsis ipmbaddress 5 5 2 18 ipmcdevice Description This command retrieves the payload tty device Synopsis ipmcdevice 5 5 2 19 ipmcstatus Description This command retrieves the IPMC operating mode payload control and outstanding events Synopsis ipmcstatus v t ipmbAddr Parameters Verbose mode to get additional information operation Example hpmcmd c ipmcstatus v Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C 99 Hardware Platform Management 5 5 2 20 ledget Description This command gets information about a specified LED controlled by the IPMC Synopsis ledget lt fruid gt led t ipmbAddr mmcAddr Parameters fruid Is 0 for the main blade and 1 for the rear transition module if support
112. utstanding with the HPM agent at any particular moment This means that even though multiple instances of hpmcmd can be started the HPM agent will handle only one command at a time Once command is sent the hpmcmd program waits until the answer from the HPM agent is received or until a time out occurs The HPM command utility can be started in interactive mode where a promptis displayed and the user enters commands it can read in a file of commands or it can process a single command By default the hpmcmd binary executable is installed in opt bladeservices bin During installation of the BBS software this directory is added to the PATH environment variable If you do not provide any options you will see the following prompt once the program starts running hpmcmd From there you can start executing commands Synopsis hpmcmd p new prompt o output i input c command hpmcmd prompt new prompt output file output input file input cmd line command Parameters p new prompt 82 Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C Hardware Platform Management Specifies the prompt you would like to have for the hpmcmd interactive mode where new promptis any string The default prompt is hpmcmd gt This option should not be combined with the r or c options input file Specifies the name of a file with HPM commands where input file is the complete path and filename of th
113. v sda5 11013 16017 5005 5124734 83 Linux dev sda6 16017 21022 5005 5124734 83 Linux dev sda7 21022 22560 1938 1574369 82 Linux swap Solaris dev sda8 22560 26560 4001 4096574 83 Linux dev sda9 26560 27078 518 530144 83 Linux 10 27078 27596 518 530144 83 Linux Successfully wrote the new partition table Re reading the partition table If you created or changed a DOS partition dev foo7 say then use 1 to zero the first 512 bytes dd if dev zero of dev foo7 bs 512 count 1 See fdisk 8 Choose Dynamic IP Configuration You will be prompted to either accept dynamic IP configuration for the installation interface or to choose static configuration Artesyn recommends to use dynamic IP configuration for all blades Do you wish use static IP management y N Enter N or press lt Enter gt Choose the TFTP Server The TFTP server houses all of the files necessary for the installation There is no default choice Which Server do you wish to use A series of pings are sent to the server at the given address to ensure connectivity If the connection to the tftp server cannot be established the query will be repeated Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C Installing and Configuring BBS 7 Select the TFTP server installation directory known set of files is expected to be available
114. xample hpmemd slotnumber 9 5 5 2 42 solcfgget Description Retrieves the current serial over LAN SOL configuration SOL is a feature which allows you to redirect the serial console of the blade via an IPMI session over the network Refer to the blade s hardware user manual for further details Synopsis solcfgget channel param t ipmbAddr mmcAddr Parameters channel Channel number param The configuration parameter whose value you want to retrieve Possible values are enable e authentication e char settings retry e nonvolatile bit rate e volatile bit rate payload channel payload port 114 Basic Blade Services Software ATCA 7368 Programmer s Reference 6806800195 Hardware Platform Management eee Sends the command to ipmbAddr mmcAddr ipmbAddr is the string Ic if it is a local mmcAddr Basic Blade Services Software 7368 Programmer s Reference 6806800L95C 115 Hardware Platform Management 5 5 2 43 solcfgset Description Sets a serial over LAN SOL configuration parameter SOL is a feature which allows you to redirect the serial console of the blade via an IPMI session over the network Refer to the blade s hardware user manual for further details Synopsis solcfgset channel param value t ipmbAddr mmcAddr Parameters channel Channel number param The configuration parameter whose value you want to retrieve Possible v
115. y meant as an example and should be replaced with file names and paths applicable to your configuration 1 Query the current FPGA firmware images on the blade fcu q d atca 7368 hpm 1 ipmc The FCU tool reads the FPGA firmware version directly from the FPGA and not from the EEPROM Therefore you need to perform a blade power cycle before you can seethe version of a newly installed FPGA firmware 2 Showthe version of the new FPGA file to verify that it has actually a newer version than the already installed image fcu show f opt bladeservices rom atca 7368 em fpga version hpm 3 Upgrade the firmware image There are two options to do this via the u11 upgrade option and via the upgrade option Both the options are equivalent fcu full upgrade f opt bladeservices rom atca 7368 em fpga version hpm Or fcu upgrade f opt bladeservices rom atca 7368 em fpga version hpm Basic Blade Services Software on ATCA 7368 Programmer s Reference 6806800L95C Firmware Upgrade Facility This upgrades the user programmable FPGA EEPROM with the specified FPGA image file 4 Power cycle the blade If the blade fails to start up after an FPGA upgrade you need to reload the FPGA EEPROM Refer to the ATCA 7368 Installation and Use Guide for further details about the system boot option functionality as supported by the ATCA 7368 Basic Blade Services Software on ATCA 7368 Programmer s Refe

ATCA-7368 Basic Blade Services Programmer`s Reference

Contents

Download Pdf Manuals

Related Search

Related Contents