Mike Gregor Senior Power Consultant

28 August 2014

AIX-VUG Advanced PowerVM Toolkit

IBM Lab Based Services

2014 IBM Corporation

Advanced PowerVM Toolkit

Value Proposition
Business Challenge
Clients struggling with consistency in their build process when deploying VIO servers and clients.
Differences in configuration depending on who built the systems and when.
Attempted to develop their own scripts and automation, but struggled with adding new features and
ongoing support.
Issues migrating partitions from one managed system to another
Solution
Introduced the Advanced PowerVM Toolkit and process to accelerate the clients transition from
Power6->Power7->Power8 across their infrastructure.
Provide planning, assessment and execution to implement the Toolkit and provisioning process
based on client requirements.
Work with customer to integrate Toolkit into their existing build process and automation.
Key Benefits
Reduced manual errors associated with current build process.
Able to integrate Toolkit into their existing automation, thereby creating a repeatable methodology for
deploying new VIO servers and client LPARs

2014 IBM Corporation

Advanced PowerVM Toolkit

Typical Provisioning Flow

Gathering of system build information

HMC, managed system
VIO and client names, network, storage, cpu, memory,vswitches, processor pools,
Repeated series of:
HMC GUI or command line execution
NIM commands
VIO commands
3

2014 IBM Corporation

Advanced PowerVM Toolkit

Advanced PowerVM Toolkit Flow

Use gathered system information to create build profiles using the Toolkit Provisioning Language
Single VIOS build profile which defines your VIO server configuration
One or more client build profiles which defines clients to build on same frame
Process these simple, ASCII-text build profiles using Provisioning Toolkit
Executes the HMC, NIM, and VIO commands in proper order
Produces repeatable results
Apply build profile templates to new similar frames by changing variables
One touch VIO build and configuration
Capture / Create / Build capabilities
4

2014 IBM Corporation

Advanced PowerVM Toolkit

Capture

