# Install monq product

This guide will guide you through the installation of your selected monq product.

WARNING

Before install monq be sure to read the requirements and product architecture.

Installation of monq products is divided into two main stages

Use the links to quickly navigate to the required installation step.

# Setting up the infrastructure

# Import VM image

WARNING

monq products are installed using a VM image.
VM Admin Credentials – root/root.

Import the image into the virtualization system. Create a network interface in the virtual machine, assign an IP address, and reboot the VM.

Installer image prepared for import into VMware vSphere 6.5, VMware Workstation, VMWare Player. If you are using VMware vSphere 5.5 please note the following notes. The IP address and DNS server must be assigned manually. DHCP is not allowed.

dns=8.8.8.8
gw=192.168.1.1
ipa=192.168.1.28/24
   
nmcli connection modify "Wired connection 1" ipv4.dns ${dns} ipv4.addresses ${ipa} ipv4.gateway ${gw} ipv4.method manual

# Infrastructure installation

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

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

Further actions are performed in the web interface:

  1. Go to the web interface installer.in.monq.local:888
  2. Log in with your account admin/admin
  3. Go to PROJECTSmonqJOBS and run infra install
  4. Set variable values:
    • global_domain – main domain name, after starting the system will be available for this domain name, for example – monq.example.ru.
    • nodeIp – The IP address of the target server where monq is installed.
  5. Run the script in the web interface - click Run Job Now.
  6. After the script is executed, the infrastructure objects inside Kubernetes will be launched on the server.

# Installing application software

# Installing the software

WARNING

A prerequisite before starting this script is to run infrastructure installations.

  1. Go to the web interface installer.in.monq.local:888.
  2. Go to PROJECTSmonqJOBS and run monq install.
  3. Set variable values:
    • global_domain – main domain name, after starting the system will be available for this domain name, for example – monq.example.ru.
    • nodeIp – The IP address of the target server where monq is installed.
  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 execution will display information for connecting to the monq web interface:
    TASK [sm : echo ui interface credentials] **************************************
    ok: [d-head] => {
    "msg": [
        "save you credentials:",
        "- ui interface: <domain-name>",
        "- ui interface username: <user-name>",
        "- ui interface password: <password>"
            ]
        }
    
    Authentication data for accessing monq and its infrastructure objects will be kept in Kubernetes secrets pl_auth and system_auth. In case of loss of authorization data, the password can be restored as follows – run the command on the target server as root:
    kubectl get secrets -n production pl-auth -o json | jq -r .data.pl_auth | base64 --decode | jq .identity_connect_info.identity_users.UserProfileAdmin.identity_user_password
    

After successful installation, go to license guide.

# Removing the software

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

  1. Go to the web interface installer.in.monq.local:888.
  2. Go to PROJECTSmonqJOBS and run monq erase.
  3. Set variable value nodeIp – The IP address of the server on which it was installed monq.
  4. Run the script in the web interface, click Run Job Now.

# Installer Features

# Import image in 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 extension monq_{version}.ovf prepared for VMware vSphere 6.5 and therefore incompatible with the VMware vSphere 5.5.
  2. Upload to Hypervisor datastore a file monq_{version}-disk1.vmdk.
  3. Connect to the Hypervisor using the SSH protocol and run the following command to import the disk image:
    vmkfstools -i {path to monq_{version}-disk1.vmdk} {path to monq_disk.vmdk}
    
  4. Create Virtual Machine, Note the following parameters when creating:
    • SCSI controller - LSI Logic Parallel
    • Use an existing virtual disk - Select converted disk in ch.3
  5. Save the parameters, turn on the virtual machine and proceed to the further installation of monq.
✏️: 29.07.2021