Creating Smart Virtual Appliances with IBM Image Construction and Composition Tool

319 Pages·2013·5.14 MB·English

Front cover
Creating Smart Virtual Appliances
with IBM Image Construction and
Composition Tool
Create smart appliances that are
cloud-ready
Develop PowerVM, KVM, and ESX
customized virtual appliances
Learn from experts how to
cloudify your applications
Jarek Miszczyk
Greg Hurlebaus Pat Nickel
Rashed Ferdous David Peraza
John Jacobson Moises Romo
Li-Fang Lee Kerry Staples
ibm.com/redbooks

International Technical Support Organization
Creating Smart Virtual Appliances with IBM Image
Construction and Composition Tool
July 2013
SG24-8042-01
Note: Before using this information and the product it supports, read the information in “Notices” on
pageix.
Second Edition (July 2013)
This edition applies to Version 2, Release 2, Modification 1.1 of the IBM Image Construction and Composition
Tool.
© Copyright International Business Machines Corporation 2012, 2013. All rights reserved.
Note to U.S. Government Users Restricted Rights -- Use, duplication or disclosure restricted by GSA ADP Schedule
Contract with IBM Corp.
Contents
Notices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix
Trademarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .x
Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xi
Authors. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xi
Now you can become a published author, too! . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii
Comments welcome. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii
Stay connected to IBM Redbooks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiv
Chapter 1. Introduction to virtual appliance construction . . . . . . . . . . . . . . . . . . . . . . . 1
1.1 Deploying your applications into the cloud . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
1.2 Solving the terminology puzzle. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
1.3 Why implement software virtual appliances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
1.4 A need for a virtual appliance construction tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
1.4.1 Application packaging options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
1.4.2 Supported deployment options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
1.5 Putting the Image Construction and Composition Tool into context. . . . . . . . . . . . . . . . 7
1.5.1 Image Construction and Composition Tool and the IBM PureSystems . . . . . . . . . 7
1.5.2 Image Construction and Composition Tool and the IBM Workload Deployer. . . . . 9
Chapter 2. Anatomy of a virtual appliance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
2.1 Description of a virtual appliance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
2.2 Components of a virtual appliance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
2.2.1 The OVF file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
2.3 Virtual appliance self-activation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
2.4 IBM Virtual Solutions Activation Engine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
2.5 What a virtual appliance is not . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Chapter 3. Architecture of the IBM Image Construction and Composition Tool. . . . . 21
3.1 Actors and use cases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
3.1.1 Operating system specialist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
3.1.2 Software specialist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
3.1.3 Virtual appliance architect. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
3.2 Component view. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
3.2.1 The model. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
3.2.2 Package generators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
3.2.3 Cloud providers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
3.3 Flow of the main scenarios. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
3.3.1 Importing an image from a cloud provider. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
3.3.2 Importing an image from a running virtual machine . . . . . . . . . . . . . . . . . . . . . . . 31
3.3.3 Extending a base OS image. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
3.3.4 Capturing a synchronized virtual image instance . . . . . . . . . . . . . . . . . . . . . . . . . 34
3.3.5 Exporting a virtual appliance. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
3.4 Cloud provider concepts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
3.5 Software bundle concepts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
3.6 Image concepts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
3.7 User interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Chapter 4. Setting up the virtual appliance build environment . . . . . . . . . . . . . . . . . . 45
© Copyright IBM Corp. 2012, 2013. All rights reserved. iii
4.1 Installing the Image Construction and Composition Tool . . . . . . . . . . . . . . . . . . . . . . . 46
4.1.1 Installing the tool on Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
4.1.2 Installing the tool on AIX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
4.1.3 Accessing the tool. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
4.2 Setting up the build environment for PowerVM virtual appliances . . . . . . . . . . . . . . . . 49
4.2.1 Reference architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
4.2.2 Requirements and recommendations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
4.2.3 Creating the build environment. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
4.3 Setting up the build environment for KVM virtual appliances . . . . . . . . . . . . . . . . . . . . 65
4.3.1 Reference architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
4.3.2 Nodes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
4.3.3 Tips and techniques . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
Chapter 5. Product Activator Development Kit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
5.1 Overview of the Product Activator Development Kit. . . . . . . . . . . . . . . . . . . . . . . . . . . 74
5.2 Installing PADK. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
5.3 A walkthrough of the development process by using PADK. . . . . . . . . . . . . . . . . . . . . 77
5.3.1 Installing the Virtual Solutions Activation Engine manually. . . . . . . . . . . . . . . . . . 77
5.3.2 Prototyping the activation program. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
5.3.3 Creating a product activator project in Eclipse . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
5.3.4 Coding the activation program . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
5.3.5 Setting up the connection to the target virtual machine . . . . . . . . . . . . . . . . . . . . 82
5.3.6 Running and debugging the activation program. . . . . . . . . . . . . . . . . . . . . . . . . . 84
5.3.7 PADK integration with Image Construction and Composition Tool. . . . . . . . . . . . 86
Chapter 6. KVM Express cloud provider. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
6.1 Overview of the KVM provider architecture. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
6.2 Setting up the KVM provider. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
6.2.1 Installing the KVM provider. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
6.2.2 Managing the KVM provider. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
6.2.3 Creating the KVM cloud provider . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
6.3 Creating a base image from ISO. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
6.3.1 Preliminary setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
6.3.2 Importing an ISO image . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
6.3.3 Building a base operating system appliance. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
6.4 Importing a running virtual machine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
6.4.1 Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
6.4.2 Importing a running VM from the host system of the KVM provider . . . . . . . . . . 102
6.5 Importing virtual images (appliances) from the KVM cloud provider. . . . . . . . . . . . . . 104
6.5.1 Importing virtual images . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
6.5.2 Importing a virtual appliance. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
6.6 Removing an image (appliance) from the virtual appliance repository . . . . . . . . . . . . 106
6.7 Working with bundles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
6.7.1 Passing parameters to the reset operation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
6.8 Validating virtual images by using the OVA Runtime . . . . . . . . . . . . . . . . . . . . . . . . . 109
6.8.1 Deploying a virtual image (appliance) with OVA Runtime. . . . . . . . . . . . . . . . . . 110
6.8.2 Stopping and releasing a running VM (workload). . . . . . . . . . . . . . . . . . . . . . . . 112
6.9 Tips to override default behavior of the KVM provider . . . . . . . . . . . . . . . . . . . . . . . . 112
6.9.1 Modifying the template OVF file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
6.9.2 Changing the default number of clones . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
6.10 Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
6.10.1 Checking the Image Construction and Composition Tool and the KVM
providerversions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
iv Creating Smart Virtual Appliances with IBM Image Construction and Composition Tool
6.10.2 Image Construction and Composition Tool logs. . . . . . . . . . . . . . . . . . . . . . . . 114
6.10.3 KVM provider logs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
6.10.4 Validating that the KVM provider is active. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
6.10.5 Considerations for restarting the KVM provider services . . . . . . . . . . . . . . . . . 116
6.10.6 Resolving common issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
Chapter 7. PowerVM Express cloud provider. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
7.1 Overview of the PowerVM provider. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
7.2 Requirements for PowerVM provider . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
7.3 Configuring a PowerVM provider . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
7.4 Creating a virtual appliance. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
7.4.1 Creating a base image . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
7.4.2 Importing a base image . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
7.4.3 Extending, synchronizing, and capturing an image. . . . . . . . . . . . . . . . . . . . . . . 140
7.4.4 Exporting an image as an OVA archive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
7.5 Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
7.5.1 Checking the Image Construction and Composition Tool and the PowerVM
providerversions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
7.5.2 Checking the PowerVM provider logs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
7.5.3 Checking the Image Construction and Composition Tool logs. . . . . . . . . . . . . . 146
7.5.4 Importing from a running virtual machine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
7.5.5 Importing from a cloud provider . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
7.5.6 Extending an image . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
7.5.7 Synchronizing an image . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
7.5.8 Capturing an image. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
7.5.9 Exporting an image. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
Chapter 8. ESX cloud provider. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
8.1 Overview of an ESX cloud provider . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
8.2 Requirements for a VMware ESX cloud provider . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
8.3 Configuring an ESX cloud provider. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
8.4 Creating a virtual appliance. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
8.4.1 Creating a base OS image . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
8.4.2 Importing a base image . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
8.4.3 Working with bundles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
8.4.4 Extending, synchronizing, and capturing a virtual image . . . . . . . . . . . . . . . . . . 173
8.4.5 Exporting an image as an OVA archive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
8.5 Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
8.5.1 The Image Construction and Composition Tool version. . . . . . . . . . . . . . . . . . . 177
8.5.2 Image Construction and Composition Tool logs. . . . . . . . . . . . . . . . . . . . . . . . . 178
8.5.3 Installation logs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178
8.5.4 Image synchronization logs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178
8.5.5 Synchronization fails message: vmPath is null. . . . . . . . . . . . . . . . . . . . . . . . . . 178
8.5.6 Resolving common issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179
Chapter 9. Constructing simple virtual appliances. . . . . . . . . . . . . . . . . . . . . . . . . . . 181
9.1 Scenario overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182
9.2 Implementing the installation and configuration scripts. . . . . . . . . . . . . . . . . . . . . . . . 182
9.2.1 Developing the installation script for IBM WebSphere Application Server
CommunityEdition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183
9.2.2 Developing the configuration script for IBM WebSphere Application Server
Community Edition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185
9.2.3 Developing a configuration script for the web application. . . . . . . . . . . . . . . . . . 188
9.3 Creating a base image . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
Contents v
9.4 Creating software bundles for the Image Construction and Composition Tool. . . . . . 189
9.4.1 Creating a software bundle for IBM WebSphere Application Server
CommunityEdition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
9.4.2 Creating a software bundle for a web application. . . . . . . . . . . . . . . . . . . . . . . . 194
9.5 Building a virtual appliance. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198
9.5.1 Extending the base image to create the sample image . . . . . . . . . . . . . . . . . . . 198
9.5.2 Adding software bundles to sample image. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200
9.5.3 Synchronizing the sample image . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202
9.5.4 Validating the sample virtual image . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203
9.5.5 Capturing the sample virtual appliance. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204
9.5.6 Exporting the sample virtual appliance. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205
9.5.7 Verifying the results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208
9.6 Log file of the Image Construction and Composition Tool . . . . . . . . . . . . . . . . . . . . . 208
9.6.1 Synchronizing a simple virtual appliance image. . . . . . . . . . . . . . . . . . . . . . . . . 209
9.6.2 Capturing a simple virtual appliance image . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
9.6.3 Exporting a simple virtual appliance image. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211
Chapter 10. Constructing complex virtual appliances . . . . . . . . . . . . . . . . . . . . . . . . 221
10.1 Scenario overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222
10.2 Importing running virtual machines. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
10.3 Preparing for activation programs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224
10.3.1 Installing PADK. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224
10.3.2 Examining the configurable resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224
10.3.3 Identifying the intercomponent dependency. . . . . . . . . . . . . . . . . . . . . . . . . . . 225
10.4 Implementing the activation programs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
10.4.1 Creating PADK projects in Eclipse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
10.4.2 Coding activation programs for changeable parameters . . . . . . . . . . . . . . . . . 228
10.4.3 Coding activation programs for intercomponent dependency. . . . . . . . . . . . . . 230
10.5 Creating software bundles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234
10.6 Building virtual appliances. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236
10.6.1 Adding software bundles to base images. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236
10.6.2 Synchronizing virtual appliances. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237
10.6.3 Capturing a virtual appliance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239
10.6.4 Exporting virtual appliances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240
10.7 Validating the results. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240
10.7.1 A deployment documentation template. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241
10.8 Summary. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243
Chapter 11. Virtual appliance deployment options . . . . . . . . . . . . . . . . . . . . . . . . . . . 245
11.1 Deploying KVM virtual appliances to Systems Director VMControl or IBM Flex
SystemManager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246
11.1.1 Importing an appliance into the image repository. . . . . . . . . . . . . . . . . . . . . . . 246
11.1.2 Deploying an appliance on a KVM host or to a KVM system pool . . . . . . . . . . 248
11.1.3 Generating a password hash value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250
11.2 Deploying PowerVM virtual appliances to Systems Director VMControl or IBM Flex
System Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250
11.2.1 Importing a virtual appliance into the Systems Director VMControl
image repository. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250
11.2.2 Deploying the virtual appliance on a PowerVM host or system pool . . . . . . . . 252
11.3 Deploying a virtual appliance with IBM SmartCloud Entry . . . . . . . . . . . . . . . . . . . . 255
11.3.1 Importing PowerVM and KVM virtual appliances into IBM SmartCloud Entry . 255
11.3.2 Managing PowerVM and KVM virtual appliances in IBM SmartCloud Entry. . . 255
11.3.3 Importing OVA into VMware vSphere with vCenter . . . . . . . . . . . . . . . . . . . . . 258
vi Creating Smart Virtual Appliances with IBM Image Construction and Composition Tool
11.3.4 Managing virtual appliances in IBM SmartCloud Entry. . . . . . . . . . . . . . . . . . . 262
Chapter 12. Proven practices. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265
12.1 Virtual appliance naming convention . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266
12.1.1 Image name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266
12.1.2 Universal ID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266
12.1.3 Version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267
12.2 Software bundle naming convention. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267
12.2.1 Bundle name. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267
12.2.2 Universal ID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268
12.2.3 Version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268
12.3 Preinstalling software or creating a bundle with the installation image. . . . . . . . . . . 269
12.4 Best practices for software bundles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270
12.5 Writing shell scripts for software bundle operations . . . . . . . . . . . . . . . . . . . . . . . . . 271
12.5.1 Best practices when writing shell scripts for IBM i . . . . . . . . . . . . . . . . . . . . . . 274
12.6 Testing the product activation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278
12.6.1 Testing the product activation on IBM i. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278
12.7 Split large virtual images. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279
12.7.1 Validating files when splitting an OVA archive . . . . . . . . . . . . . . . . . . . . . . . . . 280
Appendix A. Sample script for KVM host setup. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281
Appendix B. Sample scripts for simple virtual appliance. . . . . . . . . . . . . . . . . . . . . . 283
Installation script for WebSphere Application Server Community Edition . . . . . . . . . . . . . 284
Configuration script for WebSphere Application Server Community Edition . . . . . . . . . . . 286
Configuration script for PlantsByWebSphere. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 287
Appendix C. Editing the generic.ovf file for IBM SmartCloud Entry deployment. . . 289
Appendix D. Additional material . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293
Locating the web material . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293
Using the web material. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293
System requirements for downloading the web material . . . . . . . . . . . . . . . . . . . . . . . 293
Downloading and extracting the web material . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294
Abbreviations and acronyms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295
Related publications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297
IBM Redbooks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297
Online resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297
Help from IBM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298
Contents vii
viii Creating Smart Virtual Appliances with IBM Image Construction and Composition Tool