Deploying TIBCO Control Plane in a Kubernetes Cluster
TIBCO Control Plane is deployed in a Kubernetes cluster by using the Helm package manager for Kubernetes. You need to install Helm charts for TIBCO Control Plane and its components in your Kubernetes cluster.
- If you have not already set up Kubernetes cluster infrastructure required for TIBCO Control Plane deployment, see Setting up Kubernetes Cluster on Amazon EKS.
- If you have an existing Kubernetes cluster, See Preparing a Kubernetes Cluster for TIBCO Control Plane Deployment.
- Ensure that Helm is installed and configured.
- Ensure that kubectl is installed.
- You can use prerequisites validation script to validate that all prerequisites for TIBCO Control Plane installation are completed.
- If
manageDbSchemain Helm chart values is set to false, the chart does not manage database schemas. You must use the script provided in GitHub repository to create, upgrade, and delete databases externally. For more information, see PostgreSQL Database Management Script.
To deploy TIBCO Control Plane in your Kubernetes cluster, you must perform the following steps:
Step 2: Add the Helm Chart Repository
Step 3: Create a Namespace for TIBCO Control Plane
Step 4: Configure TIBCO Control Plane Helm Chart Values
Step 5: Install tibco-cp-base chart
Step 6: Install Capability Charts
Step 7: Provision Subscription from TIBCO Platform Console
Step 8: Sign in to TIBCO Control Plane
Step 1: Get the JFrog Token
The Account owner must get the Jfrog token which is required to access the Docker images from the TIBCO JFrog repository. The account owner receives an activation email that contains the link to sign in to TIBCO Operated Control Plane environment. The account owner must click the link in the email to accept invite and sign in. After signing in to TIBCO Control Plane, perform the following steps to get the token:
- Procedure
- In TIBCO Operated Control Plane, click Settings menu.
- On the Account details page, in the Container Registry Credentials section, you can see Registry URL, Username, and Password. Copy all the three values.
- Copy the Customer ID from the Account Details section.
You must specify Registry URL, Username, and Password values in the tibco-cp-base chart values file. You must specify Customer ID in the tibco-cp-base chart. For more information about configuring Helm chart values, see Configuring TIBCO Control Plane Helm Chart Values.
Step 2: Add the Helm Chart Repository
The Helm charts required to install TIBCO Control Plane are available in the GitHub repository. To add this repository in your local path, run the following command:
helm repo add tibco-platform https://tibcosoftware.github.io/tp-helm-charts
Step 3: Create a Namespace for TIBCO Control Plane
Create a namespace where TIBCO Control Plane charts are installed. The namespace used must have the platform.tibco.com/controlplane-instance-id label along with the controlPlaneInstanceId value.
kubectl label namespace <namespace-name> platform.tibco.com/controlplane-instance-id=<controlPlaneInstanceId>Here controlPlaneInstanceId is the unique identifier (Example: prod, stag) that you specify in the tibco-cp-base chart values. The controlPlaneInstanceId must be lowercase alphanumeric string of maximum 5 characters.
Specify this namespace created when installing the tibco-cp-base chart.
Step 4: Configure TIBCO Control Plane Helm Chart Values
Before installing charts required to deploy TIBCO Control Plane, you must configure values used by these charts as per your environment. For more information, see Configuring TIBCO Control Plane Helm Chart Values.
Step 5: Install tibco-cp-base chart
The tibco-cp-base chart installs all the required charts for TIBCO Control Plane components.
To install the tibco-cp-base chart, run the following command:
helm upgrade --install -n <namespace> <release_name> tibco-platform/tibco-cp-base -f values.yaml --version=<Helm_Chart_Version>To install a specific chart version, use the --version flag. For more information about which chart version to install, see Helm Chart Version Matrix.
After the chart is installed, you must sign in to TIBCO Platform Console and provision subscription.
(Optional) To install TIBCO® Platform Add-on for Event Processing, run the following command. The tibco-cp-addon-eventprocessing chart installs all charts required for TIBCO BusinessEvents product.
helm upgrade --install -n <namespace> tibco-cp-addon-eventprocessing tibco-platform/tibco-cp-addon-eventprocessing -f values.yaml --version=<Helm_Chart_Version>Step 6: Install Capability Charts
After installing tibco-cp-base chart, you must install the capability charts. Until Capability charts are installed, all capability related workflows are disabled. For more information, see Installing Capability Charts.
Step 7: Provision Subscription from TIBCO Platform Console
After the tibco-cp-base chart is installed, Administrator can use initialPassword to sign in to TIBCO Platform Console with default IdP or retrieve initialPassword from the system logs and then sign in. TIBCO Platform Console is web UI to provision and manage subscription for TIBCO Control Plane. Administrator must sign in to TIBCO Platform Console and provision subscription. For more information about provisioning subscription in TIBCO Platform Console, see Provisioning a Subscription.
Step 8: Sign in to TIBCO Control Plane
After Administrator has provisioned subscription, the owner receives an email with the link to sign in to TIBCO Control Plane. For more information, see Signing in to TIBCO Control Plane.