Kubernetes and UMHLens

Here you will find guides that deal with the Container Management application Kubernetes and the IDE for it, UMHLens.

Here we aggregate guides on how to work with both Kubernetes and UMHLens when using the United Manufacturing Hub.

Kubernetes is an open source system for container management. It allows to manage and supervise containers and pods of Docker setups.

UMHLens is an application to practically visualize and manage a running Kubernetes system.

The Knowledge section has some information on Kubernetes, but if you want more in-depth information, we suggest watching the following video.


Redis not starting after server restart

This article will help you to get redis running again after an error following a server restart

Set up port-forwarding in UMHLens

Access not exposed internal services of the United Manufacturing Hub using port-forwarding and UMHLens

No connection to MQTT due to vernemq/HiveMQ pod timeout

how to fix VerneMQ being killed in a timeout in UMHLens

Change ACL configuration

How to change the ACL configuration to allow more users to publish to the MQTT broker

OpenLens not loading the Helm Chart

Troubleshooting problems with loading the Helm chart in OpenLens

Connecting new MQTT clients

To connect new MQTT clients, use either the external IP of the instance, or the internal DNS name. Specify a unique username and use no password. Then, adjust the ACL to allow reading/writing into that topic.

How to restart a StatefulSet

How to restart a StatefulSet in Kubernetes using UMHLens by first scaling down the replicas, and then scaling it up again

What to do when 'RELEASE' is not found when updating the Helm chart?

This troubleshooting guide explains why RELEASE is not found when updating the Helm chart.

Changing temporarily the version of a Docker container in Kubernetes

This article explains how to change the version of a Docker container deployed in a Kubernetes cluster. This involves changing the Docker image tag. This can be the case if you, for example, want to try out the latest development version.

Migrating DB ordertable (< 0.9.5 to ≥ 0.9.5)

This migration has to be done on every server, which was originally created using stack version < 0.9.5

Creating new Kubernetes resources

To add your own microservices or expose an internal service, you might need to create your own Kubernetes resource.

Activate metrics in UMHLens

Activated metrics allow you to see CPU, RAM, etc. in UMHLens

Migrate DB from varchar to text (< 0.9.5 to ≥ 0.9.5)

This migration has to be done on every server, which was originally created using stack version < 0.9.5

How to troubleshoot 'has no deployed releases' error during deployment?

This troubleshooting guide helps you troubleshoot the error ‘has no deployed releases while doing deployment.

How to find the static IP of a PLC?

This troubleshooting guide describes how to troubleshoot for connecting to a PLC with their static IP in a WAN network.

Troubleshoot Kubernetes

Basic troubleshooting guide for Kubernetes

Restart a pod in UMHLens

Sometimes a Pod needs to be restarted in Kubernetes.

What to do when error 'failed to download' is displayed in UMHLens while upgrading the Helm Chart?

This troubleshooting guides aims to describe what to do when updating the Helm chart and the error message appears ‘failed to download’.

Accessing factoryinsight from outside of the cluster

I want to connect my webapp to factoryinsight so it can use its API. How can I do that?

Making Kafka accessible from outside the cluster

By default, Kafka is only available locally. Setting externalAccess.enabled in the Helm Chart just breaks the entire Kafka installation (no pod starting).

Executing SQL commands in the United Manufacturing Hub?

How to execute SQL commands on TimescaleDB using the Shell?

What to do if I receive an error message while installing Helm Chart?

When installing the Helm Chart the following error message appears: INSTALLATION FAILED: unable to build kubernetes objects from release manifest.

Accessing Kafka Shell scripts in the United Manufacturing Hub?

When working in Kafka you are often required to use shell scripts like XXX, YYY, etc.. Because we are using Kubernetes, Helm and https://github.com/bitnami/bitnami-docker-kafka charts this is not self explanatory to find and use them. Some actions can also be executed with https://cloudhut.dev/.

Last modified February 17, 2023: update (#208) (ea731fc)