Capture profile contains hmc, group, [managed system, [partition,[profile]] that defines data
to retrieve and where to place it
Code can be run interactively to specify the HMC, managed systems, and partitions
Commands are issued through HMC to gather data associated with VIO servers and client
partitions
Basis for performing migrations or DR activity
Logically groups data for deployment to target frames

2014 IBM Corporation

Advanced PowerVM Toolkit

Create

Uses previously captured data to create build profiles

Process one or multiple systems captured data
Create VIO pair to support selected client networks
Reuse of client VFC wwpns
Add, remove, and over ride capabilities for any partition attribute
Config profile contains minimum set of information that requires updating
client ip, netmask, gateway,bosinst, vlans
Summary file represents VIO and client partition requirements in csv format
cpu, memory, network, storage
6

2014 IBM Corporation

Advanced PowerVM Toolkit

Build

Use gathered system information to create build profiles using the Toolkit Provisioning Language
Single VIOS build profile which defines your VIO server configuration
One or more client build profiles which defines clients to build on same frame
Process these simple, ASCII-text build profiles using Provisioning Toolkit
Issues the HMC, NIM, and VIO commands
Produces repeatable results
Apply build profile templates to new similar frames by changing variables
One touch VIO build and configuration

2014 IBM Corporation

Advanced PowerVM Toolkit

Wiki style Users Guide

Easy lookup of function and syntax
Code examples

2014 IBM Corporation

Advanced PowerVM Toolkit

User Interface
Java Swing-based to run on nearly any desktop or laptop
Provisioning Toolkit syntax-aware build profile editor facilitates build profile creation:
Provides built-in sample templates for VIO Server and Client build profiles (e.g. VIO
Server pair, NPIV Client, VSCSI Client)
Provides built-in samples for individual Toolkit keyword use (e.g. SERVERINFO,
PARTITION, SEA, etc.)
Keyword and syntax highlighting guides build profile creation
Syntax awareness detects numerous classes of errors and typos to find errors in build
profiles before processing them
Remote execution of build operations from within the UI

2014 IBM Corporation

Advanced PowerVM Toolkit

Options for Obtaining Advanced PowerVM Toolkit

Deal Closer Program (Pre- or Post Sales for our Sellers on the line)
See PreDefined Service offering for Toolkit out under Deal Closer website
PowerCare Program (eligible for 770/780/795 only) - select "POA" option at time of TDA
Direct Lab Services Statement of Work (SOW)
Business Partner Contract Attachment (CA)
$12,500 One Time Fee

For further questions on funding approach, please contact:

Linda Hoben
-ORStephen Brandenburg

10

2014 IBM Corporation

hoben@us.ibm.com 1-720-395-0556
sbranden@us.ibm.com 1-301-240-2182

Advanced PowerVM Toolkit

Code and Documentation Updates

IBM ResourceLink
Customer is registered with IBMID and notified when complete
Subscription capability allows for automatic notification of updates
Customer downloads at their convenience

11

2014 IBM Corporation

Advanced PowerVM Toolkit

New Function 4Q-2014

VSCSIMAP to disk UDID
DRAW capability for build profiles and current managed system
UI support for capture/create

12

2014 IBM Corporation

Advanced PowerVM Toolkit

Additional Support Slides

13

2014 IBM Corporation

Advanced PowerVM Toolkit

APVM Toolkit Build Provisioning Language

SERVERINFO
VARIABLES
SHAREDPP
VSWITCH
BOSINST
DEFINE
DISKATTR
VSCSIRESOLVE
VSCSIZONE
FABRIC
FABRICDEF

14

2014 IBM Corporation

Define a managed system and its managing HMC

Create a free-form substitution variable
Create or rename a shared processor pool in hypervisor
Create or rename a virtual switch in the hypervisor
Define a NIM resource OS image
Create a NIM definition on-the-fly
Define hdisk attributes used for VSCSI mapped disks
Choose a sort order for VSCSI LUN size matching
Define a system as part of a common VSCSI zone
Designate a fabric name for VFC client adapters wwpn report
Designate a fabric identifier for a list of HBA ports

Advanced PowerVM Toolkit

APVM Toolkit Build Provisioning Language

ENATTR
ENTATTR
ECHATTR
SEAATTR
SEADEF
FCSATTR
FSCSIATTR
IOSLOTS
HEA
VETHMAP
PARTITIONDEF
PARTITION
VIO

15

2014 IBM Corporation

Create a named set of enX device attributes

Create a named set of entX device attributes
Create a named set of etherchannel attributes
Create a named set of SEA attributes
Create a named set of common SEA parameters
Create a named set of fcsX device attributes
Create a named set of fscsiX device attributes
Assign physical I/O slots to a partition
Configure an IVE port
Define a virtual ethernet adapter for a client partition
Create a named set of partition parameters
Define a logical partition
Define a VIO stanza

Advanced PowerVM Toolkit

APVM Toolkit Build Provisioning Language (VIO Stanza)

EN
ENT
ETHERCHANNEL
PORT
SEA
MKVG
FCS
FSCSI
VFCGEN
VFCMAP
VFCMAPFABRIC
VSCSIGEN
VSCSIMAP
VSCSIMAPLV

16

2014 IBM Corporation

Set attributes for VIOs enX devices defined in ENATTR

Set attributes for VIOs entX devices defined in ENTATTR
Create an etherchannel device for the VIO
Configure a physical or virtual ethernet port for the VIO
Configure an SEA for the VIO
Create a volume group on VIO
Set attributes for VIOs fcsX devices defined in FCSATTR
Set attributes for VIOs fscsiX devices defined in FSCSIATTR
Create VFC adapters in client and VIO
Map a VFC adapter to an VIO HBA port
Map VFC adapter to HBA ports defined by FABRICDEF
Create VSCSI adapters in client and VIO
map a VSCSI adapter to a LUN
map a VSCSI adapter to a logical volume

Advanced PowerVM Toolkit

User Interface - File

17

2014 IBM Corporation

Advanced PowerVM Toolkit

User Interface - File

18

2014 IBM Corporation

Advanced PowerVM Toolkit

User Interface - Insert

19

2014 IBM Corporation

Advanced PowerVM Toolkit

User Interface - Deploy

20

2014 IBM Corporation

Advanced PowerVM Toolkit

User Interface - Execute

21

2014 IBM Corporation

Advanced PowerVM Toolkit

User Interface Execution Output

22

2014 IBM Corporation

Advanced PowerVM Toolkit

User Interface - View

23

2014 IBM Corporation

Advanced PowerVM Toolkit

User Interface - Themes

24

2014 IBM Corporation