DCImanager Administrator

Installation

ISPSystem

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

Note

DCImanager uses the Docker virtualization system. By default, it uses networks 172.17.0.0/12. If your equipment uses addresses from these networks, you can change your Docker settings. For more information, see How to change the network used by Docker?

Note

We recommend disabling the SELinux service, as it slows down the operation of the platform and may prevent its correct installation.

Installation steps


  1. Connect to the server via SSH with superuser permissions (root per default).

  2. Download the installation script: 

    curl -O https://download.ispsystem.com/6/dci/dcibox/dci
  3. Make it executable: 

    chmod +x dci
  4. Run the installation using the activation key (license token):

    ./dci install -l="<token>"

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

    Execute the command

    ./dci 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 eu.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
    ./dci install -l="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" --proxy http://admin:pass123@192.168.57.1:3128
    Example of the command for a proxy without authorization
    ./dci install -l="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" --proxy http://192.168.57.1:3128
  5. Wait when the installation is completed. You will see the URL to DCImanager: 

    Terminal after successfull installation
    Link to DCImanager administrator registration page: https://127.0.0.1/auth/setup?token=C50A0BFA55DEDE3343AABE713022A15F

    Note

    When you open a link, your browser will display a warning about a possible security threat. This is because the server uses a self-signed SSL certificate. You can connect a valid SSL certificate to the platform by following the instructions.

  6. Go to the DCImanager interface using the received link and create the first user:
    1. Enter the User email.
    2. Create a Password or click generate to automatically generate a password.
    3. Click Done.
  7. Perform the initial setup of the platform.
  8. If you have a resource package certificate, activate it:
    1. Go to System information Activate package.
    2. Enter the code from your resource package certificate.

    3. Press Activate.

      For more information about resource packs, see the Licensing article.

After installation, DCImanager platform will be available by the IP address or domain name of your server. The installer will be started as the systemd service.

Reinstalling the platform


  1. Create a new Token value for your license. You can do it in your client area at eu.ispsystem.com or contact technical support.
  2. Stop the platform:

    dci down
  3. Delete directories /opt/ispsystem/dci and /var/lib/mysql:

    rm /opt/ispsystem/dci /var/lib/mysql -rf
  4. Restart the dci service:

    systemctl restart dci
  5. Install the platform:

    dci install -l <new_token>

    Comments to the command:

    • <new_token> — new value of the Token parameter for your license.

Logs


The DCImanager installation log is kept in the file /opt/ispsystem/dci/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: