Install >

Kubernetes


Prerequisites

Install Kubernetes client and a Kubernetes cluster.

Single Node Deployment of WSO2 Enterprise Integrator with Analytics Support


1

Download the simplified Kubernetes setup for WSO2 Enterprise Integrator.

2

Execute the following commands in the downloaded location to provide permissions and deploy WSO2 Enterprise Integrator in your cluster.

chmod +x wso2ei-ga.sh
./wso2ei-ga.sh --deploy

Try navigating to https://<NODE-IP>:30443/carbon/ and https://<NODE_IP>:30643/portal/ using your web browser and log in using credentials admin/admin.

The Integrator gateway can be accessed by the endpoint: https://<NODE-IP>:30243 Note your <NODE-IP> can be the EXTERNAL_IP address of any of your kubernetes clusters.

Refer to the WSO2 Enterprise Integrator - Quick Start Guide to try out WSO2 Enterprise Integrator.

Prerequisites

1

Install Kubernetes client and a Kubernetes cluster that is already setup with NGINX Ingress Controller enabled.

2

A pre-configured Network File System (NFS) to be used as the persistent volume for artifact sharing and persistence.

In the NFS server instance, create a Linux system user account named wso2carbon with user id 802 and a system group named wso2 with group id 802. Add the wso2carbon user to the group wso2.

groupadd --system -g 802 wso2
useradd --system -g 802 -u 802 wso2carbon

Integrator with Analytics


1

Download installation archive for WSO2 Enterprise Integrator Kubernetes resources. In the context of this document, KUBERNETES_HOME will refer to a locally extracted archive.

2

Setup a Network File System (NFS) to be used for persistent storage.

Create and export unique directories within the NFS server instance for each Kubernetes Persistent Volume resource defined in the <KUBERNETES_HOME>/advanced/integrator-analytics/volumes/persistent-volumes.yaml file.

Grant ownership to the wso2carbon user and wso2 group, for each of the previously created directories.

sudo chown -R wso2carbon:wso2 <directory_name>

Grant read-write-execute permissions to the wso2carbon user, for each of the previously created directories.

chmod -R 700 <directory_name>

Then, update each Kubernetes Persistent Volume resource with the corresponding NFS server IP (NFS_SERVER_IP) and exported, NFS server directory path (NFS_LOCATION_PATH).

3

Setup product database(s) using MySQL in Kubernetes. Here, a NFS is needed for persisting MySQL DB data.

Create and export a directory within the NFS server instance.

Provide read-write-execute permissions to other users for the created folder.

Then, update the Kubernetes Persistent Volume resource with the corresponding NFS server IP (NFS_SERVER_IP) and exported, NFS server directory path (NFS_LOCATION_PATH) in <KUBERNETES_HOME>/advanced/integrator-analytics/extras/rdbms/volumes/persistent-volumes.yaml file.

For a serious deployment (e.g. production grade setup), it is recommended to connect product instances to a user-owned and managed RDBMS instance.

4

Move to <KUBERNETES_HOME>/advanced/integrator-analytics/scripts and deploy the Kubernetes resources by executing the <KUBERNETES_HOME>/advanced/integrator-analytics/scripts/deploy.sh file.

cd <KUBERNETES_HOME>/advanced/integrator-analytics/scripts
./deploy.sh
5

Access product management consoles.

Obtain the external IP (EXTERNAL-IP) of the Ingress resources by listing down the Kubernetes Ingresses.

kubectl get ing

The external IP can be found under the ADDRESS column of the output.

Add the above host as an entry in /etc/hosts file as shown below:

<EXTERNAL-IP> wso2ei-analytics-dashboard
<EXTERNAL-IP> wso2ei-integrator-gateway
<EXTERNAL-IP> wso2ei-integrator

Try navigating to https://wso2ei-integrator/carbon and https://wso2ei-analytics-dashboard/portal from your favorite browser.

Integrator, Broker with Analytics


1

Download installation archive for WSO2 Enterprise Integrator Kubernetes resources. In the context of this document, KUBERNETES_HOME will refer to a locally extracted archive.

2

Setup a Network File System (NFS) to be used for persistent storage.

Create and export unique directories within the NFS server instance for each Kubernetes Persistent Volume resource defined in the <KUBERNETES_HOME>/advanced/integrator-broker-analytics/volumes/persistent-volumes.yaml file.

Grant ownership to the wso2carbon user and wso2 group, for each of the previously created directories.

sudo chown -R wso2carbon:wso2 

Grant read-write-execute permissions to the wso2carbon user, for each of the previously created directories.

chmod -R 700 <directory_name>

Then, update each Kubernetes Persistent Volume resource with the corresponding NFS server IP (NFS_SERVER_IP) and exported, NFS server directory path (NFS_LOCATION_PATH).

3

Setup product database(s) using MySQL in Kubernetes. Here, a NFS is needed for persisting MySQL DB data.

Create and export a directory within the NFS server instance.

Provide read-write-execute permissions to other users for the created folder.

Then, update the Kubernetes Persistent Volume resource with the corresponding NFS server IP (NFS_SERVER_IP) and exported, NFS server directory path (NFS_LOCATION_PATH) in <KUBERNETES_HOME>/advanced/integrator-broker-analytics/extras/rdbms/volumes/persistent-volumes.yaml.

For a serious deployment (e.g. production grade setup), it is recommended to connect product instances to a user owned and managed RDBMS instance.

4

Move to <KUBERNETES_HOME>/advanced/integrator-broker-analytics/scripts and deploy the Kubernetes resources by executing the <KUBERNETES_HOME>/advanced/integrator-broker-analytics/scripts/deploy.sh file.

cd <KUBERNETES_HOME>/advanced/integrator-broker-analytics/scripts
./deploy.sh
5

Access product management consoles.

Obtain the external IP (EXTERNAL-IP) of the Ingress resources by listing down the Kubernetes Ingresses.

kubectl get ing

The external IP can be found under the ADDRESS column of the output.

Add the above host as an entry in /etc/hosts file as shown below:

<EXTERNAL-IP> wso2ei-analytics-dashboard
<EXTERNAL-IP> wso2ei-integrator-gateway
<EXTERNAL-IP> wso2ei-integrator
<EXTERNAL-IP> wso2ei-broker

Try navigating to https://wso2ei-integrator/carbon, https://wso2ei-broker/carbon and https://wso2ei-analytics-dashboard/portal from your favorite browser.

Integration Cloud

Free sign-up.

Signing up signifies that you have read and agree to the Terms of Use and Privacy Policy.

Already have an account? Sign In