# Installing the monq product

These instrucitons will help you install monq.

ATTENTION

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

Installing monq is divided into two main steps: preparing infrastructure and installing monq software.

# 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.

The installer image is prepared for import into VMware vSphere 6.5, VMware Workstation, VMWare Player. Also, the image can be successfully converted for import into other virtualization systems. This was checked for Xen, Hyper-V, oVirt(kvm).

You can find reference information on importing into VMWare Workstation here

Use the following recommendations to import the image into VMWare vSphere.

After the first start of the virtual machine, you need to boot into rescue-mode.

Image

After loading the OS, enter the console and execute the dracut -f command to create a new initramfs file (initial RAM disk image, a file with a file system image loaded into RAM)

Image

# Network preparation

After successfully importing the image into the virtualization environment, create a network interface on the virtual machine and turn on the VM.

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 of the cluster components is not required.

# Restarting Kubernetes cluster components

Only performed when manually assigning an IP address.

  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-7 minutes, containers with Kubernetes components will be recreated.

  6. 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

# Installing monq

ATTENTION

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

  1. Connect to the virtual machine via SSH.

    After rebooting the virtual machine, it takes time for infrastructure entities to start. It is recommended to pause for 5-7 minutes and then continue installing the software.

    Login and password: monq:monq

  2. After logging in, the installer menu will automatically launch.

  3. Select monq-install.

    Image

  4. Read the license agreement and click "OK".

    Image

  5. Set a domain name for the system being installed.

    WARNING

    Note that the domain name monq.local is system reserved and is not allowed.

    Image

  6. Select the default locale for the system being installed.

    Image

  7. Confirm the correctness of the entered data and start the installation.

    Image

  8. At the last stage of the installation, information for connecting to the monq web interface will be displayed

    Image

Authorization data for accessing the monq web interface after installation:

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

Secrets to the monq infrastructure objects will be stored in Kubernetes pl_auth and system_auth secrets.

After successful installation, go to the 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. Connect to the virtual machine via SSH:

    Login and password monq:monq

  2. After logging in, the installer menu will automatically launch.

  3. Select monq-erase and confirm your intention to remove the software.

    Image

# Additionally

# Using VM management console (shell)

  1. Connect to the virtual machine via SSH:

    Login and password monq:monq

  2. After logging in, the installer menu will automatically launch.
  3. Select Exit to shell
  4. The monq user has superuser privileges.

# Replacing the SSL certificate

If the system is installed using a real domain name and you have an SSL certificate for this domain (files fullchain.pem and privkey.pem), run the following command:

kubectl create secret tls {GLOBAL-DOMAIN}-tls --cert={fullchain.pem} --key={privkey.pem} --dry-run -n production -o yaml | kubectl -n production replace -n production -f -

# Loading a business calendar

Loading a business (production) calendar.

# Importing image into VMware vSphere

  1. Download the installer image from the site [monq.ru] (https://monq.ru/download):

    The downloaded archive contains a virtual disk file monq-installer-full.vmdk with pre-installed system software.

  2. Upload the monq-installer-full.vmdk file to the datastore of your hypervisor in any convenient way.

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

    #vmkfstools -i {path to monq-installer-full.vmdk} {path to new disk-full.vmdk}
    cd /vmfs/volumes/datastore1/
    vmkfstools -i monq-installer-full.vmdk disk-full.vmdk
    Destination disk format: VMFS zeroedthick
    Cloning disk 'monq-installer-full.vmdk'...
    Clone: 100% done.
    
  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.