Skip to content

Installing Ingress

When running Kubernetes on-prem, managing load-balancing must be considered for Sametime Meetings and Web Chat. Both of these Sametime features require the addition of an ingress controller.

Ingress is secured with a TLS certificate which must be created. Create a secret for ingress by following the steps in Updating the TLS certificates on Kubernetes.

If different the host names for Web Chat and Meetings are different, open the values.yaml file and add the following line to identify the Web Chat host name.

extraChatHostname: web\_chat\_hostname

Verify that there are two spaces at the beginning of the line. Save and close the values.yaml file.

Consider reserving a reserve a static IP address for Sametime to use. If one is not define during the installation, the IP address is dynamic and is subject to change.

There are many different ingress controllers available, however; not all of them have been tested with Sametime. The procedure in this topic describes deploying the NGINX Ingress controller. If you are using another ingress controller, refer to the documentation for that ingress controller.

An Ingress controller is also used for the Connect and Embedded clients mux traffic deployed on-premise Kubernetes. After installing the ingress controller, additional configuraiton steps are needed. See Configuring Ingress for Mux for details.

Helm commands are used to install and configure the NGINX Ingress controller.

  1. Add the nginx repository using the helm repo command.

    helm repo add ingress-nginx https://kubernetes.github.io/ingress-nginx

  2. Update the repository with the following command.

    helm repo update

  3. Run the following command to install NGINX.

    helm install nginx-ingress ingress-nginx/ingress-nginx --set controller.service.loadBalancerIP=IP\_address

    Where IP_address is the reserved IP address.

    If you have a namespace dedicated to Sametime, include the namespace option on the command.

  4. Verify that nginx-ingress has accepted the correct static IP address by running the kubectl get command. To break free from this, use Ctrl+C.

    kubectl get ingress

    Use Ctrl+C to return to the command prompt.

  5. Configuring Ingress for Mux

Parent Topic: Installing Sametime in a Kubernetes environment