Create an MKS Cluster - EcoSys - 3.1 - Installation & Upgrade - Hexagon

Follow the steps below:

The Ubuntu server hostname must be all lower case and cannot use underscores.

1. Transfer the helm and installer folders from the installation media to the installation machine.

2. Go to the installer directory on the installer machine.

3. To provide all the script executable permissions, run the command, ‘chmod +x *.sh’

4. Go to the microk8s sub directory.

5. To provide all the script executable permissions, run the command, ‘chmod +x *.sh’

6. Edit the env.sh file and customize any settings based on your infrastructure.

   The following are few important settings to adjust.

   It is recommended only to change the property settings in the env.sh script. Modifying the code in env.sh or in any script is not recommended.

   Setting	Description
   DEPLOYMENT_ID	The deployment ID should be unique across all deployments because it is used to namespace components on shared infrastructure. Example: Production, Test, Project1-Production The default is set to get the machines hostname
   DEPLOYMENT_TARGET	This is set to Microk8s. Do not edit this setting
   PRODUCTION	Set to true or false. Determine the deployment mode which influences the deployment size and CPU/memory settings. See Deployment Sizing table for more information.
   SIZE	Determines the # of nodes in the cluster. See Deployment sizing table for more information
   DNS	The IP address of a DNS Server for name resolution of local resources. This should be set to your corporate DNS server so that local resources can be resolved by the cluster/Connect
   HOSTNAME	Set to automatically get the hostname of the server using the $(hostname) command. This should not be changed without guidance from Hexagon Support.
   PV_STORAGE_PATH	A directory on the host used to host persistence volumes. This directory needs to be created before running the installation.
   CONNECT_NAMESPACE	The namespace used to install the Connect components
   AGENT_NAMESPACE	The namespace used to install the Agent components

   There are other settings and statements in the env.sh file. It is not recommended to change these settings unless working with Hexagon support.

7. Create the directory set in the PV_STORAGE_PATH. For example, by default PV_STORAGE_PATH is set to /pv so you would need to run ‘sudo mkdir /pv’ to create the directory.

8. Create the cluster by running ‘./create-cluster.sh’

   1. The script will install the latest version of Microk8s and configure the required plugins required for Connect

   2. The script will ask permission to complete certain operations during the install, reply as needed.

   3. At the end of the script, it will re-login the user and ask for a password. Enter the password for the current user.

9. When the create-cluster.sh script completes, it displays a command to run. Execute the command. Example: ‘cd /home/ecosys/installer/microk8s; ./resume-create-cluster.sh’ to complete the install.

10. To check that Microk8s is installed and running, execute ‘microk8s status’. The following add ons must be enabled: – dns, helm3, istio, storage.

    Other add ons might be enabled and will not effect Connect's deployment.