This installation guide will lead you through the entire installation of the United Manufacturing Hub Stack. This process is divided into three parts: first, the installation of k3OS. Please do note that, while the current videos are very helpful as a resource, some of the information may be outdated at the current point in time. Refer to the text on this page as well as the description of the youtube video to verify if the information is still up to date.
minimal (in testing, see also note further down):
https://umh.app/development-minimal.yamlwhen asked for the cloud-init file during the installation. This is still in testing and not considered stable. For more Information about the differences between minimal and standard visit here.
Depending on your situation you might want to deviate from the guide to do some adjustment but for your first installation it is recommended that you stick to it!
As you can see in the illustration, there are some prerequisites for the installation.
The following things are required:
an edge device with x86 architecture, we recommend the K300 from OnLogic
a computer with an SSH/SHTP client (we recommend MobaXTerm if you are using Windows or inbuilt Linux commands if you are using a Linux OS) and OpenLens installed. We recommend a laptop with an Ethernet port or an Ethernet adapter.
local LAN (with DHCP) available via at least two Ethernet cables and access to the internet.
a computer monitor connected with the edge device
a keyboard connected with the edge device
This is a step-by-step video, which will chaperone you through the first two steps of the installation
The following video will show you how to do the third step: the setup of the stack within OpenLens.
If video guides are not your thing we also have a text based guide right below to help you with the setup!
Insert your USB flash drive with a flashed image of k3OS into your device
Boot from the USB flash device. To do this you need to go into the boot menu of the edge device.
How to do this is different for every hardware and is described in your hardware manual.
If you currently don’t have your hardware manual, you can test for the boot menu button by repeatedly pressing the F1-F12 keys during the boot process of the computer (right after you press the power button) as these buttons are frequently the boot menu buttons. Alternatively you can try the same with the “delete button”.
Then select your USB flash device to boot from.
You should now see the boot menu of k3OS as pictured below. Select “k3OS LiveCD & Installer”
Once the liveCD has sufficiently progressed, type in “rancher” as username and hit Enter.
lsblk and hit Enter to get a rundown of the names of the different disks and find out which name the edge PC’s disk has.
sudo k3os install and press Enter.
1 and then press enter to choose the option “Install to disk”
Press the correct number to select the option to install to the disk of the edge PC, which we have identified in the 5. substep.
The system will now ask you if you want to use a cloud-init file with the installation. Press
y and then Enter.
The system now wants the location of the cloud-init file for the installation. Type in
[https://umh.app/development.yaml](https://umh.app/development.yaml) and press enter.
y and Enter to continue the installation.
At the end of the installation the edge PC will restart. Make sure to remove the USB flash drive from the PC so it doesn’t boot from the USB flash drive again.
After restart wait 60 seconds for the automatic setup to take place.
Wait for the automatic setup to be finished and SSH authentication to be enabled.
The automated development script already took care of this, and this step can be skipped in development environments. However, this is not the default behavior of k3OS and should be deactivated in production environments. In production environments we recommend using a certificate to authenticate, which is enabled by default.
Now we use the other PC device, presumably a laptop, to connect to the Edge PC via SSH authentication. This has the advantage that we can access the Edge PC without the need to plugin a keyboard or a monitor. For this installation guide we assume you are using windows as your operating system.
Open MobaXTerm on your device. You can get MobaXTerm for free from their Website.
Open a new Session by clicking on “Session” in the upper left corner
Select SSH on the upper part of the new window and type in the IP address of the edge PC in the field “Remote Host”. Check the Box next to “specify Username” and type in
rancher in the field next to it.
Press OK to start the connection
When connecting to the Edge PC it should ask for a password. The default password is
rancher. Type it in and press Enter.
You are now successfully logged in via SSH and the interface should look like in the picture below.
Open OpenLens on your device. You can get OpenLens for free from this GitHub Repository.
Click the three horizontal lines in the upper left corner and choose files → preferences
Click on Kubernetes and select “Add custom repo”, type in
https://repo.umh.app as the URL and decide on a name for the repository.
cat /etc/rancher/k3s/k3s.yaml in your SSH session on your laptop (in MobaXTerm if you are using a windows OS) to retrieve the Kubernetes credentials. Copy the content of the result into your clipboard with Ctrl + C.
Click File and then Add Cluster.
Paste the clipboard into the kubeconfig prompt of OpenLens.
Change the IP Address in the kubeconfig to the IP address of the Edge PC. the port (the last 4 numbers after the colon) needs to stay unchanged.
Click on Add Cluster.
Click on the Cluster to connect to it.
helm repo add united-manufacturing-hub https://repo.umh.app/ into the terminal of the OpenLens Cluster.
helm repo update to update.
Fully close the OpenLens App and start OpenLens again.
Click on Browse Clusters in Catalog, then connect to the Cluster.
Click on Helm -> Releases and change the namespace from default to united-manufacturing-hub in the upper right corner
Click on the Release
united-manufacturing-hub to be able to inspect the values.yaml file, which holds the configurations of all microservices used in the cluster.
Make sure the
sensorconnect of the values.yaml is set to be in the same subnet (first 3 numbers of the IP range) as the edge PCs IP. So for example 192.168.10.24 if the Edge PC IP is 192.168.10.1
Click Save. Congratulations! You have installed the United Manufacturing Hub!
If you want to continue right away with the configuration of Node-RED and Grafana, we will also have “how to” guides for that in the future!