Docs

# Installing the monq product

This tutorial will help you install monq on dedicated servers.

ATTENTION

Before installing monq be sure to read product requirements and architecture.

Installing monq is divided into two main steps:

Use the links below to quickly jump to the desired stage of the installation.

# Infrastructure setup

# Importing a VM Image

ATTENTION

Monq products are installed using a VM image. VM administrator credentials – root/root.

Import the image into the virtualization system. Create a network interface on the virtual machine and turn on the VM. You can find help information on import here

The installer image is prepared for import into VMware vSphere 6.5, VMware Workstation, VMWare Player. If you are using VMware vSphere 5.5, pay attention to the following nuances.

ATTENTION

If the VM address is assigned manually, after turning on the VM, you will need to restart components of the kubernetes cluster.

If the address is assigned by the DHCP server, restarting the cluster components is not required.

Restarting kubernetes cluster components:

  1. Go to the VM Console

  2. Stop kubelet:

    systemctl stop kubelet

  3. Remove containers

    docker ps --format "{{.Names}}" -f "name=k8s_kube*" -f "name=k8s_POD_kube*" | xargs docker rm -f

  4. Start kubelet

    systemctl start kubelet

  5. Wait 5 minutes, containers with kubernetes components will be recreated. You can make sure that the cluster is working with the following command

    kubectl get po -n kube-system

    All components must be running and have the corresponding status Running

# Installing application software

Before installing the application software be sure to properly setup infrastructure

Ensure name resolution on the machine from which the installation will be performed - configure the file hosts:

<server-IP-address> installer.in.monq.local

# Installing monq

ATTENTION

A mandatory requirement before running this script is properly setup infrastructure.

  1. Go to the installer web interface at the address installer.in.monq.local:888 (admin/admin).

  2. Go to PROJECTS → monq → JOBS and run monq install.

  3. Set a desired value to the variable global_domain – main domain name. After launch, the system will be available under the given domain name, for example, monq.example.ru.

  4. Run the script in the web interface - click Run Job Now.

  5. Go to the execution log - click Log Output.

  6. The log of the last operation of the script will display information for connecting to the web interface of monq:

    TASK [sm : echo ui interface credentials] **************************************
ok: [d-head] => {
"msg": [
    "save you credentials:",
    "- ui interface: <domain name>",
    "- ui interface username: <username>",
    "- ui interface password: <password>"
        ]
    }

Authorization data to access monq web interface after installation:

  • login - admin@{global_domain}
  • password - monq_admin

Secrets to monq infrastructure objects will be kept as kubernetes secrets pl_auth and system_auth.

After successful installation, go to instructions for managing license keys.

# Removing monq

If the installation completed with an error or there was a typo in the domain name, it is recommended to clean the system from traces of the application software - to do this, run a special script:

  1. Go to the installer web interface at the address installer.in.monq.local:888.
  2. Go to PROJECTS → monq → JOBS and run monq erase.
  3. Set a value to the variable nodeIp – the IP address of the server that monq was installed on.
  4. Run the script in the web interface - click Run Job Now.

# Installer peculiarities

# Importing image into VMware ESXI 5.5

  1. Download the installer image as a VM:

    The image contains 2 files:

    • monq_{version}.ovf
    • monq_{version}-disk1.vmdk

    File with extensionmonq_{version}.ovf prepared for VMware vSphere 6.5 and therefore incompatible with VMware vSphere 5.5.

  2. Load the file monq_{version}-disk1.vmdk in the datastore of your hypervisor in any convenient way.

  3. Connect to the hypervisor using the SSH protocol and run the following command to import the disk image:

    vmkfstools -i {the path to the file monq_{version}-disk1.vmdk} {path to the new disk image}

  4. Create a virtual machine, pay special attention to the following parameters when creating:

    • SCSI controller - LSI Logic Parallel
    • Use an existing virtual disk - Select the newly imported disk image from step 3

  5. Save the settings, turn on the virtual machine.

  6. Boot the system for the first time in rescue mode and run the command dracut -f to recreate initramfs.

  7. Do a reboot shutdown -r now and proceed further to setup infrastructure.