27.6. Testing Bundle Packages
27.6.1. Installing the Bundle Deployer Tool
- Click the Administration tab in the top menu.
- Select the Downloads in the left menu table.
- Scroll to the Bundle Deployer Download section, and click the package download link.
- Save the
.zipfile into the directory where the bundle tool should be installed, such as
- Unzip the packages.
cd /opt/ unzip rhq-bundle-deployer-version.zip
27.6.2. Using the Bundle Deployer Tool
- Unzip the bundle distribution package to check (or copy an unzipped directory that contains the application files). For example:
mkdir /tmp/test-bundle cd /tmp/test-bundle unzip MyBundle.zip
- Open the top directory of the bundle distribution, where the
deploy.xmlAnt recipe file is.
- Set the bundle deployer tool location in the PATH.
- Run the bundle deploy tool, and use the format
-Dinput_properties to pass the values to user-defined tokens in the templatized files. For example:
rhq-ant -Drhq.deploy.dir=/opt/exampleApp -Dlistener.port=7081This installs the application in
/opt/exampleAppand sets a port value of 7081.NoteOptionally, use the
rhq.deploy.idattribute to set an identifier for the deployment. The default is 0, which means a new deployment. When bundles are deployed in the UI, the server assigns a unique ID to the deployment. Using the
rhq.deploy.idattribute on a new deployment simulates the server's ID assignment.Using the
rhq.deploy.idattribute if there is already a previous deployment allows you to test the upgrade performance of the bundle. Performing an upgrade requires a new, unique ID number.