Upload
ibm-india-smarter-computing
View
218
Download
0
Embed Size (px)
Citation preview
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 1/92ibm.com /redbooks
Redpaper
Front cover
Using IBM Features on
Demand
David Watt
Jonathan Hio
Michael Hurma
Introduces IBM Features on Demandand the products that use it
Explains how to activate, install
and deploy the license keys
Provides troubleshooting
hints and tips
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 2/92
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 3/92
International Technical Support Organization
Using IBM Features on Demand
October 2012
REDP-4895-00
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 4/92
© Copyright International Business Machines Corporation 2012. All rights reserved.
Note to U.S. Government Users Restricted Rights -- Use, duplication or disclosure restricted by GSA ADP Schedule
Contract with IBM Corp.
First Edition (October 2012)
This edition applies to IBM System x M4 systems as well as IBM BladeCenter servers and IBM Flex Systemcompute nodes.
This document was created or updated on May 2, 2013.
Note: Before using this information and the product it supports, read the information in “Notices” on page v.
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 5/92
© Copyright IBM Corp. 2012. All rights reserved.iii
Contents
Notices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .v
Trademarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi
Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
The team who wrote this paper . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
Now you can become a published author, too! . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viii
Comments welcome. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viii
Stay connected to IBM Redbooks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix
Chapter 1. Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11.1 Components that offer FoD upgrades. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
1.2 Available tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
1.3 Minimum firmware levels. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Chapter 2. Acquisition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
2.1.1 FoD part numbers included in the server configuration . . . . . . . . . . . . . . . . . . . . . 6
2.1.2 FoD part numbers purchased separately from the server or chassis . . . . . . . . . . . 7
2.2 Authorization codes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
2.2.1 Tips on managing authorization codes and activation keys . . . . . . . . . . . . . . . . . . 8
2.3 Using the IBM Features on Demand website . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
2.3.1 Register an account with IBM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
2.3.2 Requesting an activation key . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
2.3.3 Retrieve history . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
2.3.4 Manage an IBM customer number . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
2.3.5 Retrieve an authorization code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
2.3.6 Generate a report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202.4 Emulex adapter unique identifiers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
2.4.1 Obtaining an FoD Identifier using Emulex OneCommand Manager . . . . . . . . . . . 23
2.4.2 Obtaining an FoD Identifier using Preboot DSA . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Chapter 3. Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
3.1 Installing a key using IMM2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
3.2 Installing a key using Preboot DSA. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
3.2.1 Install from USB memory key . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
3.2.2 Download and install from the Internet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
3.3 Installing a key using Portable DSA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
3.3.1 Downloading an FoD key from the Internet (download_fod_key) . . . . . . . . . . . . . 43
3.3.2 Installing a previously downloaded FoD key (install_fod_key) . . . . . . . . . . . . . . . 44
3.3.3 Downloading and installing an FoD key (install_imm_fod) . . . . . . . . . . . . . . . . . . 473.3.4 Portable DSA command summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
3.4 IBM Systems Director Feature Activation Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
3.5 Installing a key using ASU . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
3.5.1 Installing an activation key locally . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
3.5.2 Installing an activation key remotely . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
3.5.3 Downloading and installing an activation key to a local system . . . . . . . . . . . . . . 53
3.5.4 Downloading and installing an activation key to a remote system . . . . . . . . . . . . 55
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 6/92
iv Using IBM Features on Demand
Chapter 4. Backing up activation keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
4.1 Backing up feature activation keys using ASU . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
4.1.1 Exporting all activation keys from the local IMM key repository . . . . . . . . . . . . . . 58
4.1.2 Exporting all activation keys from a remote IMM key repository. . . . . . . . . . . . . . 59
4.2 Backing up FoD UIDs using Preboot DSA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
4.3 Backing up FoD UIDs using Portable DSA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
Chapter 5. Servicing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 655.1 Replacing a system board. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
5.2 Replacing an adapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
5.3 Moving an adapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
Appendix A. FoD Component reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
Abbreviations and acronyms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
Related publications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
IBM Redbooks publications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Other publications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Online resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77Help from IBM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 7/92
© Copyright IBM Corp. 2012. All rights reserved.v
Notices
This information was developed for products and services offered in the U.S.A.
IBM may not offer the products, services, or features discussed in this document in other countries. Consultyour local IBM representative for information on the products and services currently available in your area.Any reference to an IBM product, program, or service is not intended to state or imply that only that IBMproduct, program, or service may be used. Any functionally equivalent product, program, or service that doesnot infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility toevaluate and verify the operation of any non-IBM product, program, or service.
IBM may have patents or pending patent applications covering subject matter described in this document. Thefurnishing of this document does not grant you any license to these patents. You can send license inquiries, inwriting, to:IBM Director of Licensing, IBM Corporation, North Castle Drive, Armonk, NY 10504-1785 U.S.A.
The following paragraph does not apply to the United Kingdom or any other country where suchprovisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATIONPROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR
IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT,MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer ofexpress or implied warranties in cer tain transactions, therefore, this statement may not apply to you.
This information could include technical inaccuracies or typographical errors. Changes are periodically madeto the information herein; these changes will be incorporated in new editions of the publication. IBM may makeimprovements and/or changes in the product(s) and/or the program(s) described in this publication at any timewithout notice.
Any references in this information to non-IBM websites are provided for convenience only and do not in anymanner serve as an endorsement of those websites. The materials at those websites are not part of thematerials for this IBM product and use of those websites is at your own risk.
IBM may use or distribute any of the information you supply in any way it believes appropriate withoutincurring any obligation to you.
Any performance data contained herein was determined in a controlled environment. Therefore, the resultsobtained in other operating environments may vary significantly. Some measurements may have been madeon development-level systems and there is no guarantee that these measurements will be the same ongenerally available systems. Furthermore, some measurements may have been estimated throughextrapolation. Actual results may vary. Users of this document should verify the applicable data for theirspecific environment.
Information concerning non-IBM products was obtained from the suppliers of those products, their publishedannouncements or other publicly available sources. IBM has not tested those products and cannot confirm theaccuracy of performance, compatibility or any other claims related to non-IBM products. Questions on thecapabilities of non-IBM products should be addressed to the suppliers of those products.
This information contains examples of data and reports used in daily business operations. To illustrate themas completely as possible, the examples include the names of individuals, companies, brands, and products.
All of these names are fictitious and any similarity to the names and addresses used by an actual businessenterprise is entirely coincidental.
COPYRIGHT LICENSE:
This information contains sample application programs in source language, which illustrate programmingtechniques on various operating platforms. You may copy, modify, and distribute these sample programs inany form without payment to IBM, for the purposes of developing, using, marketing or distributing applicationprograms conforming to the application programming interface for the operating platform for which the sampleprograms are written. These examples have not been thoroughly tested under all conditions. IBM, therefore,cannot guarantee or imply reliability, serviceability, or function of these programs.
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 8/92
vi Using IBM Features on Demand
Trademarks
IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of International Business MachinesCorporation in the United States, other countries, or both. These and other IBM trademarked terms aremarked on their first occurrence in this information with the appropriate symbol (® or ™), indicating USregistered or common law trademarks owned by IBM at the time this information was published. Such
trademarks may also be registered or common law trademarks in other countries. A current list of IBMtrademarks is available on the Web at http://www.ibm.com/legal/copytrade.shtml
The following terms are trademarks of the International Business Machines Corporation in the United States,other countries, or both:
BladeCenter®
IBM Flex System™
IBM Flex System Manager™
IBM®
iDataPlex®
PureFlex™
Redbooks®
Redbooks (logo) ®
RETAIN®
System x®
The following terms are trademarks of other companies:
Intel, Intel logo, Intel Inside logo, and Intel Centrino logo are trademarks or registered trademarks of IntelCorporation or its subsidiaries in the United States and other countries.
Linux is a trademark of Linus Torvalds in the United States, other countries, or both.
Windows, and the Windows logo are trademarks of Microsoft Corporation in the United States, othercountries, or both.
Other company, product, or service names may be trademarks or service marks of others.
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 9/92
© Copyright IBM Corp. 2012. All rights reserved.vii
Preface
IBM® Features on Demand (FoD) is a new licensing procedure to enable features on System
x®, BladeCenter®, and Flex System servers and components. The components activated byFoD are already integrated into the server or adapter or other option. These components
remain locked until the upgrade is activated and applied to the server.
Features on Demand enables you to buy the features that you need now with the ability toenhance your system later without costly hardware upgrades. An example is the x3630 M4
and x3530 M4 servers that have two Intel Gigabit ports as standard but also include thehardware for two additional Gigabit ports should you later wish to activate them.
If you instead choose to purchase a server and the FoD upgrades at the same time, IBM
manufacturing can install the activation key on the server so that the FoD function is ready foryou to use when you receive the server.
This paper describes the processes involved with activating and installing the FoD upgrades.
We also cover activation key backup and what to do when servicing a system that has FoDupgrades already installed. This paper is meant for IBM employees, Business Partners, and
customers wishing to better understand the Features on Demand offerings and needing topurchase, install, or service a system with FoD upgrades.
The team who wrote this paper
This paper was produced by a team of specialists from around the world working at theInternational Technical Support Organization, Raleigh Center.
David Watts is a Consulting IT Specialist at the IBM ITSO Centerin Raleigh. He manages residencies and produces IBM
Redbooks® publications on hardware and software topics relatedto IBM Flex System, IBM System x, and BladeCenter servers and
associated client platforms. He has authored over 300 books,papers, and Product Guides. He holds a Bachelor of Engineering
degree from the University of Queensland (Australia), and hasworked for IBM in both the United States and Australia since 1989.David is an IBM Certified IT Specialist, and a member of the IT
Specialist Certification Review Board.
Jonathan Hiott is a Remote Support Technician for Bladecenter,PureFlex™, and System x in Atlanta, Georgia. He has been withIBM since December 2008 and has 11 years of experience inInformation Technology. His areas of expertise include assisting
clients to determine and solve problems on Bladecenter, PureFlex,and System x hardware.
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 10/92
viii Using IBM Features on Demand
Thanks to the following people for their contributions to this project:
IBM Development
Fred Bower Kathy Brown-Fitzpatrick Mollie Church Scott Busi Ke Jie Cao Le We Jie Jakub Kucharski
IBM Marketing
Miguel Bravo Otis Lackey Tim Martin
International Technical Support Organization
Linda Robinson
Now you can become a published author, too!
Here’s an opportunity to spotlight your skills, grow your career, and become a publishedauthor—all at the same time! Join an ITSO residency project and help write a book in your
area of expertise, while honing your experience using leading-edge technologies. Your effortswill help to increase product acceptance and customer satisfaction, as you expand your
network of technical contacts and relationships. Residencies run from two to six weeks inlength, and you can participate either in person or as a remote resident working from your
home base.
Find out more about the residency program, browse the residency index, and apply online at:
ibm.com/redbooks/residencies.html
Comments welcome
Your comments are important to us!
Michael Hurman is a Senior IT Specialist for IBM STG Lab
Services in South Africa. He has more than 13 years ofinternational experience in IT and has co-authored previous IBM
Redbooks publications including Implementing the IBMBladeCenter S Chassis , SG24-7682 and IBM eX5 Implementation
Guide , SG24-7909. His areas of expertise include assisting clientsto design and implement System x, BladeCenter, IBM SystemsDirector, midrange storage and storage area networks solutions.
He started his career at IBM in 2006.
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 11/92
Prefaceix
We want our papers to be as helpful as possible. Send us your comments about this paper or
other IBM Redbooks publications in one of the following ways:
Use the online Contact us review Redbooks form found at:
ibm.com/redbooks
Send your comments in an email to:
Mail your comments to:
IBM Corporation, International Technical Support Organization
Dept. HYTD Mail Station P0992455 South RoadPoughkeepsie, NY 12601-5400
Stay connected to IBM Redbooks
Find us on Facebook:
http://www.facebook.com/IBMRedbooks
Follow us on Twitter:
http://twitter.com/ibmredbooks
Look for us on LinkedIn:
http://www.linkedin.com/groups?home=&gid=2130806
Explore new Redbooks publications, residencies, and workshops with the IBM Redbooks
weekly newsletter:
https://www.redbooks.ibm.com/Redbooks.nsf/subscribe?OpenForm
Stay current on recent Redbooks publications with RSS Feeds:
http://www.redbooks.ibm.com/rss.html
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 12/92
x Using IBM Features on Demand
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 13/92
© Copyright IBM Corp. 2012. All rights reserved.1
Chapter 1. Introduction
IBM Features on Demand (FoD) is technology that allows upgrades to System x,
BladeCenter, and Flex System servers and optional adapters through key activation whereinfeatures are already present in the particular server or adapter but are not available for use
until they are unlocked with their respective FoD activation key.
The preferred method of activation is done by IBM manufacturing or through the businesspartner. If you purchase a feature as part of a server order, the IBM factory or business
partner enables the feature as part of the configuration and testing of the server. You canbegin using the feature when you receive the server.
Alternatively, if you purchase an FoD option or upgrade that is separate from the server order,
you must complete the feature activation when you install the option. In this case, an
authorization code with instructions for activating the feature is mailed to you.
An authorization code is a 22-character alphanumeric string that is the proof of purchase andentitlement to upgrade one or more units with a particular feature. The authorization code and
instructions for requesting an activation key are on a printed document that is mailed to you. Ifyou order directly from IBM, the authorization code and instructions can also be sent to the
e-mail address that you provide when you register on the FoD website.
Either way, once keys are applied to the system, they are permanently stored in a keyrepository in the server. For upgrades such as adding features to network adapters, the key
repository is the Integrated Management Module II (IMM2) in the server.
The use of IBM Features on Demand has the following benefits:
Upgrade as you go
For example, like most servers, the IBM System x3530 M4 has two active GigabitEthernet ports. The server also has two additional Ethernet ports, but you do not need to
enable those until you need them. When you are ready, you purchase and install theactivation key and those ports are now available for use.
Lower up front cost
Purchase keys at a later time and add to existing hardware. For example, if you do not
need premium features like RAID 6 and 60 in your RAID controller, or FCoE in an Emulex
1
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 14/92
2 Using IBM Features on Demand
10 GbE adapter, then you do not need to purchase them when you initially order the
server.
Software-based key upgrades
Features on Demand is software based. There are no additional hardware components to
install, so remote deployment is much easier and key deployment can be scripted ifneeded to upgrade multiple systems at once.
Various key management options
Various components of the IBM ToolsCenter support FoD, including IMM2, IBM Advanced
Settings Utility (ASU), IBM Systems Director, and IBM Dynamic System Analysis (DSA).
In this paper, we primarily discuss Server-based features such as the Intel I-350 EthernetController upgrade, along with IMM2 upgrades, RAID controller upgrades, and Emulex
upgrades.
1.1 Components that offer FoD upgrades
A variety of components support FoD upgrades and the list continues to grow. Here are someexamples:
System upgrades:
Upgrading IMM2 to support remote presence or a web interface Activating additional Ethernet ports (Intel I350 Embedded Controller) Activating FCoE and iSCSI on 10 Gb Ethernet ports (Emulex VFA III) Activating RAID 6 or other premium features (ServeRAID 5100)
Figure 1-1 shows the rear of the IBM System x3530 M4 with two active Gigabit Ethernet portsplus two additional ports that can be activated via a Features on Demand upgrade.
Figure 1-1 IBM System x3530 M4 with four Gigabit Ethernet ports: 2 active and 2 via FoD
Most FoD features are per device, such as the Intel I-350 Embedded Dual Port GbE NIC,
Emulex VFA III, and the Integrated Management Module II Remote Presence feature. Each ofthese devices requires its own FoD activation key. For the Emulex VFA III, each ASIC, orchip, requires its own activation key.
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 15/92
Chapter 1. Introduction3
ServeRAID cards such as the M5100 series are able to utilize one key for multiple cards that
are installed in a single system.
1.2 Available tools
These tools are available to help install and manage FoD features for systems and optionalcards:
Features on Demand website
Allows users to install and manage FoD authorization codes and activation keys
http://ibm.com/systems/x/fod/
IBM Integrated Management Module II (IMM2)
Server-based management interface that allows users to install and remove FoDactivation keys
IBM Systems Director
Centrally-managed FoD functionality that allows users to download, install, and manageactivation keys
http://ibm.com/systems/software/director/
IBM ToolsCenter
Download portal for server management tools such as DSA and ASU.
http://ibm.com/support/entry/portal/docdisplay?lndocid=TOOL-CENTER
IBM Dynamic System Analysis (DSA)
Operating system or preboot tool that allows users to install and manage FoD activation
keys
http://ibm.com/support/entry/portal/docdisplay?lndocid=SERV-DSA
Advanced Settings Utility (ASU)
Command line based utility that allows users to install and manage FoD activation keys
http://ibm.com/support/entry/portal/docdisplay?lndocid=TOOL-ASU
1.3 Minimum firmware levels
The following firmware levels are required for systems using FoD:
DSA version 9.20 or later must be installed in order to use FoD functionality
IMM2 must be present. There is no support for FoD using IMM.
UEFI firmware level must be at the designated required level for the hardware option that
you are adding.
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 16/92
4 Using IBM Features on Demand
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 17/92
© Copyright IBM Corp. 2012. All rights reserved.5
Chapter 2. Acquisition
An IBM Features on Demand (FoD) activation key provides the means to unlock a feature on
an IBM server, chassis, switch, or option.
This chapter describes the methods available to obtain the Features on Demand activationkeys. It also provides the necessary information required to maintain and report on existing
activation keys.
The procedures to install the keys are in Chapter 3, “Installation” on page 29.
This chapter contains the following sections:
2.1, “Introduction” on page 6 2.2, “Authorization codes” on page 7 2.3, “Using the IBM Features on Demand website” on page 9 2.4, “Emulex adapter unique identifiers” on page 22
2
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 18/92
6 Using IBM Features on Demand
2.1 Introduction
IBM Features on Demand (FoD) upgrades are orderable part numbers like any otherSystem x option. In order to use them, they must be activated first for the specific system or
component they will be used on. The FoD upgrade is activated in one of the following ways:
Automatically during manufacturing – if the FoD part numbers are ordered as par t of aconfigure-to-order (CTO) or Special Bid configuration
Manually after delivery via the web interface or other tools – if the FoD part numbers areordered separately
We described these two methods in this section.
2.1.1 FoD part numbers included in the server configuration
If you configure an FoD upgrade as part of a server or chassis order, IBM manufacturing orthe business partner enables the feature as part of the configuration and testing of the server
or chassis. You can begin using the feature when you receive the server or chassis. The
steps for this process are detailed here and illustrated in Figure 2-1.
1. A purchase order is placed to IBM by the business partner or customer directly.
2. An activation key is requested internally by IBM fulfillment. This key is generated by theFeatures on Demand website, also referred to as the IBM Key Management System
(KMS).
3. The activation key is made available to manufacturing to activate the required features onthe purchased systems. The systems are then delivered to the customer with the relevant
features activated.
Figure 2-1 FoD order process where the FoD keys are installed by IBM manufacturing
Tip: When ordering systems it is best, where possible, to purchase the Features onDemand upgrades with the order and have them installed by IBM manufacturing.
Place order
Customer
or
Partner
Key
Management
System
FulfillmentRequest
key
Generatekey
Installkey
Send product with activated key
3
2
1
IBM
Manufacturing
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 19/92
Chapter 2. Acquisition7
2.1.2 FoD part numbers purchased separately from the server or chassis
If you purchase an FoD option or upgrade separately from a server or chassis order, you willneed to activate the feature yourself using one of the supported interfaces, such as the IMM2web interface for System x servers. In this case, an authorization code with instructions for
activating the feature is mailed to you.
An authorization code is a 22-character alphanumeric string that is the proof of purchase and
entitlement to upgrade one or more units with a particular feature. Details about obtainingactivation keys from authorization codes is discussed in 2.2, “Authorization codes”.
The steps for obtaining an activation key using an authorization code are detailed here and
shown in Figure 2-2.
1. A purchase order is placed to IBM by the business partner or customer directly.
2. IBM fulfillment provides the business partner or customer with an authorization code.
3. The authorization code is submitted by the business partner or customer to IBM via the
Features on Demand website (with its back-end system the Key Management System orKMS).
4. The KMS generates an activation key, which is downloaded by the business partner orcustomer.
5. The activation key is installed on the relevant system requiring a feature activation.
Figure 2-2 FoD order process when the FoD keys are ordered separately
2.2 Authorization codes
Authorization codes are used when an order for Features on Demand part numbers is placed
separately.
An authorization code is a 22-character alphanumeric string that is the proof of purchase andentitlement to upgrade one or more instances of a component with a par ticular feature.Authorization codes are entered into a document and either printed and sent to you or
emailed to you. The document contains the following information:
Name and part number of the FoD upgrade Quantity ordered Your order number One authorization code
Place order Request
key
Generatekey
Key
Management
SystemReceive paper (and optionalemail) with authorization code
Download activation key
Fulfillment
Customer
or
Partner
Install key
3Submit authorization
2
1
4
5
IBM
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 20/92
8 Using IBM Features on Demand
Instructions on how to use the authorization code to obtain activation keys.
When purchasing an FoD upgrade separately, an authorization code is mailed to the
business partner or customer in the postal mail only. To receive the authorization code viapost, email or both, the business partner or customer must register on the website. The
registration process is described in 2.3.1, “Register an account with IBM” on page 9.
The authorization code is used to generate activation keys from the IBM Features on
Demand website. The authorization code is entered on the website and the subsequentactivation key or keys are generated.
You can also use the authorization code on the website to retrieve the history of all activationkeys generated from that authorization code and to regenerated keys if needed. The process
of using an authorization code to retrieve a feature activation key is detailed in 2.3.2,“Requesting an activation key” on page 12.
2.2.1 Tips on managing authorization codes and activation keys
This section provides some general useful tips for managing authorization codes andactivation keys.
Distributors and resellersSome tips for distributors and resellers:
Have IBM manufacturing install the feature activation keys as part of the order purchasewhere possible to save time and administration.
Do not stock FoD authorization codes as a standard business practice. Stocking excess
authorization codes is not recommended because it front loads your expenses and cancause additional unnecessary administration.
Place one order for keys per end customer so that a unique authorization code isgenerated for that customer.
Determine who is responsible to receive and process FoD authorization codes. Ensure
that more than one person is registered to receive the authorization codes for redundancypurposes.
CustomersSome tips for customers:
Have IBM manufacturing install the feature activation keys as part of the order purchasewhere possible to save time and administration.
Determine who is responsible to receive and process FoD authorization codes. Ensure
that more than one person is registered to receive the authorization codes for redundancypurposes.
Tip: Register on the FoD website before placing your FoD order. This will ensure that youreceive the authorization code via email as well as mail at the time of order.
Authorization codes are one-to-many: It is important to note that a single authorizationcode might be associated with a single activation key or multiple activation keys for the
same type of component. The number of activations you can get from a singleauthorization code is printed on the document that you are sent. It is also listed on the
website.
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 21/92
Chapter 2. Acquisition9
Store the paper authorization codes in a safe place.
Ensure that the emailed electronic copies of the authorization codes are backed up and
kept in a central location for those requiring access to them.
Learn how to navigate the FoD website for managing FoDs.
Store downloaded activation keys in a central location that is backed up. This will be
useful to technical staff that might require quick access to the keys in case of emergency.Note that the keys can always be retrieved from the FoD website as well.
2.3 Using the IBM Features on Demand website
The IBM Features on Demand (FoD) website is the primary tool used to manage FoDs. The
IBM Features on Demand website is located at the following URL:
http://ibm.com/systems/x/fod/
The website is used to accomplish the tasks outlined in the following sections:
2.3.1, “Register an account with IBM” on page 9 2.3.2, “Requesting an activation key” on page 12 2.3.3, “Retrieve history” on page 16 2.3.4, “Manage an IBM customer number” on page 17 2.3.5, “Retrieve an authorization code” on page 19 2.3.6, “Generate a report” on page 20
2.3.1 Register an account with IBM
It is necessary to register an account with IBM before an authorization code can be used toobtain single or multiple activation keys. To register an account:
1. Navigate to the following URL and click register at the bottom of the page:
http://ibm.com/systems/x/fod/
2. Complete the details requested on Step 1 of the My IBM Registration page shown in
Figure 2-3 on page 10 and click Continue.
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 22/92
10 Using IBM Features on Demand
Figure 2-3 Registering an account
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 23/92
Chapter 2. Acquisition11
3. Complete the additional user details in Step 2 of the registration process as shown in
Figure 2-4 and click Submit.
Figure 2-4 User and company registration details
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 24/92
12 Using IBM Features on Demand
4. Click Continue after the registration process has been completed. If registration was not
successful, use the Help and FAQ on the left side of the page as shown in Figure 2-5 orrefer to the following URL:
https://www.ibm.com/account/profile/us?page=reghelpdesk
Figure 2-5 Obtaining help for a none successful registration
2.3.2 Requesting an activation key
This section describes how to create an activation key from the authorization code that you
received in the mail from IBM.
Before you begin, make sure that the following items are available:
Authorization code that is at the top of the IBM Feature Activation Instructions documentthat was sent to you in the mail.
Access to the hardware or software that you want to activate so that you can determinethe Unique Identifier (UID) required to identify the component you want to upgrade.
Complete the following steps to activate a Features on Demand feature using anauthorization code:
1. Navigate to the FoD website at the following URL:
http://ibm.com/systems/x/fod/
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 25/92
Chapter 2. Acquisition13
2. Click Sign In as shown on the FoD main page in Figure 2-6.
Figure 2-6 Features on Demand website
3. On the Sign in page shown in Figure 2-7, enter your IBM ID and password and click
Submit.
Figure 2-7 Features on Demand sign in page
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 26/92
14 Using IBM Features on Demand
4. On the Welcome page, select Request activation key either from the center or left of the
page, as shown in Figure 2-8.
Figure 2-8 Request activation key option
5. Enter the authorization code provided to you on the Request activation key page shown inFigure 2-9 and click Continue.
Figure 2-9 Entering an authorization code
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 27/92
Chapter 2. Acquisition15
6. Enter the unique identifier (UID) specified for feature activation in the Universally UniqueIdentifier field as shown in Figure 2-10.
Figure 2-10 Entering the unique identifier
For server options, the UID is usually the machine type and serial number, entered
together with no spaces, of the target server. Refer to Appendix A, “FoD Componentreference” on page 69 for information about what UID is required for each FoD upgradetype and where to find it.
Emulex adapters and controllers use a different UID, as described in 2.4, “Emulex adapterunique identifiers” on page 22.
For features that include additional constraints, such as the entitlement number of chassis,an additional prompt is displayed during the authorization code redemption process. Thecurrent entitlement is displayed and you are asked for the new entitlement number. Enter
the value when you are prompted. For more information about constraints, see yourfeature documentation.
7. Click Generate key after all the necessary information has been supplied. A summary ofwhat will be created is displayed. Make sure that the information is correct before you clickConfirm.
8. Download and save the activation key. We describe how to use it to activate the feature inChapter 3, “Installation” on page 29.
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 28/92
16 Using IBM Features on Demand
2.3.3 Retrieve history
On the Retrieve history page, you can use the authorization code or the unique identifier(UID) to search for activation key history. The retrieve history page also allows you tore-retrieve an activation key that might have become lost due to a hardware replacement.
The results from a search using the authorization code lists all activation keys that aregenerated for the authorization code. The results from a search using the UID lists all
activation keys that are generated for the UID.
To retrieve the history, complete the following steps:
1. Select Retrieve history from the left navigation pane, as shown in Figure 2-11.
Figure 2-11 Retrieving history of activation keys
2. Enter either the authorization code or the UID in the fields shown in Figure 2-12 and clickContinue.
Figure 2-12 Retrieving activation key history using an authorization code or UID
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 29/92
Chapter 2. Acquisition17
The results displayed, as shown in Figure 2-13, provide the following information:
The total number of activation keys associated with the authorization code.
The total number of keys available for additional UIDs that have not been registeredagainst the authorization code.
A list of registered UIDs against an authorization code.
Figure 2-13 Retrieve history results for an authorization code or UID
Retrieving an existing activation key using Retrieve historyTo retrieve an activation key that might have been inadvertently deleted or lost due to system
or component failure, do the following:
1. Complete the steps detailed in 2.3.3, “Retrieve history” on page 16 using the UID of thesystem or component as required. The authorization code can also be used.
2. On the Retrieve History results page, as shown in Figure 2-13, select the device for whichyou want to retrieve the key. To send the key information to the email address of the userwho is logged in, click Email. To download the activation key directly to your computer,
click Download.
2.3.4 Manage an IBM customer number
On the Manage IBM customer number page, you can see a list of the customer numbers forwhich you have administrative authority and any users who are registered for the customer
number. You can add or remove users as administrators for a customer number.
Tip: If you cannot select a customer number in the Customer number field, click Contacts in the right navigation pane to contact customer support for your region.
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 30/92
18 Using IBM Features on Demand
To manage the IBM customer number, complete the following steps:
1. Select Manage IBM customer number from the left navigation pane, as shown in
Figure 2-14.
Figure 2-14 Manage IBM customer number main page
2. Select a customer number to which your IBM user ID is linked from the drop box and click
the arrow.
3. To link additional users to your customer number, complete the following steps as shownin Figure 2-15 on page 19:
a. In the Add IBM user ID field, enter the IBM user ID.b. Click Add user. The user ID, user name, and user email address are displayed.
c. Click Confirm.
IMPORTANT: Each user must have an IBM user ID and must have signed on at leastonce on the IBM Features on Demand website, otherwise they cannot be linked to a
customer number.
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 31/92
Chapter 2. Acquisition19
All users who are linked to a customer number will receive authorization codes through email
for future orders that are placed.
Figure 2-15 Linking additional users to a customer number
2.3.5 Retrieve an authorization code
On the Retrieve Authorization Code page, you can request to have a PDF file with an
authorization code emailed to you. This can be handy if you have inadvertently misplacedyour authorization code.
To retrieve an authorization code, complete the following steps:
1. Select Retrieve Authorization Code from the left navigation pane, as shown in
Figure 2-16 on page 20.
2. Enter the customer number, order number, and part number. These numbers are on thepacking list that comes with your order.
3. Enter your email address if it is not pre-populated.
4. Click Submit. A confirmation window is displayed and the necessary information will beemailed to you.
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 32/92
20 Using IBM Features on Demand
Figure 2-16 Retrieving an authorization code
2.3.6 Generate a report
On the Generate report page, you can create several report types based on the following:
Machine type and serial number
Generates a report showing activation keys generated for a specific system. This report
will show activations such as Intel, IMM2, and ServeRAID features, but not ones likeEmulex VFA III.
Other UID
You can use this option to generate a report showing activation keys generated for an FoDidentifier number other than machine type and serial number. An example is the FoD
identifier for an Emulex VFA III adapter.
Authorization code
Generates a report showing activation keys generated for a specific authorization code.
Order number
Generates a report showing authorization code types that shipped under the enteredorder number. It will also show all the activation keys that are linked to the foundauthorization codes.
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 33/92
Chapter 2. Acquisition21
Reports are generated in a .csv format and are sent via email.
To generate a report:
1. Select a report type from the Report type drop box, as shown in Figure 2-17.
Figure 2-17 Selecting a report type
2. Based on the selected report type, enter an applicable value in the Report input field. The
example in Figure 2-18 shows a machine type and serial number entered to generate areport based on this information type.
Figure 2-18 Generating a reported based on machine type and serial number
Tip: Do not use a dash or space when entering the machine type and serial number in
the Report Input field.
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 34/92
22 Using IBM Features on Demand
3. You can refine the result by selecting a customer number for which you are an
administrator. Select the customer number in the Customer number filter field.
4. Click Submit. A confirmation window is displayed and you will receive an email with thereport attached.
2.4 Emulex adapter unique identifiers
Unlike most system and adapter FoD upgrades, Emulex adapters use a special Unique
Identifier (UID) for FoD upgrades. The adapters in question include the ones listed inTable 2-1.
Table 2-1 Emulex adapters that support IBM Features on Demand
There are two tools available to obtain the FoD Identifier for an Emulex adapter. The tools are:
Emulex OneCommand Manager (HbaCmd) The Preboot Dynamic System Analysis tool (DSA)
We suggest using OneCommand Manager (HbaCmd) to obtain Emulex adapter FoDidentifiers because the software is ultimately required to change the personality of the adapter
(FCoE or iSCSI). This allows easier identification of FoD identifiers when multiple adaptersare installed.
Receiving FoD emails: FoD reports are sent from the email address [email protected].
Ensure that this address is added as an exception to your email spam filters so that thereport will not be blocked.
Emulex adapter FoD upgrade FoD type
Description Part / FC Description Part / FC HbaCmd
(Hex)
DSA
(Dec)
Emulex 10GbE Virtual Fabric
Adapter II for HS23 (CFFh)
81Y3120
A287
Virtual Fabric Advanced FOD
Upgrade for IBM BladeCenter
90Y9350
A2ZP 8001 37769
IBM Flex System™ CN4054 Virtual
Fabric Adapter
90Y3554
A1R1
IBM Flex System CN4054 Virtual
Fabric Adapter (SW Upgrade)
90Y3558
A1R0 8004a
a. The Flex System CN4054 adapter has two ASICs however only one activation key is needed per adapter.
32772
10 GbE embedded in HS23
10 GbE embedded in x240
10 GbE embedded in x440
NoneIBM Virtual Fabric Advanced
Software Upgrade (LOM)
90Y9310
A2TD
8005 32773
Emulex Dual Port 10GbE SFP+Embedded Adapter for IBM
System x
90Y6456A22J
Emulex Embedded VFA IIIFCoE/iSCSI License for IBM
System x
90Y5178A2TE
Emulex Dual Port 10GbE SFP+
VFA III for IBM System x
95Y3762
A2U1 Emulex VFA III FCoE/iSCSI
License for IBM System x (FoD)
95Y3760
A2U2 800b 32779
Emulex Dual Port 10GbE SFP+
Integrated VFA III for IBM System x
Noneb
A2UN
b. Emulex Dual Port 10GbE SFP+ Integrated VFA III is only available through CTO or Special Bid (SBB 95Y3768 or
FC A2UN).
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 35/92
Chapter 2. Acquisition23
It is important to note the following before we discuss the tools used to identify UIDs on
Emulex adapters:
Each application-specific integrated circuit (ASIC) on an Emulex adapter has its own FoDidentifier (UID). So in the case of the IBM Flex System CN4054 Virtual Fabric Adapter,there will be two FoD identifiers because the adapter contains two ASICs. Both of the FoD
identifiers will be required to obtain the activation keys for the card because activation is
done at the ASIC level.
The Emulex activation key derived from the UID will only unlock the ability to change thecard personality to iSCSI or FCoE. You will still have to use the OneCommand Manager
tool to set the personality after the key has been installed and the system restarted.
The Emulex adapters and controllers that support FoD upgrades are listed in Table 2-1 onpage 22. Ensure that the correct FoD upgrade part number is ordered; the process of
applying the activation key will not be successful if you attempt to use the wrong one.
Even after you install the key as described in Chapter 3, “Installation” on page 29, theIMM2 is unable to read the Emulex ASIC identifier, so it marks the keys as installed, but
the key has to be validated by the Emulex firmware during UEFI system initializationbefore it is activated. The IMM2 status for these keys does not change if they are in use or
not in use by the Emulex options that are installed in the system.
Table 2-1 on page 22 also lists the FoD type used for each FCoE/iSCSI upgrade.
Depending on the software tool used, you will see either a four-digit hexadecimaldescriptor type or a five-digit decimal descriptor type:
– Emulex OneCommand Manager (HbaCmd) displays the FoD descriptor type in
hexadecimal notation (for example, 800b).
– IBM Dynamic System Analysis displays the FoD descriptor type in decimal notation (forexample, 32779).
If an FoD part number is ordered, the authorization code you receive will only create anactivation key for the specific FoD descriptor type. The activation key you download from
the FoD website has a filename of the format:
ibm_fod_type_identifier_anyos_noarch.keyIn this name, type is the four-digit descriptor type in hex notation from Table 2-1 onpage 22 and identifier is the last 16 digits of the Emulex FoD identifier that you entered
to create the key.
The remainder of this section describes how to retrieve the Emulex FoD identifier using bothEmulex OneCommand Manager and IBM Preboot Dynamic System Analysis.
2.4.1 Obtaining an FoD Identifier using Emulex OneCommand Manager
Emulex OneCommand Manager is a tool used to manage Emulex adapters. This is the
preferred method of obtaining the FoD Identifier. The tool can be downloaded from the
following URL:
http://www.emulex.com/downloads/ibm.html
After the tool is installed, do the following to obtain a UID for an ASIC:
1. Open OneCommand Manager. In our example, shown in Figure 2-19 on page 24, we havetwo Emulex III VFAs. The first adapter shown is an Emulex Dual Port 10GbE SFP+
Embedded VFA III for IBM System x (00D9117). The second adapter is the Emulex Dual
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 36/92
24 Using IBM Features on Demand
Port 10GbE SFP+ VFA III for IBM System x (95Y3764). We will obtain the FoD identifier for
the first adapter only.
Figure 2-19 OneCommand Manager console showing two Emulex VFA III adapters (x3650 M4)
2. Take note of either of the MAC addresses shown for the first adapter (see Figure 2-19).This information will be used to identify the FoD identifier of the card.
3. We will use the Emulex HbaCmd CLI tool included with OneCommand Manager to identify
the FoD identifier for the card. Navigate to the tool, which is located in the OneCommandManager installation directory. On Windows for example, the tool might be located in:
C:\Program Files\Emulex\Util\OCManager
4. To obtain the FoD identifier for the ASIC on the first adapter, type:
hbacmd getfodinfo MAC address
MAC address is the address of one of the MAC addresses on the first adapter.
Tip: If the card has two ASICs, as is the case with the IBM Flex System CN4054 10Gb
Virtual Fabric Adapter, one MAC address from each ASIC must be noted. Both FoDidentifiers are required to obtain the activation keys for the card because activation is
done at the ASIC level.
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 37/92
Chapter 2. Acquisition25
For our example, the output is as shown in Figure 2-20.
Figure 2-20 Obtaining the FoD Identifier using the HbaCmd utility
5. Copy the FoD Identifier value and enter it onto the FoD website as described in 2.3.2,
“Requesting an activation key” on page 12.
2.4.2 Obtaining an FoD Identifier using Preboot DSA
Preboot Dynamic System Analysis (DSA) is a diagnostics tool integrated in the server’s
firmware. To retrieve an FoD Identifier using Preboot DSA, use the following steps:
1. Power on the system and press the F2 button when the UEFI splash screen appears, as
shown in Figure 2-21.
Figure 2-21 F2 option to enter diagnostics
C:\Program Files\Emulex\Util\OCManager>hbacmd getfodinfo 5c-f3-fc-36-17-c0 FoD Identifier: FK3W8VCZNTAL73W1X5XDJ126T7R9WKW9FoD Status: disabledFoD Type: 8005 (LOM)
Tip: The FoD Type number shown in Figure 2-20 can be cross-referenced with the FoD
descriptor type available from the HbaCmd column in Table 2-1 on page 22 to ensurethat the correct feature upgrade is ordered for the Emulex adapter.
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 38/92
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 39/92
Chapter 2. Acquisition27
6. The Preboot DSA Welcome page will open, as shown in Figure 2-24.
Figure 2-24 Preboot DSA Welcome page
Click System Inventory from the left menu. A System Inventory menu will appear in the rightpane, as shown in Figure 2-25.
7. Select the Manual radio button.
8. Deselect all the options in the Data Set column except for the Emulex option, as shown inFigure 2-25. This will allow the DSA Preboot tool to run quickly by gathering only the
required data.
9. Click Begin to commence the inventory collection.
Figure 2-25 Selecting the Emulex data set to run an inventory against
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 40/92
28 Using IBM Features on Demand
10.After the inventory is complete, the Status column for Emulex will change to Completed.
Click the Emulex text to show the data collected. A sample of the Emulex inventory isshown in Figure 2-26.
In our example, we have two Emulex III VFAs installed. The first adapter shown is anEmulex Dual Port 10GbE SFP+ Embedded VFA III for IBM System x (00D9117). The
second adapter is the Emulex Dual Port 10GbE SFP+ VFA III for IBM System x
(95Y3764).
Figure 2-26 Emulex FoD Identifier and Type shown in Preboot DSA (x3650 M4)
11.Copy the FoD Identifier value, as shown in Figure 2-26, and enter it onto the FoD websiteas described in 2.3.2, “Requesting an activation key” on page 12.
Tip: The FoD Type value shown in Figure 2-26 can be cross-referenced with the FoDtype in the DSA column in Table 2-1 on page 22 to ensure that the correct upgrade part
number is ordered for the Emulex adapter type.
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 41/92
© Copyright IBM Corp. 2012. All rights reserved.29
Chapter 3. Installation
In this chapter, we discuss the various tools available to install Features on Demand
activation keys. It is always advisable, where possible, to have the activation keys installed byIBM manufacturing to simplify the FoD process.
We assume that you have already downloaded the activation key. See Chapter 2,
“Acquisition” on page 5 for details about this.
As we noted in 1.1, “Components that offer FoD upgrades” on page 2, some activation keysare applied per device and others are applied per system.
Topics we cover in this chapter are:
3.1, “Installing a key using IMM2” on page 30 3.2, “Installing a key using Preboot DSA” on page 35 3.3, “Installing a key using Portable DSA” on page 43 3.4, “IBM Systems Director Feature Activation Manager” on page 49 3.5, “Installing a key using ASU” on page 50
3
Note: The use of the Chassis Management Module (CMM) and Flex System Manager(FSM) to install activation keys is out of scope for this paper.
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 42/92
30 Using IBM Features on Demand
3.1 Installing a key using IMM2
In this section, we describe how to apply an FoD activation key using the IntegratedManagement Module II (IMM2) web interface.
In this example, we apply the FoD upgrade for the Intel I350 Embedded Dual-port GbE
adapter, used to enable Ethernet por ts 3 and 4 on supported servers such as the x3530 M4.
1. If you have not already purchased the FoD upgrade and received the authorization code,follow the instructions in Chapter 2, “Acquisition” on page 5. The Intel I350 upgrade for thex3530 M4 is part number 90Y9314.
2. Use the instructions in 2.3.2, “Requesting an activation key” on page 12 to download theactivation key. In our case, the file we downloaded was:
ibm_fod_8003_7160KQ5N05V_anyos_noarch.key
8003 is the FoD type for the Intel I350 2-port upgrade. 7160KQ5N05V is the unique ID,which in this case is a concatenation of the machine type and serial number of our lab
system.
See Appendix A, “FoD Component reference” on page 69 for a listing of the various FoD
type numbers.
3. Login to the IMM2 web interface using your IMM credentials as shown in Figure 3-1 onpage 31.
If you do not know the IP address of the IMM2, reboot the server and enter System Setup
(pressing F1 when prompted); navigate to System Settings Integrated Management
Module Network Configuration and note the IP address listed there.
Using x3100 M4 and x3250 M4 servers: These instructions assume that the webinterface of the IMM2 is enabled. For entry servers such as the x3100 M4 and x3250 M4,
the web interface is itself an FoD upgrade, which represents a chicken-and-egg situation –we are using the web interface to install an FoD upgrade but an FoD upgrade is needed onthese systems before the web interface can be used.
Therefore, on these servers, you must use another method to install an FoD key (includingthe one to enable the IMM2 web interface), such as using Preboot DSA as described in
3.2, “Installing a key using Preboot DSA” on page 35.
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 43/92
Chapter 3. Installation31
The default IMM credentials are USERID and PASSW0RD (0 is zero).
Figure 3-1 IMM login page
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 44/92
32 Using IBM Features on Demand
4. From the menu bar, click IMM Management Activation Key Management, as shown
in Figure 3-2.
Figure 3-2 Activation Key Management menu
5. The Activation Key Management panel, Figure 3-3, lists any activation keys already
installed. In our example, the IMM2 Advanced Upgrade (which enables remote control) isalready installed. Click Add to install a new key.
Figure 3-3 Add activation key
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 45/92
Chapter 3. Installation33
6. The Add Activation Key window appears. Click Select File, browse to the location of the
key file, and click OK. In our example, you can see the Intel I350 activation key file isready to be installed, as shown in Figure 3-4.
Figure 3-4 Intel I350 FoD key selection
7. Click OK to upload the key file. If the key is valid for this system, a Success dialog isdisplayed, similar to Figure 3-5. Click Close.
Figure 3-5 Key installed successfully
8. A reboot might be required. See Appendix A, “FoD Component reference” on page 69 forspecifics. In our example, a reboot is required to activate the third and fourth Intel I350
Ethernet ports of the x3530 M4.
9. The Activation Key Management panel now shows that the process is complete, as shownin Figure 3-6.
Figure 3-6 Key installation complete
Tip: Success here means that the process of applying the key was successful. Somekeys, such as those for Emulex controllers, are only validated via the Emulex firmware
during UEFI system initialization. You can check the actual status of Emulex activationkeys via the Emulex HbaCmd command or via IBM DSA.
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 46/92
34 Using IBM Features on Demand
Additional considerations for ServeRAID upgradesAll FoD upgrades for ServeRAID controllers are system-wide upgrades and not tied to anyone controller or adapter. For example, if your server has a ServeRAID M5110e controller onthe system planar and three ServeRAID M5110 adapters installed in the server, then applying
one RAID-6 activation key will enable RAID-6 on all four ServeRAID controllers.
See Appendix A, “FoD Component reference” on page 69 for the list (current at the time ofwriting) of ServeRAID FoD upgrades.
Additional considerations for Emulex upgradesThe IMM2 is unable to read the Emulex ASIC identifier, so it marks the keys as installed, butthe keys have to be validated by the Emulex firmware during UEFI system initialization. TheIMM2 status for these keys does not change if they are in use or not in use by the Emulex
options that are installed in the system.
To determine if an Emulex key has activated the upgrade feature, use one of the following
tools:
The command hbacmd getfodinfo will show the FoD status as enabled, as shown in
Figure 3-7.
Figure 3-7 Verifying that the FoD upgrade was successful - HbaCmd
The Emulex OneCommand Manager GUI will indirectly show you the FoD upgrade is
active if you can change the personality of the card to either FCoE or iSCSI. SeeFigure 3-9 on page 35.
In the Preboot DSA output, the State entry is a 1 for an activated ASIC (Figure 3-8).
Figure 3-8 Verifying that the FoD upgrade was successful - Preboot DSA
After the Emulex is upgraded, you must enable the card’s personality to support either FCoEor iSCSI:
1. If you have not done so already, reboot the system to allow UEFI to reinitialize and the
operating system to load.
2. Start Emulex OneCommand Manager1.
C:\Program Files\Emulex\Util\OCManager>hbacmd getfodinfo 5c-f3-fc-36-17-c0 FoD Identifier: FK3W8VCZNTAL73W1X5XDJ126T7R9WKW9FoD Status: enabledFoD Type: 8005 (LOM)
1 Download Emulex OneCommand Manager from http://www.emulex.com/downloads/ibm.html
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 47/92
Chapter 3. Installation35
3. Select the adapter. In the Adapter Information page, look for the Personality section
(Figure 3-9). From here you can change the card to iSCSI or FCoE.
Figure 3-9 Emulex OneCommand Manage card personality selection
3.2 Installing a key using Preboot DSA
Preboot DSA lets you install an FoD activation key in one of two ways:
Preboot DSA can download the activation key directly from the IBM website and install it.
Preboot DSA can install a key you previously downloaded and placed on a USB memorykey or other removable media.
Tips:
If the FCoE and iSCSI radio buttons are greyed out, this means that the FoD key wasnot properly activated or you have not rebooted since activating the key.
The Show License Features and Install License Features buttons shown inFigure 3-9 are not used with IBM Features on Demand and can be ignored.
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 48/92
36 Using IBM Features on Demand
Either process begins by starting Preboot DSA as follows:
1. Power on the system and press the F2 button when the UEFI splash screen appears, as
shown in Figure 3-10.
Figure 3-10 F2 option to enter diagnostics
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 49/92
Chapter 3. Installation37
2. The IBM Memory Test page will appear. Use the arrow keys to select Quit and press
Enter to exit the memory test, as shown in Figure 3-11.
Figure 3-11 System memory test page
3. Wait while a Linux kernel loads and a large volume of text messages scroll past.
4. The user interface selection menu will appear, as shown in Figure 3-12. Type gui and
press Enter to proceed to the DSA graphical user interface.
Figure 3-12 Preboot DSA user interface selection menu
5. Click I accept the terms in the license agreement when prompted to do so.
6. You will see the following message for up to three minutes:
Copying Schema, please wait a moment
Loading Customized Media....
Starting DSA Preboot v9.21 ...Extracting....
Commandsgui - Enter Graphical User Interface (GUI) screen for diagnostic tests and DSA functionalitycmd - Enter Command Line Interface (CLI) for diagnostic tests and DSA functionality.exit - Quit program.
Note: This will eject the CD (if booted from CD) and reboot the system.help - Display this help message.
Please enter a command. (Type ‘help’ for commands)>^\_
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 50/92
38 Using IBM Features on Demand
7. The Preboot DSA Welcome page will open, as shown in Figure 3-13.
Figure 3-13 Preboot DSA Welcome page
8. Select Features on Demand from the left navigation menu. You are promoted to select
which key repository to use, as shown in Figure 3-14. We selected IMM. Click Next.
Figure 3-14 FoD repository selection
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 51/92
Chapter 3. Installation39
9. Select the location of the key file. Preboot DSA provides two main choices here, as shown
in Figure 3-15:
– Supply the FoD key file on a USB memory key or other portable media (for example,optical disc or USB drive). Select Install activation key from removable media inFigure 3-15.
We describe this immediately following in 3.2.1, “Install from USB memory key” onpage 40.
– Have Preboot DSA download the FoD key directly from the Internet and install it. SelectInstall activation key in Figure 3-15.
We describe this in 3.2.2, “Download and install from the Internet” on page 41.
Figure 3-15 Install activation key
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 52/92
40 Using IBM Features on Demand
3.2.1 Install from USB memory key
In this section, we continue the process of using Preboot DSA to install an FoD activation keythat you previously downloaded and placed on a USB memory key. This is useful if you do nothave any network connectivity and have already download the FoD keys you want to apply
onto a USB memory key.
Before you continue, ensure that the FoD keys are located in the following subfolder of the
USB key:
/fodkeys/<FoD UID>/
For example, key file ibm_fod_8003_7160KQ5N05V_anyos_noarch.key should be in folder:
/fodkeys/7160KQ5N05V/
If the keys are not located in this directory, the error shown in Figure 3-16 will display.
Figure 3-16 Files missing from USB memory key
The process to install the FoD keys is as follows (continuing on from step 9 on page 39):
1. If you select Install activation key from removable media, the available removablemedia is detected first. Click Next to proceed. See Figure 3-17.
Figure 3-17 Removable media selection
Tip: The folder names are not case sensitive; however, with older versions of PrebootDSA, the path was case sensitive (for example, “FodKeys”) Also note that the file
extension must be .key (lower case) and not .KEY (upper case).
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 53/92
Chapter 3. Installation41
2. The next page displayed provides a list of the existing files for the available removable
media chosen (Figure 3-18).
Figure 3-18 Existing FoD keys
3. Click to select the items you want to install, then click Next. In our example, we selectedboth. The installation starts and a progress bar is shown. After all the key files are
installed, the result page is displayed, as shown in Figure 3-19.
Figure 3-19 FoD key install results
4. Click Finish.
3.2.2 Download and install from the Internet
In this section we continue the process of using Preboot DSA to download the key from the
IBM FoD website and install all in one procedure. You do not need to download the keysbefore you begin. This option requires that you have a working connection to the Internet.
Proceed as follows (continuing on from step 9 on page 39):
1. Select Install activation key, then click Next, as shown in Figure 3-15 on page 39.
2. Enter your IBM website credentials on the next screen, then click Next.
Reminder: The key files must be in the correct directory of the USB key as describedearlier. Otherwise, you will receive the error shown in Figure 3-16 on page 40. Do not
put the key files in the root directory of the USB key.
Tip: If the Install activation key menu item is greyed out, or missing, this means that the
server does not have an active Ethernet link.
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 54/92
42 Using IBM Features on Demand
3. Click to select the items that you want to install from the list provided, shown in
Figure 3-20, then click Next.
Figure 3-20 Activation key selection
In our example, we selected the IMM Advanced Upgrade.
4. The second page of the Install activation key lists all the features that you have chosen toinstall. Click Input at the end of each row and enter the values required for installation, asshown in Figure 3-21.
Figure 3-21 Input selection panel
5. After clicking Input, the panel shown in Figure 3-22 will display.
Figure 3-22 FoD information input panel
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 55/92
Chapter 3. Installation43
6. Enter the appropriate values in each field, click OK, then click Next. The installation starts
and a progress bar is shown. If any of the required values for feature keys are missing,enter the missing values and click Continue to continue the key installation, or click Skip to bypass the current feature's installation.
7. For some features, the authorization code might be required. In this case, the pop-up
window shown in Figure 3-23 will display.
Figure 3-23 Authorization code input
8. At completion, the installation results of each feature are displayed, similar to Figure 3-19on page 41.
3.3 Installing a key using Portable DSA
We can use IBM Dynamic System Analysis (DSA) to download and install FoD Activation
keys. In this section, we discuss using Portable DSA in an operating system. Portable DSAcan be downloaded from:
http://ibm.com/support/entry/portal/docdisplay?lndocid=SERV-DSA
At the time of writing, only a command line interface (CLI) is available for managing FoD
upgrades using Portable DSA. The commands in this section require that the system beconnected to the Internet.
These commands will download specific FoD activation keys from the IBM FoD website (alsoknown as the Key Management System or KMS) and will install them on the target system
(the local server or a remote server).
Portable DSA functions we cover here are:
3.3.1, “Downloading an FoD key from the Internet (download_fod_key)” on page 43 3.3.2, “Installing a previously downloaded FoD key (install_fod_key)” on page 44
3.3.3, “Downloading and installing an FoD key (install_imm_fod)” on page 47 3.3.4, “Portable DSA command summary” on page 48
3.3.1 Downloading an FoD key from the Internet (download_fod_key)
In this section we describe how to download an authorization key file using Portable DSA inan operating system environment.
Our example uses the following configuration:
32-bit DSA running from CLI in Windows Server 2008 R2 that is connected to the Internet.
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 56/92
44 Using IBM Features on Demand
The DSA file is located at C:\Users\Administrator\Desktop.
The server machine type is 7915 and the serial number is 06CLAE6.
The keys are downloaded to the \IBM_Support\FoDKeys directory.
The downloaded key in this example is ibm_fod_0001_791506CLAE6_anyos_noarch.key,which corresponds to the IMM Advanced Upgrade feature, as shown in Appendix A, “FoD
Component reference” on page 69. The IBM ID is [email protected]. This is the IBM ID used on the FoD website.
The IBM ID password is mypassword.
Use the following command and parameters to download an authorization key file:
dsaexe fod download_fod_key --ibmid userid:password> |--uid <unique_id> | --authcode <code> | --mt < machinetype>
The ibmid and uid parameters are required. Authcode and machinetype parameters are
optional.
Figure 3-24 shows the output of the successful command.
Figure 3-24 Downloading FoD key
Figure 3-25 shows the output you will see if you do not have a connection to the Internet.
Figure 3-25 FoD key download error
3.3.2 Installing a previously downloaded FoD key (install_fod_key)
In this section, we demonstrate how to install a feature activation key using both local andremote Portable DSA installation methods. The key has already been downloaded, as
described in 3.3.1, “Downloading an FoD key from the Internet (download_fod_key)” onpage 43.
Installing a feature activation key via the local operating systemThe following steps demonstrate how to install a feature activation key that has already been
copied to the local server requiring a feature activation.
C:\Users\Administrator\Desktop>ibm_utl_dsa_dsyta1n-9.21_portable_windows_i386.exe fod download_fod_key--ibmid [email protected]:mypassword --uid 791506CLAE6Downloading activation key from IBM website...The downloaded FoD key file is in the folder:C:\IBM_Support\FoDKeys\791506CLAE6Please press ANY key to Continue ...
Downloading activation key from IBM website...
Download the FoD key file failed.Failed message:Fail to get key, fail to perform curl.Couldn't connect to serverPlease press ANY key to Continue ...
Reboot required: A system reboot might be required depending on the feature activation
key installed. Although the activation key will show as installed in the IMM web console orCLI, it will not become effective until the UEFI has been restarted. See Appendix A, “FoD
Component reference” on page 69 to determine if a reboot is required.
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 57/92
Chapter 3. Installation45
Before you begin, ensure that you have downloaded the correct version (32-bit or 64-bit) of
the DSA for the server operating system you are running it on.
In this example, we have the following setup:
The x64 version of DSA installed on Windows Server x64
The directory containing the DSA is located at: C:\DSAutil
The directory containing the FoD key is located at: C:\fodkey
The activation key file name to be installed is:ibm_fod_8009_791506CLAE6_anyos_noarch.key
Use the following command and parameters to install an activation key to the local server:
dsaexe fod install_fod_key --keyfile directory\keyfile --device
In this example:
directory\keyfile is the location of the directory and activation key file name device - is the device where the keys are stored. For the activation keys for System x
servers, the device is IMM.
Figure 3-26 shows the command we used.
Figure 3-26 Example DSA command run locally to install an activation key
Figure 3-27 shows the output if the command is successful.
Figure 3-27 A successful installation of an activation key run locally
Restart the system if required to fully activate the feature.
Installing a feature activation key to a remote systemIn this section, we show how to install a feature activation key that has already beendownloaded to your local workstation for deployment to a remote server. For the purposes ofthis demonstration, we will deploy the ServeRAID M5100 Series SSD Caching Enabler for
IBM System x activation key. This activation key will be deployed to an IMM2 that is
connected directly to a LAN. Portable DSA can connect to the IMM remotely when the serveris connected to power or is using standby power.
C:\dsa>ibm_utl_dsa_dsyta1n-9.21_portable_windows_i386.exe fod install_fod_key --keyfileC:\fodkey\ibm_fod_8009_791506CLAE6_anyos_noarch.key --user USERID --password iloveitso
IBM Dynamic System Analysis Version 9.21.A1N(C) Copyright IBM Corp. 2004-2012. All Rights Reserved
Installing activation key to key repository(IMM)...Install FoD Key to IMM successfully.Please press ANY key to Continue
Reboot: A system reboot might be required depending on the feature activation keyinstalled. Although the activation key will show as installed in the IMM web console or CLI,
it will not become active until the UEFI has been restarted. See Appendix A, “FoDComponent reference” on page 69 to determine if a reboot is required.
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 58/92
46 Using IBM Features on Demand
Before you begin, ensure that you have downloaded the correct version (32-bit or 64-bit) of
the Portable DSA for the workstation you are running it on.
In this example, we have the following setup:
A Portable DSA 32-bit version installed on a 32-bit Windows based workstation.
The directory containing the Portable DSA is located at: C:\dsa
The directory containing the FoD key is located at: C:\fodkey
The activation key file name to be installed is:ibm_fod_8009_791506CLAE6_anyos_noarch.key
The IMM ip address is: 9.42.171.49
The IMM user name is: USERID
The IMM password is: iloveitso
Use the following command and parameters to install an activation key to a remote server:
dsaexe fod install_fod_key --keyfile directory\keyfile --device devicetype --hostusername:password @ipaddress
In this example:
dsaexe is the name of the dsa utility which changes every version. For example:
ibm_utl_dsa_dsyta1n-9.21_portable_windows_i386.exe directory\keyfile is the location of the directory and file name of the activation key file devicetype is the type of device you are deploying the activation key to which is: IMM username is an IMM2 administrative account on the remote server password is the password of the chosen IMM2 administrative account ipaddress is the IP address of the IMM2 of the remote server
Figure 3-28 shows the command we used.
Figure 3-28 Example Portable DSA command to remotely install an activation key
If you are running the DSA command on a PC or notebook, you might be prompted as shownin Figure 3-29. Because we are performing a remote operation rather than a local one, we
can safely ignore the message and just type Y and press Enter to continue.
Figure 3-29 DSA update prompt
C:\dsa>ibm_utl_dsa_dsyta1n-9.21_portable_windows_i386.exe fod install_fod_key --keyfileC:\fodkey\ibm_fod_8009_791506CLAE6_anyos_noarch.key --device IMM --host USERID:[email protected]
You might need to download an update for DSA to support this system.Use the -? or -h parameter for more information about downloading updates.Do you want to proceed anyway (function may be limited)? (Y/N)
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 59/92
Chapter 3. Installation47
Figure 3-30 shows the output if the command is successful.
Figure 3-30 A successful installation of an activation key run remotely
Restart the system if required to fully activate the feature.
3.3.3 Downloading and installing an FoD key (install_imm_fod)
As an alternative to using two separate DSA commands to first download and then install theactivation keys, you can use one command to do both. In this section we describe how to use
the IMM and Portable DSA to download and install an FoD authorization key.
Our example uses the following:
32-bit DSA running from a CLI in Windows Server 2008 R2 that is connected to theInternet
The DSA file is located at C:\Users\Administrator\Desktop
The server machine type and serial number are 7915 and 06CLAE6
The IBM ID is [email protected]. This is the IBM ID used on the FoD website
The IBM ID password is mypassword
The IMM ip address is: 9.42.171.49
The IMM user name is: USERID
The IMM password is: iloveitso
Use the following command and parameters to download and install every available FoD
activation key linked to a specified UID:
dsaexe fod install_imm_fod --ibmid <userid:password >, --uid <unique_id >,--authcode <code>, --mt < machinetype>, --host <userid:password@hostip:[port]>
If host is not specified, the repository will default to the IMM on the local system. Authcode
and machinetype parameters are optional.
In this example:
<userid:password> is IBM ID website credentials. <unique_id> is the FoD feature unique identifier information.
<code> is the authentication code for FoD features.
<machinetype> is the target system machine type (IMM).
<[http(s)://userid:password@hostip:[port]> is the remote key repository (IMM),default value being the local IMM device. Default IMM port is 5989.
Logging level set to StatusCopying Schema...Dynamic System Analysis Version 9.21.A1N(C) Copyright IBM Corp. 2004-2012. All Rights Reserved.
Installing activation key to key repository(IMM)...Install FoD Key to IMM successfully.Please press ANY key to Continue ...
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 60/92
48 Using IBM Features on Demand
The command we used and the output showing success are shown in Figure 3-31.
Figure 3-31 Downloading and installing an FoD key to a remote IMM
Figure 3-32 shows the output if there is not a valid internet connection.
Figure 3-32 No Internet connection error
3.3.4 Portable DSA command summary
Portable DSA is also capable of running reporting and exporting commands. Table 3-1 lists all
Portable DSA commands related to FoD. You will note that keys are grouped by the keyrepository, that is, the component that is used to store the activation keys after they areinstalled. The key repository is either IMM, CMM, or switch.
The syntax is:
dsaexe fod command
Table 3-1 DSA commands
C:\Users\Administrator\Desktop>dsa.exe fod install_imm_fod --ibmid [email protected]:mypassword --uid791506CLAE6 --host USERID:[email protected]
Installing activation key to key repository(IMM) ..
Install FoD Key to IMM successfully.Please press ANY key to Continue ...
Installing activation key to key repository(IMM) ..
Fail to install the FoD key to IMM.Failed message:Fail to get key, fail to perform curl.Couldn't connect to serverPlease press ANY key to Continue ...
DSA FOD command Description
help Displays a list of available commands.
export_imm_uid Export FoD inventory information to removable media using unique
identifier (UID). The file that is generated is exported to
dsa_fod_id.txt in the DSA output folder.
display_available_fod Display the available FoD keys for a key repository.
download_fod_key Acquire and download activation key from IBM website.
install_fod_key Install activation keys from user specified location to key repository.
export_imm_uid Export the local FoD unique IDs to a file saved in DSA output path.
report_imm_active_fod Report inventory information of IMM repository.
install_imm_fod Download and install activation keys to IMM repository.
uninstall_imm_fod Uninstall activation keys from IMM repository.
report_cmm_active_fod Report inventory information of CMM repository.
install_cmm_fod Download and install activation keys to CMM repository.
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 61/92
Chapter 3. Installation49
For example, the report_imm_active_fod command displays the output shown in Figure 3-33.
Figure 3-33 Active FoD keys
3.4 IBM Systems Director Feature Activation Manager
IBM Systems Director can be used to perform centralized FoD-related tasks. You can use theFeature Activation Manager configuration settings within IBM Systems Director to manage
FoD activation keys for the following hardware:
Integrated Management Module II (IMM2) Chassis Management Module (CMM) Switches that support FoD
The Feature Activation Manager configuration settings enable you to perform the followingtasks:
Obtain activation keys by using the IBM FoD website (key management system, KMS)
Upload activation keys from a local directory
Choose whether you want to reboot a device automatically after an activation key isinstalled to complete the activation
Install activation keys on the target device
Retrieve activation keys from the target device and show the detailed license information
Remove and deactivate existing keys from the target device
You can also create a Feature Activation Manager template through the IBM SystemsDirector configuration manager and use the template for the entire configuration across a
group of like devices.
uninstall_cmm_fod Uninstall activation keys from CMM repository.
report_switch_active_fod Report inventory information of Switch repository.
install_switch_fod Download and install activation keys to Switch repository.
uninstall_switch_fod Uninstall activation keys from Switch repository.
DSA FOD command Description
c:\dsaexe fod report_imm_active_fodReporting inventory information from key repository(IMM)...
Current active FoD feature(s):------------------------------------------------------------------------------------------
Number of keys installed is 2
No Key ID status Description1 ea6f0962f921c0b9 valid IBM Integrated Management Module Advanced Upgrade2 3c08174de28098bb valid ServeRAID M5100 Series RAID 6 Upgrade for IBM System x------------------------------------------------------------------------------------------
Please press ANY key to Continue ...
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 62/92
50 Using IBM Features on Demand
The usage of Feature Activation Manager within IBM Systems Director has been well
documented in the IBM Features on Demand User's Guide and has therefore not beencovered in this paper. The IBM Features on Demand User's Guide can be found at thefollowing URL:
http://ibm.com/support/entry/portal/docdisplay?lndocid=MIGR-5089568
3.5 Installing a key using ASU
The Advanced Settings Utility (ASU) is a command line utility used to modify firmware
settings and manage Features on Demand activation keys. It is supported on Windows andLinux and enables you to manage feature activation keys, both locally or remotely, for the
following:
IMM2-based systems Chassis Management Module (CMM), part of IBM Flex System I/O modules
The IBM Advanced Settings Utility can be downloaded at the following URL:
http://ibm.com/support/entry/portal/docdisplay?lndocid=TOOL-ASU
For the purposes of this paper we focus on feature activation key management onIMM2-based server systems. It is assumed that the reader is already familiar with the usage
of the ASU command. For information about the tool, see IBM Advanced Settings Utility UserGuide, available at:
http://ibm.com/support/entry/portal/docdisplay?lndocid=MIGR-5085890
In this section, we demonstrate how to install a feature activation key using both local andremote installation methods. The ASU fodcfg is the main command used to manage FoDactivation keys. It supports the following FoD activation key tasks:
Acquisition Installation Uninstallation Reporting Exporting
The high level commands used to achieve these tasks are summarized in Table 3-2.
Table 3-2 fodcfg commands
Tip: Whenever possible, have Features on Demand features installed by IBMmanufacturing at the time of product order.
Command Description
acquirekey Acquire and download the activation key from the IBM web site.
installkey Install activation keys from the user-specified location to the key
repository.
unistallkey Uninstall activation keys from the device.
reportkey Inventory information of a specified key repository (for example, IMM)
exportkey Inventory information about a specified key repository. We describe the use of this
command in 4.1, “Backing up feature activation keys using ASU” on page 58.
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 63/92
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 64/92
52 Using IBM Features on Demand
The command completes successfully if you see the message Succeeded installing key, as
shown in the last line of Figure 3-35.
Figure 3-35 A successful installation of an activation key run locally
Restart the system if required to fully activate the feature.
3.5.2 Installing an activation key remotely
In this section, we show how to install an activation key that has already been downloaded toyour local workstation for deployment to a remote server.
For the purposes of this demonstration, we will deploy the ServeRAID M5100 Series SSDCaching Enabler for IBM System x activation key. This activation key will be deployed to an
IMM2 that is connected directly to a LAN. The ASU can connect to the IMM remotely whenthe server is connected to power or is using standby power. Both IPv4 and IPv6 aresupported remotely by ASU.
Before you begin, ensure that you have downloaded the correct version (32-bit or 64-bit) of
the ASU for the workstation you are running it on.
In this example, we have the following setup:
An ASU 32-bit version installed on a 32-bit Windows based workstation
The directory containing the ASU is located at: C:\ASUtil
The directory containing the FoD key is located at: C:\fodkey
The activation key file name to be installed is:ibm_fod_8009_791506CLAE6_anyos_noarch.key
The IMM ip address is: 9.42.171.49
The IMM user name is: USERID
The IMM password is: iloveitso
Use the following command and parameters to install an activation key remotely using ASU:
asu.exe fodcfg installkey -f <directory\keyfile> --host <ipaddress> --user<username> --password < password>
In the sample syntax we would substitute:
<directory\keyfile> with the location of the directory and activation key file name
IBM Advanced Settings Utility version 9.21.78CLicensed Materials - Property of IBM(C) Copyright IBM Corp. 2007-2012 All Rights Reserved
No host specified, attempting to discover the IMM(s) via SLP.Successfully discovered the IMM via SLP.Pegasus Exception: Cannot connect to 169.254.95.118:5989. Connection failed.Executing the command through CIM interface failed, trying IPMI interface.Connected to IMM at IP address 169.254.95.118Succeeded installing key C:\fodkey\ibm_fod_8009_791506CLAE6_anyos_noarch.key.
IMPORTANT: A system reboot might be required depending on the feature activation keyinstalled. Although the activation key will show as installed in the IMM web console or CLI,
it will not become effective until the UEFI has been restarted.
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 65/92
Chapter 3. Installation53
<ipaddress> with the IP address of the IMM2 on the remote server
<username> with an IMM2 administrative account
<password> with the password of the chosen IMM2 administrative account
For our example, the command would be as listed in Figure 3-36.
Figure 3-36 Example ASU command to remotely install an activation key
The command completes successfully if you see the message Succeeded installing key, asshown in the last line of Figure 3-37.
Figure 3-37 A successful installation of an activation key run remotely
Restart the system to fully activate the feature.
3.5.3 Downloading and installing an activation key to a local system
In this section, we show how to download an FoD key from the IBM FoD website and theninstall that key to the local server.
In our example, we will deploy the IMM Advanced Upgrade for IBM System x activation key.
Before you begin, ensure that you have downloaded the correct version (32-bit or 64-bit) ofthe ASU for the server operating system you are running it on. LAN over USB should not bedisabled on the IMM as ASU uses this feature to communicate with it to apply the activation
key.
In this example, we have the following setup:
An ASU 64-bit version installed on a 64-bit Windows server based operating system
The directory containing the ASU is located at: C:\ASUtil
The directory to receive FoD key is located at: C:\fodkey
Tip: You do not need to specify a user name and password in the command if the IMM2 is
using default credentials. The ASU attempts to use the default IMM2 authenticationcredentials (USERID/PASSW0RD) when none have been specified in the command.
C:\ASUtil>asu.exe fodcfg installkey -f C:\fodkey\ibm_fod_8009_791506CLAE6_anyos_noarch.key --host9.42.171.39 --user USERID --password iloveitso
IBM Advanced Settings Utility version 9.21.78CLicensed Materials - Property of IBM(C) Copyright IBM Corp. 2007-2012 All Rights ReservedPegasus Exception: Cannot connect to 9.42.171.39:5989. Connection failed.Executing the command through CIM interface failed, trying IPMI interface.Connected to IMM at IP address 9.42.171.39Succeeded installing key C:\fodkey\ibm_fod_8009_791506CLAE6_anyos_noarch.key.
Reboot: A system reboot might be required depending on the feature activation key
installed. Although the activation key will show as installed in the IMM web console or CLI,it will not become effective until the UEFI has been restarted.
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 66/92
54 Using IBM Features on Demand
The IMM user name is: USERID The IMM password is: iloveitso
Use the following command and parameters to download and install an activation key locallyusing ASU:
asu64.exe fodcfg acquirekey -r -d <directory> --ibmid <userid:password > -m< machinetype> -u < machinetypeserialnumber>
In the sample syntax we would substitute:
<directory> with the location of the directory that will receive the feature key
<userid:password> with the IBM FoD ID website credentials
<machinetype> with the machine type of the system <machinetypeserialnumber> with the machine type and serial number of the system with
no spaces or dashes
For our example, the command would be as listed in Figure 3-38.
Figure 3-38 Sample command for downloading and installing a feature key locally
The command completes successfully if you see the message Succeeded installing key, as
shown in the last line of Figure 3-37 on page 53.
Figure 3-39 Successful download and installation of a feature activation key to a local system
Restart the system to fully activate the feature.
Download Directory: If no directory is specified, the feature key will be downloadedinto the directory from which the ASU is run. The feature key downloaded will be placed
into a directory containing the naming convention of machine type and serial number(with no spaces or dashes).
C:\ASUtil>asu64.exe fodcfg acquirekey -r -d C:\fodkey --ibmid [email protected]:xxxxxxxx-m 7915 -u 791506CLAE6
IBM Advanced Settings Utility version 9.21.78CLicensed Materials - Property of IBM(C) Copyright IBM Corp. 2007-2012 All Rights ReservedSucceed to get key for userid:[email protected] uid:791506CLAE6.No host specified, attempting to discover the IMM(s) via SLP.Successfully discovered the IMM via SLP.Pegasus Exception: Cannot connect to 169.254.95.118:5989. Connection failed.Executing the command through CIM interface failed, trying IPMI interface.Failed to connect to IMM at IP address 169.254.95.118Connecting via IPMI device driver (KCS interface)....Success connecting to IMM via KCS interface
Succeeded installing keyC:\fodkey\791506CLAE6\ibm_fod_0001_791506CLAE6_anyos_noarch.KEY.
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 67/92
Chapter 3. Installation55
3.5.4 Downloading and installing an activation key to a remote system
In this section, we show how to download and install a feature activation key to a remoteserver via a workstation with internet access. For the purposes of this demonstration, we willdeploy the IMM Advanced Upgrade for IBM System x activation key.
Before you begin, ensure that you have downloaded the correct version (32-bit or 64-bit) of
the ASU for the workstation you are running it on. This activation key will be deployed to anIMM2 that is connected directly to a LAN. The ASU can connect to the IMM remotely when
the server is connected to power or is using standby power. Both IPv4 and IPv6 aresupported remotely by ASU.
In this example, we have the following setup:
An ASU 32-bit version installed on a 32-bit Windows-based workstation that has internet
access
The directory containing the ASU is located at: C:\ASUtil
The directory to receive FoD key is located at: C:\fodkey
The IMM ip address is: 9.42.171.49
The IMM user name is: USERID
The IMM password is: iloveitso
Use the following command and parameters to download and install an activation keyremotely using ASU:
asu64.exe fodcfg acquirekey -r -d <directory> --ibmid <userid:password > -m< machinetype> -u < machinetypeserialnumber> --host <ipaddress> --user <username>--password <password>
In the sample syntax we would substitute:
<directory> with the location of the directory that will receive the feature key
<userid:password> with the IBM FoD ID website credentials.
<machinetype> with the machine type of the system
<machinetypeserialnumber> with the machine type and serial number of the system with
no spaces or dashes
<ipaddress> with the IP address of the IMM2 on the remote server
<username> with an IMM2 administrative account
<password> with the password of the chosen IMM2 administrative account
Reboot: A system reboot might be required depending on the feature activation keyinstalled. Although the activation key will show as installed in the IMM web console or CLI,
it will not become effective until the UEFI has been restarted.
Download directory: If no directory is specified, the feature key will be downloaded
into the directory from which the ASU is run. The feature key downloaded will be placedinto a directory containing the naming convention of Machine Type and Serial Number(with no spaces or dashes).
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 68/92
56 Using IBM Features on Demand
For our example, the command would be as listed in Figure 3-40.
Figure 3-40 Sample command for downloading and installing a feature key remotely
The command completes successfully if you see the message Succeeded installing key, asshown in the last line of Figure 3-41.
Figure 3-41 Successful download and installation of a feature activation key to a local system
Restart the system to fully activate the feature.
C:\ASUtil>asu.exe fodcfg acquirekey -r -d C:\fodkey --ibmid [email protected]:xxxxxxxx -m7915 -u 791506CLAE6 --host 9.42.171.39 --user USERID --password iloveitso
IBM Advanced Settings Utility version 9.21.78CLicensed Materials - Property of IBM(C) Copyright IBM Corp. 2007-2012 All Rights ReservedSucceed to get key for userid:[email protected] uid:791506CLAE6.Pegasus Exception: Cannot connect to 9.42.171.39:5989. Connection failed.Executing the command through CIM interface failed, trying IPMI interface.Connected to IMM at IP address 9.42.171.39Succeeded installing keyC:\fodkey\791506CLAE6\ibm_fod_0001_791506CLAE6_anyos_noarch.KEY.
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 69/92
© Copyright IBM Corp. 2012. All rights reserved.57
Chapter 4. Backing up activation keys
In this chapter, we discuss methods you can use to either save activation keys or save the
UID information about each FoD feature. We document the use of two tools, AdvancedSettings Utility (ASU) and IBM Dynamic System Analysis (DSA).
Sections included in this chapter are:
4.1, “Backing up feature activation keys using ASU” on page 58 4.2, “Backing up FoD UIDs using Preboot DSA” on page 60 4.3, “Backing up FoD UIDs using Portable DSA” on page 64
ASU exports the activation keys so you can later reinstall them if necessary.
DSA (both preboot and portable) exports only the UIDs, which makes it easier to laterdownload and reinstall them if necessary.
4
Note: You cannot back up the activation keys using IMM2. The IBM Features on Demand
activation keys do not form part of the IMM2 backup; therefore, it is not possible to backthem up using the IMM2 hardware.
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 70/92
58 Using IBM Features on Demand
4.1 Backing up feature activation keys using ASU
The IBM Advanced Settings Utility (ASU) can be used to export feature activation keys fromthe IMM2 for backup purposes. The activation keys can be exported to the following
locations:
The local operating system that runs on the IMM2-based server. The system must havethe ASU installed locally.
A remote system with ASU installed locally.
It is assumed that you are already familiar with the usage of the ASU. Further details are inthe IBM Advanced Settings Utility User’s Guide available from the following location:
http://ibm.com/support/entry/portal/docdisplay?lndocid=MIGR-5085890
The IBM Advanced Settings Utility can be downloaded at the following URL:
http://ibm.com/support/entry/portal/docdisplay?lndocid=TOOL-ASU
4.1.1 Exporting all activation keys from the local IMM key repositoryBefore you begin, verify that you have downloaded the correct version (32-bit or 64-bit) of the
ASU for the server operating system you are running it on. LAN over USB should not bedisabled on the IMM because ASU uses this feature to communicate with it to apply to export
the activation key.
In the following example, we have this setup:
An ASU 64-bit version installed on a 64-bit Windows server based operating system The local directory containing the ASU is located at: C:\ASUtil The local directory to export the FoD keys is located at: C:\fodkey The IMM user name is: USERID The IMM password is: iloveitso
Use the following ASU command and parameters to export all activation keys from the local
IMM key repository and then save them locally:
asu64.exe fodcfg exportkey -d directory --keyid all --user username --password password
In the sample syntax we would substitute:
directory - with the location of the directory where the FoD keys will be exported to username - with an IMM2 administrative account password - with the password of the chosen IMM2 administrative account
Tip: You do not need to specify a user name and password in the command if the IMM2 is
using default credentials (USERID/PASSW0RD). The ASU attempts to use the default IMM2authentication credentials when none have been specified in the command. Also note that
if an export directory is not specified, the ASU will export the keys to the directory that it isrun from.
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 71/92
Chapter 4. Backing up activation keys59
For our example, the command would be as listed in Figure 4-1.
Figure 4-1 The command to export of all activation keys from the local IMM
The command completes successfully if you receive a Succeeded exporting key message
followed by an activation key name. As shown in Figure 4-2, two activation keys have beenexported successfully to the directory specified in the command.
Figure 4-2 Successful export
4.1.2 Exporting all activation keys from a remote IMM key repository
Before you begin, verify that you have downloaded the correct version (32-bit or 64-bit) of theASU for the workstation you are running it on.
In the following example, we have this setup:
An ASU 32-bit version installed on a 32-bit Windows based workstation
The local directory containing the ASU is located at: C:\ASUtil The local directory to export the FoD keys is located at: C:\fodkey The IMM user name is: USERID The IMM password is: iloveitso
Use the following ASU command and parameters to export all activation keys from the localIMM key repository and then save them locally:
asu.exe fodcfg exportkey -d <directory> --keyid all --host <ipaddress> --user<username> --password < password>
In the sample syntax we would substitute:
<directory> with the location of the local directory where the FoD keys will be exported to
<ipaddress> with the IP address of the IMM2 on the remote server <username> with an IMM2 administrative account <password> with the password of the chosen IMM2 administrative account
C:\ASUtil>asu64.exe fodcfg exportkey -d c:\fodkey --keyid all --user USERID--password iloveitso
IBM Advanced Settings Utility version 9.21.78CLicensed Materials - Property of IBM(C) Copyright IBM Corp. 2007-2012 All Rights ReservedNo host specified, attempting to discover the IMM(s) via SLP.Successfully discovered the IMM via SLP.Pegasus Exception: Cannot connect to 169.254.95.118:5989. Connection failed.Executing the command through CIM interface failed, trying IPMI interface.Connected to IMM at IP address 169.254.95.118
Succeeded exporting key ea6f0962f921c0b9.Succeeded exporting key 3c08174de28098bb.
Tip: You do not need to specify a user name and password in the command if the IMM2 isusing default credentials. The ASU attempts to use the default IMM2 authentication
credentials when none have been specified in the command. Also note that if an exportdirectory is not specified, the ASU will export the keys to the directory that it is run from.
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 72/92
60 Using IBM Features on Demand
For our example, the command would be as listed in Figure 4-3.
Figure 4-3 Example command to export all keys from a remote IMM key repository
The command completes successfully if you receive a Succeeded exporting key messagefollowed by an activation key name. As shown in Figure 4-4, two activation keys have been
exported successfully to the remote workstation in the directory specified in the command.
Figure 4-4 Sample output
Store these key files in a safe location. If you replace the system board of the server, you canuse the ASU command to reapply them.
4.2 Backing up FoD UIDs using Preboot DSA
In this section, we describe how to back up FoD unique IDs (UIDs) to a removable mediasuch as a USB memory key using the Preboot DSA graphical interface. The Preboot DSA
command line tool (CLI) is also available in DSA as a restore method.
To back up the UIDs already installed in a server, do the following:
1. Boot the server to Preboot DSA and select the Features on Demand (FoD) menu, as
shown in Figure 4-5 on page 61.
C:\ASUtil>asu.exe fodcfg exportkey -d C:\fodkey --keyid all --host 9.42.171.39 --userUSERID --password iloveitso
IBM Advanced Settings Utility version 9.21.78CLicensed Materials - Property of IBM(C) Copyright IBM Corp. 2007-2012 All Rights ReservedPegasus Exception: Cannot connect to 9.42.171.39:5989. Connection failed.Executing the command through CIM interface failed, trying IPMI interface.Connected to IMM at IP address 9.42.171.39Succeeded exporting key ea6f0962f921c0b9.Succeeded exporting key 3c08174de28098bb.
Tip: The activation keys that are exported are given file names associated with a key IDused in ASU. You can use asu fodcfg reportkey command to see the key ID information.
Note: Unlike ASU, Preboot DSA does not back up activation keys. Preboot DSA can only
back up FoD UIDs.
Tip: We describe the steps to boot the server and get to Preboot DSA in 3.2, “Installing
a key using Preboot DSA” on page 35.
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 73/92
Chapter 4. Backing up activation keys61
Figure 4-5 Preboot DSA Welcome page
2. Specify a target device. As shown in Figure 4-6, select the IMM key repository, then clickNext.
Figure 4-6 Target device selection for key management
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 74/92
62 Using IBM Features on Demand
3. Select Export FoD feature information to removable media (Figure 4-7).
Figure 4-7 Export to removable media
Tip: There are two other options available, CMM and IOM/Switch. For purposes of thispaper, we only discuss the IMM.
Tip: In our lab experiments, exporting information to removable media required anactive Ethernet connection even though it was not used. This might be fixed in updatesto system diagnostics firmware.
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 75/92
Chapter 4. Backing up activation keys63
4. Click Next after selecting available removable media, as shown in Figure 4-8.
Figure 4-8 Removable media selection
5. The next panel shows available key information to export, as shown in Figure 4-9. Keys
identified as valid can be exported. Keys labeled as N/A are installed, but the IMM isunable to determine the current status of them (for example, whether or not the hardwareusing the keys is present and using the keys).
Figure 4-9 FoD key information available for export
6. After the files have been exported, the FoD information will be stored in the dsa_fod_id.txt
file in the root directory of the removable media.
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 76/92
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 77/92
© Copyright IBM Corp. 2012. All rights reserved.65
Chapter 5. Servicing
In this chapter, we provide information about servicing systems with IBM Features on
Demand (FoD) capabilities. We discuss servicing optional hardware components such asexpansion cards that offer FoD functionality.
The following topics are covered:
5.1, “Replacing a system board” on page 66 5.2, “Replacing an adapter” on page 67 5.3, “Moving an adapter” on page 67
5
Customer responsibilities: All reactivation procedures for feature activation are a
customer responsibility.
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 78/92
66 Using IBM Features on Demand
5.1 Replacing a system board
The FoD activation keys for servers are stored on the system board’s IntegratedManagement Module II (IMM2). This is called the FoD key repository. Activation keys are not
easily lost, except if the system board is replaced.
If the system board is replaced, you will need to reinstall all FoD keys. It is important to firstmake sure that the machine type and serial number (MTSN) of the server is applied to the
new system board. The System Firmware update tool or ASU will give you this capability.Most of the FoD activation keys are tied to MTSN, so failure to reinstate these values will
prevent the FoD upgrades from being reapplied.
Use the following information as guidance on how to re-enable FoD upgrades:
For server-level keys such as ServeRAID, Intel Ethernet, and IMM keys, but excludingEmulex FoD keys, follow these steps:
a. Use the IBM FoD web site and the Retrieve History function to download all keysassociated with the server. See 2.3.3, “Retrieve history” on page 16. You will need tospecify the server UID, which is a concatenation of the machine type and serial number
(for example, 7160KQ5N05V).
b. Reapply the keys to the server using the IMM2 web interface or tools such as DSA or
ASU. See Chapter 3, “Installation” on page 29.
For Emulex adapters (that is, for Emulex controllers that are not integrated on the systemboard), follow these steps:
a. After you reinstall the adapter onto the replacement system board, use the Emulextools (for example, Emulex OneCommand Manager or HbaCmd) to determine the UID(or both UIDs in the case of the IBM Flex System CN4054 adapter) of the Emulex
adapter.
b. Use the Retrieve History function on the IBM FoD website to download the key
associated with the Emulex UID. See 2.3.3, “Retrieve history” on page 16.
c. Reapply the key to the server using the IMM2 web interface or tools such as DSA orASU. See Chapter 3, “Installation” on page 29.
For Emulex controllers integrated on the system board, when you replace the system
board, you will get a new UID for the Emulex controller, meaning that your existing FoD
activation key will no longer be valid.
Further information about this situation is in RETAIN® tip H205574:
http://ibm.com/support/entry/portal/docdisplay?lndocid=MIGR-5090088
Suggested steps to follow are:
a. Use the Emulex tools (for example, Emulex OneCommand Manager or HbaCmd) todetermine the UID of the Emulex controller on the replacement system board.
b. Call IBM support and open a request to get your Emulex FoD entitlement transferred to
the UID of the new Emulex controller. You will also need the machine type and serialnumber of the server.
For Features on Demand support, go to http://ibm.com/systems/x/fod/ and clickContacts in the left navigation pane. Alternatively, send an English-only email request
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 79/92
Chapter 5. Servicing67
c. When you have the new entitlement transferred, use the Retrieve History function ofthe IBM FoD website to download the key for that UID. See 2.3.3, “Retrieve history” onpage 16.
d. Reapply the key to the server using the IMM2 web interface or tools such as DSA or
ASU. See Chapter 3, “Installation” on page 29.
5.2 Replacing an adapterIn all cases, with the exception of Emulex adapters, the re-enabling of FoD functions when anadapter is replaced is automatic:
1. Install the replacement adapter.
2. Power on the server; system firmware will interrogate the IMM key repository and
auto-activate all FoD keys, including those related to the replacement adapter.
In the case of Emulex adapters, when you replace the adapter you will get a new UID, which
means that your existing FoD activation key will no longer be valid. Suggested steps to followare:
1. Use the Emulex tools (for example, Emulex OneCommand Manager or HbaCmd) to
determine the UID of the new Emulex adapter. Remember that adapters such as the IBMFlex System CN4054 have two ASICs and therefore two UIDs.
2. Call IBM support and open a request to get your Emulex FoD entitlement transferred tothe UID of the new Emulex adapter. You will also need the machine type and serialnumber of the server.
For Features on Demand support, go to http://ibm.com/systems/x/fod/ and clickContacts in the left navigation pane. Alternatively, send an English-only email request [email protected].
5.3 Moving an adapter
If you move an adapter with FoD features enabled to a new server, those FoD features will
not transfer over. You will need to contact IBM support and open a request to get the FoDentitlements transferred to the new server’s UID (machine type and serial number
concatenated together).
Tip: The support process will be quicker if you already have the UID of the Emulexcontroller on the failed system board. You would have this if you previously ran a
DSA export command as described in Chapter 4, “Backing up activation keys” onpage 57.
New procedure in 4Q/2012: Starting in October 2012, the FoD website will begin offering
a new entitlement transfer function to make transferring FoD licenses (including Emulexones) easier.
Tip: The support process will be quicker if you already have the UID of the failedEmulex adapter. You would have this if you previously ran a DSA export command as
described in Chapter 4, “Backing up activation keys” on page 57.
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 80/92
68 Using IBM Features on Demand
If you are using a ServeRAID controller with boot drives and you are using FoD features on
that controller, this fact that FoD features are not re-enabled might prevent you from bootingthe server.
For example, if you have a ServeRAID M5110 adapter and have enabled RAID-6 via an FoD
upgrade, and then move that adapter and drives to a new server, the drives will not boot.Instead, you will see the message shown in Figure 5-1.
Figure 5-1 Error message during boot if a required ServeRAID key is not installed
In this case, contact IBM support and get a new authorization code or activation key to enable
RAID 6 on the adapter in the new server.
The native configuration is no longer supported by the current controllersettings. Please ensure that correct controller, ibutton or key-vault is beingused. If you contine the configuration will be marked as foreign and part of itmay be imported if possible.
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 81/92
© Copyright IBM Corp. 2012. All rights reserved.69
Appendix A. FoD Component reference
Table A-1 on page 70 lists all IBM Features on Demand upgrades that were available at the
time of writing.
We also show important information needed when working with these upgrades:
What components support the upgrade (current at the time of writing)
The FoD type number which is displayed by the various management tools. Also referredto as the descriptor type.
Information on how to find the Unique Identifier (UID) that you will need during the process
of activating a feature. The UID is necessary in the case of a part replacement in that youwill need to enter the UID in to the FoD website in order to retrieve the FoD activation key.
Whether a reboot of the server or component is require to activate the feature after youinstall it.
A
Tip: The UID information is especially useful, since you may need to know the UID if you
need to replace a part.
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 82/92
70 Using IBM Features on Demand
Table A-1 FoD type numbers and Unique identifiers (UIDs)
FoD upgrade Supported by FoD type
number
UID to obtain an
authorization code
Reboot
required
Server-based features
IBM IMM2 Standard
Upgrade, 90Y3900
IBM System x3100 M4
IBM System x3250 M4
0004 Machine type and serial
number concatenated (nospaces or dashes). For
example: 7160KQ5N05V
No
IBM IMM2 Advanced
Upgrade, 90Y3901
IBM System x3100 M4
IBM System x3250 M4
IBM System x3300 M4
IBM System x3500 M4
IBM System x3530 M4
IBM System x3550 M4
IBM System x3630 M4
IBM System x3650 M4
IBM iDataPlex® dx360 M4
0001 Machine type and serial
number concatenated (no
spaces or dashes). For
example: 7160KQ5N05V
No
NIC-based features
Intel I-350 Embedded
Dual Port GbE
Activation for IBM
System x (FoD)
(Powerville 2-4 Port
Upgrade), 90Y9314
IBM System x3300 M4
IBM System x3530 M4
IBM System x3630 M4
8003 Machine type and serial
number concatenated (no
spaces or dashes). For
example: 7160KQ5N05V
Yes
Emulex VFA III
FCoE/iSCSI License for
IBM System x, 95Y3760
Emulex Dual Port 10GbE
SFP+ VFA III for IBM
System x, 95Y3762
Emulex Dual Port 10GbE
SFP+ Integrated VFA III for
IBM System x, A2UN
800b Emulex ASIC 32 digit
FoD identifier
Yes
Virtual Fabric Advanced
FoD Upgrade for IBM
BladeCenter, 90Y9350
Emulex 10GbE VFA II for IBM
BladeCenter HS23, 81Y3120
8001 Emulex ASIC 32 digit
FoD identifier
Yes
IBM Flex System
CN4054 Virtual Fabric
Adapter Upgrade,
90Y3558
IBM Flex System CN4054
Virtual Fabric Adapter,
90Y3554
8004 Emulex ASIC 32 digit
FoD identifier
Yes
IBM Virtual Fabric
Advanced Software
Upgrade (LOM),
90Y9310
IBM BladeCenter HS23
IBM Flex System x240
IBM Flex System x440
8005Emulex ASIC 32 digit
FoD identifier
Yes
Emulex Embedded VFAIII FCoE/iSCSI License
for IBM System x,
90Y5178
Emulex Dual Port 10GbESFP+ Embedded Adapter for
IBM System x, 90Y6456
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 83/92
Appendix A. FoD Component reference71
RAID-based features
ServeRAID M5100
Series SSD
Performance Key forIBM System x, 90Y4273
IBM System x3500 M4
IBM System x3530 M4
IBM System x3550 M4 IBM System x3630 M4
IBM System x3650 M4
IBM System x3750 M4
IBM iDataPlex dx360 M4
ServeRAID M5110 SAS/SATA
Controller for IBM System x,
81Y4481
8006 Machine type and serial
number concatenated (no
spaces or dashes). Forexample: 7160KQ5N05V
Yes
ServeRAID M5100
Series Performance
Upgrade for IBM Flex
System, 90Y4412
IBM Flex System x240
IBM Flex System x220
IBM Flex System x440
ServeRAID M5100
Series SSD Caching
Key for IBM System x,
90Y4318
IBM System x3500 M4
IBM System x3530 M4
IBM System x3550 M4
IBM System x3630 M4
IBM System x3650 M4
IBM System x3750 M4
IBM iDataPlex dx360 M4
ServeRAID M5110 SAS/SATA
Controller for IBM System x,
81Y4481
8009 Machine type and serial
number concatenated (no
spaces or dashes). For
example: 7160KQ5N05V
Yes
ServeRAID M5100
Series SSD Caching
Enabler for IBM Flex
System, 90Y4447
IBM Flex System x240
IBM Flex System x220
IBM Flex System x440
ServeRAID M5100
Series RAID 6 Upgrade
for IBM System x,
81Y4546
IBM System x3300 M4
IBM System x3500 M4
IBM System x3530 M4
IBM System x3550 M4
IBM System x3630 M4
IBM System x3650 M4
IBM System x3750 M4
IBM iDataPlex dx360 M4
ServeRAID M5110 SAS/SATA
Controller for IBM System x,
81Y4481
8012 Machine type and serial
number concatenated (no
spaces or dashes). For
example: 7160KQ5N05V
Yes
ServeRAID M5100
Series RAID 6 Upgradefor IBM Flex System
IBM Flex System x240
IBM Flex System x220 IBM Flex System x440
FoD upgrade Supported by FoD type
number
UID to obtain an
authorization code
Reboot
required
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 84/92
72 Using IBM Features on Demand
ServeRAID
M1100/M5100 Series
SWR SAS Upgrade for
IBM System x
IBM Flex System x240
IBM Flex System x220
IBM Flex System x440
IBM System x3500 M4
IBM System x3530 M4 IBM System x3550 M4
IBM System x3630 M4
IBM System x3650 M4
IBM System x3750 M4
IBM iDataPlex dx360 M4
8013 Machine type and serial
number concatenated (no
spaces or dashes). For
example: 7160KQ5N05V
Yes
ServeRAID M1100
Series Zero
Cache/RAID 5 Upgrade
for IBM System x,
81Y4542
ServeRAID M5100
Series ZeroCache/RAID 5 Upgrade
for IBM System x,
81Y4544
IBM Flex System x240
IBM Flex System x220
IBM Flex System x440
IBM System x3300 M4
IBM System x3500 M4
IBM System x3530 M4
IBM System x3550 M4
IBM System x3630 M4 IBM System x3650 M4
IBM System x3750 M4
IBM iDataPlex dx360 M4
800c Machine type and serial
number concatenated (no
spaces or dashes). For
example: 7160KQ5N05V
Yes
8-pack SATA
Enablement Key for IBM
System x, 90Y4349
IBM System x3300 M4
IBM System x3530 M4
IBM System x3630 M4
8000 Machine type and serial
number concatenated (no
spaces or dashes). For
example: 7160KQ5N05V
Yes
ServeRAID C100 RAID
5 Upgrade for IBM
System x, 81Y4406
IBM System x3100 M4
IBM System x3250 M4
IBM System x3300 M4
8002 Machine type and serial
number concatenated (no
spaces or dashes). For
example: 7160KQ5N05V
Yes
QLogic 8200 VFA
FCoE/iSCSI License for
IBM System x, 00Y5624
QLogic 8200 Dual Port
10GbE SFP+ VFA for IBM
System x, 90Y4600
8014 13 character serial
number of the adapter
(including the letters
RFE). For example
RFE1223G29078
Yes
QLogic Embedded VFA
FCoE/iSCSI License for
IBM System x, 90Y5179
QLogic Dual Port 10GbE
SFP+ Embedded VFA for IBM
System x, 90Y6454
800A Machine type and serial
number of the server,
concatenated (no spaces
or dashes). For example:
7160KQ5N05V
Yes
Flex System I/O module-based features
IBM Flex SystemEN2092 1Gb Ethernet
Scalable Switch
(Upgrade 1), 90Y3562
IBM Flex System EN20921Gb Ethernet Scalable Switch Notapplicable IBM switch serial number(12 characters) Yes (switchrestart)
IBM Flex System
EN2092 1Gb Ethernet
Scalable Switch (10Gb
Uplinnks), 49Y4298
IBM Flex System EN2092
1Gb Ethernet Scalable Switch
Not
applicable
IBM switch serial number
(12 characters)
Yes (switch
restart)
FoD upgrade Supported by FoD type
number
UID to obtain an
authorization code
Reboot
required
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 85/92
Appendix A. FoD Component reference73
IBM Flex System Fabric
EN4093 10Gb Scalable
Switch (Upgrade 1),
49Y4798
IBM Flex System Fabric
EN4093 10Gb Scalable
Switch
Not
applicable
IBM switch serial number
(12 characters)
Yes (switch
restart)
IBM Flex System Fabric
EN4093 10Gb Scalable
Switch (Upgrade 2),
88Y6037
IBM Flex System Fabric
EN4093 10Gb Scalable
Switch
Not
applicable
IBM switch serial number
(12 characters)
Yes (switch
restart)
IBM Flex System Fabric
CN4093 10Gb
Converged Switch
(Upgrade 1) (2 x 40Gb)
IBM Flex System Fabric
CN4093 10Gb Converged
Scalable Switch
Not
applicable
IBM switch serial number
(12 characters)
Yes (switch
restart)
IBM Flex System Fabric
CN4093 10Gb
Converged Switch
(Upgrade 2) (6x Omni
Port)
IBM Flex System Fabric
CN4093 10Gb Converged
Scalable Switch
Not
applicable
IBM switch serial number
(12 characters)
Yes (switch
restart)
IBM Flex System
IB6131 Infiniband
Switch (FDR Upgrade),
90Y3462
IBM Flex System IB6131
Infiniband Switch
Not
applicable
11S Number with the 11S
omitted
Yes (switch
restart)
Flex System Manager features
IBM Flex System
Manager™ Advanced
Upgrade
IBM Flex System Manager
Node
Not
applicable
FSM machine type and
serial number (no spaces
or dashes). For example:
8731xxxxxxx
Restart of
FSM service
FoD upgrade Supported by FoD type
number
UID to obtain an
authorization code
Reboot
required
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 86/92
74 Using IBM Features on Demand
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 87/92
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 88/92
76 Using IBM Features on Demand
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 89/92
© Copyright IBM Corp. 2012. All rights reserved.77
Related publications
The publications listed in this section are considered particularly suitable for a more detailed
discussion of the topics covered in this paper.
IBM Redbooks publications
The following IBM Redbooks publications provide additional information about the topic in thisdocument. Note that some publications referenced in this list might be available in softcopyonly.
IBM Redbooks Product Guides on System x servers
http://www.redbooks.ibm.com/portals/systemx?Open&page=pg&cat=servers
IMM and IMM2 Support on IBM System x and BladeCenter Servers
http://www.redbooks.ibm.com/abstracts/tips0849.html?Open
You can search for, view, download or order these documents and other Redbooks,Redpapers, Web Docs, draft and additional materials, at the following website:
ibm.com/redbooks
Other publications
These publications are also relevant as further information sources:
Features on Demand User’s Guide
http://ibm.com/support/entry/portal/docdisplay?lndocid=MIGR-5089568
IBM Integrated Management Module (IMM2) User’s Guide
http://ibm.com/support/entry/portal/docdisplay?lndocid=MIGR-5086346
IBM Dynamic System Analysis (DSA) Installation and User’s Guide
http://ibm.com/support/entry/portal/docdisplay?lndocid=MIGR-5084901
IBM Advanced Settings Utility (ASU) User’s Guide
http://ibm.com/support/entry/portal/docdisplay?lndocid=MIGR-5085890
Online resourcesThese websites are also relevant as further information sources:
IBM Features on Demand web site
http://ibm.com/systems/x/fod
IBM Dynamic System Analysis (DSA)
http://ibm.com/support/entry/portal/docdisplay?lndocid=SERV-DSA
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 90/92
78 Using IBM Features on Demand
IBM Advanced Settings Utility (ASU)
http://ibm.com/support/entry/portal/docdisplay?lndocid=TOOL-ASU
RETAIN tip: Feature on Demand key replacement process for Emulex VFA/VFA IIIAdapter
http://ibm.com/support/entry/portal/docdisplay?lndocid=MIGR-5090088
Help from IBM
IBM Support and downloads
ibm.com/support
IBM Global Services
ibm.com/services
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 91/92
8/13/2019 Using IBM Features on Demand
http://slidepdf.com/reader/full/using-ibm-features-on-demand 92/92
®
INTERNATIONALTECHNICALSUPPORTORGANIZATION
BUILDING TECHNICALINFORMATION BASED OPRACTICAL EXPERIENC
IBM Redbooks are developby the IBM InternationalTechnical SupportOrganization. Experts fromIBM, Customers and Partn
from around the world creatimely technical informatiobased on realistic scenarioSpecific recommendationsare provided to help youimplement IT solutions moeffectively in yourenvironment.
Redpape
Using IBM Features onDemand
Introduces IBM
Features on Demand
and the products that
use it
Explains how to
activate, install and
deploy the license
keys
Provides
troubleshooting hints
and tips
IBM® Features on Demand (FoD) is a new licensing procedure to
enable features on System x®, BladeCenter®, and Flex System
servers and components. The components activated by FoD are
already integrated into the server or adapter or other option. These
components remain locked until the upgrade is activated and applied
to the server.
Features on Demand enables you to buy the features that you need
now with the ability to enhance your system later without costly
hardware upgrades. An example is the x3630 M4 and x3530 M4
servers that have two Intel Gigabit ports as standard but also include
the hardware for two additional Gigabit ports should you later wish to
activate them.
If you instead choose to purchase a server and the FoD upgrades at the
same time, IBM manufacturing can install the activation key on the
server so that the FoD function is ready for you to use when you
receive the server.
This paper describes the processes involved with activating andinstalling the FoD upgrades. We also cover activation key backup and
what to do when servicing a system that has FoD upgrades already
installed. This paper is meant for IBM employees, Business Partners,
and customers wishing to better understand the Features on Demand
offerings and needing to purchase, install, or service a system with
FoD upgrades.
Back cover