You can use the Image
Loader command
line utility on a Microsoft Windows or Linux system to load the WebSphere® Message Broker Hypervisor Edition virtual machine image
into the IBM® Hardware
Appliances image
catalog. The virtual machine image includes patterns and script packages
that are automatically added to the IBM Hardware
Appliances.
Before you begin
Before you can add the virtual machine
image to the catalog, ensure that you have completed the following
tasks:
- Download the WebSphere Message Broker Hypervisor Edition package for your selected IBM Hardware
Appliances from Passport Advantage®. This package
contains the Image
Loader command
line utility that you use to add the virtual machine image to the IBM Hardware
Appliances image catalog.
- Extract the downloaded package into an empty directory. The package
is supplied as a tar file that has been compressed
into GNU compressed file format. On Linux,
the package can be extracted using the tar command
with the -z (gzip) option. Use tar version 1.20
or higher. On Windows, there
are a number of commonly available tools which can be used to extract
the package. The extracted package is approximately 20% larger than
the downloaded package.
- Ensure that you have Java Runtime Environment (JRE) version 6
SR3 or later installed.
- Verify that you can establish an active connection to your IBM Hardware
Appliances, and that you have
one of the following permissions necessary to load virtual images
to the image catalog:
- Create new catalog content.
- Cloud administration.
- Ensure that there are 10 MB or more of free space in the home
directory of the user who runs the Image
Loader utility.
Procedure
To use the Image
Loader utility
from a command line to load a virtual machine image on to the IBM Hardware
Appliances, complete the following
steps:
- From a command prompt, change to the directory that contains
the extracted files.
- Enter the following command:
On Windows: loader.bat
-h hostName -u userid -p password
On Linux: loader.sh
-h hostName -u userid -p password
where:
- hostName
- The host name of the IBM Hardware Appliance.
Use the DNS or IP address for the appliance. For example, machine1.mybank.com,
or 2.48.158.97.
- userid
- The user ID required to authenticate to the IBM Hardware Appliance.
- password
- The password for the user ID. If you do not specify a password
you are prompted to enter it during the loading process.
Results
The WebSphere Message Broker Hypervisor Edition virtual image is loaded
and is now available in the virtual images catalog of the IBM Hardware
Appliances user interface.
In
addition, several patterns and script packages are added to the IBM Hardware Appliance.
What to do next
Now that you have completed loading the virtual image,
you can complete one of the following tasks:
- Deploy the patterns and script packages immediately.
- Use the Pattern Editor to clone and customize the patterns and
script packages.