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

EcoSys Connect Installation and Configuration (Microk8s Kubernetes)

Language
English
Product
EcoSys
Search by Category
Installation & Upgrade
EcoSys Version
3.0

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.