This post shows you how to load the MQ 7.0.1 Hypervisor Edition (HVE) image to a IBM Workload Deployer (IWD) appliance or Pure Application (PureApp) System. (Note that version 7.5 of the WebSphere MQ 7.5 Hypervisor Edition already includes CLI scripts to upload the Hypervisor image so this tip only applies to the original MQ 7.0.1 Hypervisor Edition image).
You have two options when you need to load a hypervisor edition into an appliance catalogue... You can either upload the HVE image through the appliance's web console, or you can push the image to the appliance using a command line interface (CLI) script. In order to load the image via the web console you must provide an HTTP or SCP URL which points to the image (this is because the image files can be several gigabytes and most browsers only support file uploads up to 2Gb) so you must be able host the HVE image on a web server, or put it on a machine to which you have SSH access. The scripts described in this post will be most useful in circumstances where it is not convenient to host the HVE image on a web server or a machine accessible via SCP.
Before you can run the scripts you will need to get hold of the Pure CLI (or Deployer CLI if you are using IWD) and the MQ Hypervisor Edition itself. The CLI is a zip file available from the web console Welcome panel (highlighted below), so download it and unpack it.
The MQ Hypervisor Edition is available from Passport Advantage - in this example we'll use MQ HVE 22.214.171.124 which is packed in a tarball called CI6PWML.tgz. Download the tarball and unpack it into an empty directory on the same machine as the CLI. You should end up with a directory like this...
The files with a *.zip suffix are examples of script packages (useful for tailoring your patterns) and the large file with a *.ova suffix is the MQ HVE image itself. The ova file contains the disk images for the virtual machine, the machine description, plus the metadata and part descriptions that make the Hypervisor Edition work well with IWD and Pure App Systems.
To complete your preparation, download the MQHVE-RHEL-loader-scripts.zip file by clicking this link and unpack it into the directory where you unpacked CI6PWML.tgz.
Loading the HVE and script packages and creating patterns
The MQHVE-RHEL-loader-scripts.zip file contains three scripts MQHVE-RHEL-AddVirtualImage-7018.py, MQHVE-RHEL-addScriptPackages.py, and MQHVE-RHEL-createPatterns-7018.py which you can use to upload the image, upload script packages, and create patterns respectively.
The Pure (or IWD) CLI you downloaded earlier contains the python runtime and everything else you need to run the scripts. Before you go any further make sure you know the hostname of your appliance, and have a user Id with sufficient permission to create catalogue content.
To load the MQ HVE image to the appliance, switch to the directory which contains the HVE image and the loader scripts and run the following command. This uploads the ~3Gb HVE ova file so it takes a while to run.
[PATH_TO_CLI]/pure.cli/bin/pure -a -h [PURE_IP_ADDRESS] -u [USER] -p [PASSWORD] -f MQHVE-RHEL-AddVirtualImage-7018.py
NOTE: Before you can do anything with the image you need to log onto your appliance and accept the license(s).
This next script creates two very simple patterns that you can use to deploy the MQ HVE
[PATH_TO_CLI]/pure.cli/bin/pure -a -h [PURE_IP_ADDRESS] -u [USER] -p [PASSWORD] -f MQHVE-RHEL-createPatterns-7018.py
...and this final script uploads the two MQ script packages. Make sure that WMQExecuteMQSC.zip, and WMQConfigureClustering.zip are in the directory when you run this one.
[PATH_TO_CLI]/pure.cli/bin/pure -a -h [PURE_IP_ADDRESS] -u [USER] -p [PASSWORD] -f MQHVE-RHEL-addScriptPackages.py
You can use these loader scripts without modification for the MQ 126.96.36.199 Linux HVE but you will need to change them to upload alternative versions of the HVE, or to upload the PowerVM version of the HVE. If you want to load the scripts to IWD then you will need to substitute the word 'deployer' for the word 'pure' in the commands, and remove the '-a' flag.