Deploying IBM Integration Bus to IBM Cloud Private

You can deploy IBM® Integration Bus to the IBM private cloud, which is based on Kubernetes.

Before you begin

Complete the following steps to install and configure IBM Cloud Private V2.1, as described in the IBM Cloud Private documentation:
  • Install IBM Cloud Private V2.1. If it is already installed, ensure sure that the Kubectl command line interface (CLI) is also installed, so that you can target any Kubernetes cloud that you require. For information about how to install the Kubectl CLI, see the topic Accessing your IBM Cloud Private cluster by using the kubectl CLI in the IBM Cloud Private documentation.
  • Install the IBM Cloud Private CLI and log in to your cluster.
  • Configure authentication from your computer to the Docker private registry host and log in to the private registry.
  • If you are not a root user, ensure that your account is part of the docker group.

About this task

This topic describes how to deploy IBM Integration Bus (Advanced Edition) to IBM Cloud Private, by using Helm Charts. Alternatively, you can choose to deploy IBM Integration Bus for Developers, by following the instructions in Deploying IBM Integration Bus for Developers to IBM Cloud Private.

Procedure

Complete the following steps to deploy IBM Integration Bus (Advanced Edition) to IBM Cloud Private:

  1. Obtain the IBM Integration Bus compressed file from IBM Passport Advantage.
  2. Log in to your cluster from the IBM Cloud Private CLI and log in to the Docker private image registry, as shown in the following command: 
    bx pr login -a https://cluster_CA_domain:8443 --skip-ssl-validation
docker login cluster_CA_domain:8500
    where cluster_CA_domain is the certificate authority (CA) domain. If you did not specify a CA domain, the default value is mycluster.icp.
  3. Install the IBM Integration Bus compressed file from Passport Advantage, by entering the following command: 
    bx pr load-ppa-archive --archive compressed_file_name [--clustername cluster_CA_domain] [--namespace namespace]
    where compressed_file_name is the name of the file that you downloaded from Passport Advantage, cluster_CA_domain is the (CA) domain, and namespace is the Docker namespace that hosts the Docker image.
  4. Manually sync the repositories, so that the installed chart appears in the Catalog:
    1. From the menu in the IBM Cloud Private dashboard, select Admin > Respositories.
    2. Click Sync repositories and then select OK.
    3. When it has completed, the ibm-integration-bus-prod chart is displayed in the Catalog.
  5. You can install and configure the IBM Integration Bus chart from the IBM Cloud Private Catalog, or you can use the command line to access the Helm Charts directly from https://github.com/IBM/charts. The following steps show how to access and install the chart by using the Catalog:
    1. From the menu in the IBM Cloud Private dashboard, select Catalog.
    2. Select the ibm-integration-bus-prod chart and then click Configure.
    3. A configuration page for your new IBM Integration Bus service is displayed.
  6. Configure your IBM Integration Bus service, by setting values for the following properties:
    1. Set the Release name property to the name of your new service.
    2. Accept the license by ticking the box.
    3. Set the nodename property to the name of your integration node.
    4. Set the servername to the name of your integration server.
      You can leave the other fields with their default values.
    5. Click Install.
    For more information about the IBM Integration Bus Helm Chart, see ot4i/iib-helm.
  7. You are now ready to start using IBM Integration Bus.