United Manufacturing Hub ·

Setting up UMH on RHEL / Rocky Linux in Proxmox

Discover how to install the United Manufacturing Hub (UMH) on Red Hat Enterprise Linux (RHEL). It will be installed as a VM running in Proxmox.

Setting up UMH on RHEL / Rocky Linux in Proxmox
⚠️

In this guide, we'll use Rocky Linux. It should work just like RHEL, but we can't promise it will always do so.

Instructions

  1. In Proxmox, make a VM with 4 cores and 8GB of RAM. Make sure to choose 'host' as the CPU type.
    2023-06-27_16h36_28.png

  2. Make the VM and start it. Choose to install Rocky Linux 9.2.
    2023-06-27_16h32_38.png

  3. Follow the setup steps. Pick your hard drive and give the root password. Then, hit “Start Installation” to go on.
    2023-06-27_16h34_12.png

  4. Restart once the setup is done.
    2023-06-27_16h38_03.png

  5. Sign in as root with your password. Type ip addr to find out your IP address.
    2023-06-27_16h39_13.png

  6. Use SSH to connect to it. You'll need the IP and your login info.

  7. Type dnf -y install podman to set up Docker / Podman.

  8. Type curl -sfL https://get.k3s.io | sh - to set up k3s.

  9. Type curl -sfL https://raw.githubusercontent.com/helm/helm/master/scripts/get-helm-3 | sh - to set up Helm.

  10. Type helm repo add united-manufacturing-hub https://repo.umh.app/ to add UMH to your Helm repo.

  11. Type kubectl create namespace united-manufacturing-hub to make a Kubernetes namespace.

  12. Type helm install united-manufacturing-hub united-manufacturing-hub/united-manufacturing-hub --kubeconfig /etc/rancher/k3s/k3s.yaml -n united-manufacturing-hub` to set up the UMH.
    2023-06-27_17h23_52.png

  13. Type the following to allow outside access to the Kubernetes Management Port and allow the Kubernetes pods to see each other:

    firewall-cmd --permanent --add-port=6443/tcp
    firewall-cmd --permanent --zone=trusted --add-source=10.42.0.0/16 # pods
    firewall-cmd --permanent --zone=trusted --add-source=10.43.0.0/16 # services
    firewall-cmd --reload
    

    Remember, you need to open the port for any services you want to use, like 1883 for MQTT.

    If you do not use the commands on line 2 and 3, you will get an error like dial tcp 10.42.0.80:9092: connect: no route to host

  14. You're all set! You can now use it and add it to Lens: https://umh.docs.umh.app/docs/production-guide/installation/flatcar-installation-bare-metal/#import-the-cluster-configuration

Fun-fact: our recommended operating system "flatcar" is actually a fork of CoreOS, the Operating System behind OpenShift, and its based on RHEL. So you can leverage most of our configuration and provisioning tools and only need to make here and there some smaller changes (e.g., the firewall-cmd commands).

Read next

Node-RED meets Benthos!
benthos · Featured

Node-RED meets Benthos!

Yes, we’ve made it possible to bring Node-RED-style simplicity into Benthos pipelines, enabling your chosen LLM to handle tedious manufacturing connectivity and contextualization tasks—whether you’re prototyping or managing production-grade data flows.

Share, Engage, and Contribute!

Discover how you can share your ideas, contribute to our blog, and connect with us on other platforms.