51 lines
3.7 KiB
Markdown
51 lines
3.7 KiB
Markdown
<p align="center"><img src="https://developer.ibm.com/messaging/wp-content/uploads/sites/18/2017/07/IBM-MQ-Square-200.png" width="150"></p>
|
|
|
|
# Overview
|
|
|
|
Run [IBM® MQ](http://www-03.ibm.com/software/products/en/ibm-mq) in a container. The supplied [Helm](https://helm.sh/) chart can be used to run the container on a [Kubernetes](https://kubernetes.io) cluster, such as [IBM Cloud private](https://www.ibm.com/cloud-computing/products/ibm-cloud-private/) or the [IBM Bluemix Container Service](https://www.ibm.com/cloud-computing/bluemix/containers).
|
|
|
|
# Current status
|
|
This repository contains code under active development. **It is not yet ready for production use**
|
|
|
|
# Build
|
|
After extracting the code from this repository, you can build an image with the latest version of MQ using the following command:
|
|
|
|
## Building MQ Advanced
|
|
You can build an image for MQ Advanced, follow these steps:
|
|
|
|
1. Clone this repository into the correct location in your [`GOPATH`](https://github.com/golang/go/wiki/GOPATH)
|
|
2. Create a directory called `downloads` under the cloned directory tree
|
|
3. Download the MQ Advanced for Ubuntu (debs) installer package file `CNJR7ML.tar.gz` into the `downloads` directory
|
|
4. Run `make build-advancedserver`
|
|
|
|
# Usage
|
|
In order to use the image, it is necessary to accept the terms of the IBM MQ license. This is achieved by specifying the environment variable `LICENSE` equal to `accept` when running the image. You can also view the license terms by setting this variable to `view`. Failure to set the variable will result in the termination of the container with a usage statement. You can view the license in a different language by also setting the `LANG` environment variable.
|
|
|
|
|
|
## List of all Environment variables supported by this image
|
|
|
|
* **LICENSE** - Set this to `accept` to agree to the MQ Advanced for Developers license. If you wish to see the license you can set this to `view`.
|
|
* **LANG** - Set this to the language you would like the license to be printed in.
|
|
* **MQ_QMGR_NAME** - Set this to the name you want your Queue Manager to be created with.
|
|
* **MQ_QMGR_CMDLEVEL** - Set this to the `CMDLEVEL` you wish your Queue Manager to be started with.
|
|
|
|
|
|
# Issues and contributions
|
|
|
|
For issues relating specifically to the container image or Helm chart, please use the [GitHub issue tracker](https://github.com/ibm-messaging/mq-container/issues). If you do submit a Pull Request related to this Docker image, please indicate in the Pull Request that you accept and agree to be bound by the terms of the [IBM Contributor License Agreement](CLA.md).
|
|
|
|
|
|
# License
|
|
|
|
The Dockerfiles and associated code and scripts are licensed under the [Apache License 2.0](http://www.apache.org/licenses/LICENSE-2.0.html).
|
|
Licenses for the products installed within the images are as follows:
|
|
|
|
- [IBM MQ Advanced for Developers](http://www14.software.ibm.com/cgi-bin/weblap/lap.pl?la_formnum=Z125-3301-14&li_formnum=L-APIG-AKHJY4) (International License Agreement for Non-Warranted Programs). This license may be viewed from an image using the `LICENSE=view` environment variable as described above or by following the link above.
|
|
- [IBM MQ Advanced](http://www14.software.ibm.com/cgi-bin/weblap/lap.pl?la_formnum=Z125-3301-14&li_formnum=L-APIG-AKHJJP) (International Program License Agreement). This license may be viewed from an image using the `LICENSE=view` environment variable as described above or by following the link above.
|
|
- License information for Ubuntu packages may be found in `/usr/share/doc/${package}/copyright`
|
|
|
|
Note: The IBM MQ Advanced for Developers license does not permit further distribution and the terms restrict usage to a developer machine.
|
|
|
|
# Copyright
|
|
|
|
© Copyright IBM Corporation 2015, 2017 |