VMmanager 6: Administrator guide

Installation

ISPSystem

To install VMmanager, you need license information. If you purchased VMmanager from ISPsystem, you can view this information in your personal account at my.ispsystem.com in the "ISPsystem 6 licenses" section. To install, you need a value from the Token field.

Note

SELinux will be disabled during the installation as it prevents the platform from working correctly.

Installation steps


  1. Connect to the server via SSH with the superuser permissions (root per default). 
  2. Download the installation script: 

    curl -O http://download.ispsystem.com/6/installer/vm/vm
  3. Make it executable:

    chmod +x vm
  4. Run the installation process using the license token:

    ./vm install -l token

    Where:

    • token —  the value of the Token parameter of your license. You can find it in the Client area my.ispsystem.com on the license information page.

      Note

      During the installation, docker container images will be downloaded to the server. By default, the platform installer uses port 5000/tcp for downloading. If incoming connections to this port are denied, use the --registry-port parameter to install: 

      ./vm install -l="<token>" --registry-port <port>

      <token> —  the value of the Token parameter of your license


      <port> — TCP port for downloading images 

    Execute the command

    ./vm install -l="<token>" --proxy http://<user>:<password>@<address>:<port>

    Where:

    • <token> —  the value of the Token parameter of your license. You can find it in the Client area my.ispsystem.com on the license information page;
    • <user> — username for authorization. Optional parameter;
    • <password> — password for authorization. Optional parameter;
    • <address> — HTTP proxy IP address;
    • <port> — HTTP proxy port.
    Example of the command for a proxy with authorization
    ./vm install -l="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" --proxy http://admin:pass123@192.168.57.1:3128
    Example of the command for a proxy without authorization
    ./vm install -l="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" --proxy http://192.168.57.1:3128
  5. After the platform is installed successfully, in the terminal you will see the access link to VMmanager: 

    The panel has been successfully installed
    Link to administrator registration page: https://1.2.3.4/auth/setup?token=C50A0BFA55DEDE3343AABE713022A15F
  6. The installer will be started as the systemd service. Use it to run the installer again.
  7. Use this link to open the web interface of VMmanager and enter the credentials of the first user.

After installation, VMmanager platform will be available by the IP address or domain name of your server.


When VMmanager is installed on the server, but the first user is not created, you can get the unique link to the web-interface: 

  1. Connect through SSH to the server with VMmanager. 
  2. Execute the installation command through the systemd service vm: 

    vm install -l token 

    Where:

    • token —  the value of the Token parameter of your license. You can find it in the Client area my.ispsystem.com on the license information page.
  3. Log in to the interface using the link and specify the credentials of the first user.

Logs


The VMmanager installation log is kept in the file /opt/ispsystem/vm/install.log.

Thank you for your feedback!
Was the article useful?
Tell us why not:

it does not match the title

it was hard to understand

I didn't find the answer

recommendations from the article did not help

other

Tell us what you didn't like in the article: