Using the command line to add the virtual machine image to the IBM Hardware Appliances image catalog

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:

  1. From a command prompt, change to the directory that contains the extracted files.
  2. Enter the following command:
    • Windows platformOn Windows: loader.bat -h hostName -u userid -p password
    • Linux platformOn 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:

Notices | Trademarks | Downloads | Library | Support | Feedback

Copyright IBM Corporation 1999, 2013Copyright IBM Corporation 1999, 2013.

        
        Last updated
        
        Last updated : 2015-02-14 04:35:23


Task topicTask topic | Version 8.0.0.2 | bk52370_