DNSmanager 6 Documentation

Installation

This article contains instructions for installing the current (6th) generation of software. Installation of 5th and 4th generation software is not supported.


Install the control panel on a VPS or dedicated server. Before you start, complete the steps described in the article Server requirements. The article describes the algorithm of DNSmanager installation.

License activation 

For a description of the existing license types, see the Licensing article. 

You must activate a trial license in your ISPsystem client area after you install DNSmanager on the server. You do not need to order it in advance.

If you want to use a commercial version you first need to purchase the license. Specify the public IP address of the server where the control panel will be installed.

If the server runs behind the NAT and IP address is assigned to its network interface, the DNSmanager license will be activated during the installation. For more information please refer to the article License IP address.

If the server runs behind the NAT, and the IP address is not specified for the license or the license IP address is not assigned to its network interface, you need to activate your license with a key. Learn more in Activating a license with a key.

Pre-installation

  1. Check the wget utility is installed on the server. 
  2. If you are installing DNSmanager 6 on a server with DNSmanager 5, update DNSmanager 5 to a latest version. For details, see the article Upgrade in DNSmanager 5 Documentation.

Installation

Beside DNSmanager, the installation script will install additional software applications that the control panel needs: 

  • database server  — MariaDB;
  • web server — ihttpd.

The installation script will connect two ISPsystem repositories: ispsystem-base.repo is used for installing additional software, ispsystem.repo is used for installing ISPsystem control panels. 

The SELinux service is disabled during installation, as it may disturb the correct operation of the control panel.

Installation steps: 

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

    wget https://download.ispsystem.com/dnsmgr.install.eu.sh -O install.eu.sh
  3. Start the script:

    sh install.eu.sh
  4. If DNSmanager 5 is installed on the server, the script will offer to perform data migration to DNSmanager 6. When the DNSmanager5 found. Do you want to migrate data from it to DNSmanager6?(y/N) prompt appears, press y to execute the migration. To cancel the migration, press N.
  5. If the installation is successful, the terminal window will show the data for authorization in the control panel:

    dnsmanager6 is installed
    Go to the "https://<server IP address>:1501/dnsmgr" to login
    Login: root
    Password: <root password>
  6. Open the specified URL in your browser and log in to the control panel.

    When you open a link, your browser will display a warning about a possible security threat. This happens if the server uses a self-signed SSL certificate. To avoid this warning, connect a valid SSL certificate to the server.