A freshly installed server or a server with DNSmanager

Note

When you install DNSmanager and IPmanager on the same server you don't need to integrate them. 

The installation steps

  1. If DNSmanager 5 is not installed, proceed to install it. Learn more in Installation and Getting started with DNSmanager.

    Note

    DNSmanager and IPmanager must work with the same DNS-server: BIND or PowerDNS.

  2. Create a new user in DNSmanager. IPmanager will store reverse domain zones in the namespace of that user.
  3. Install IPmanager. Learn more in the article  Installation guide.

  4.  Add the ViewName parameter into the IPmanager configuration file (by default it is located in /usr/local/mgr5/etc/ipmgr.conf)

    echo "ViewName <name space>" >> /usr/local/mgr5/etc/ipmgr.conf
    BASH

    <name space> — enter the namespace of the user in DNSmanager that was created on step 2.

  5. Restart IPmanager:

    /usr/local/mgr5/sbin/mgrctl -m ipmgr exit
    BASH

If IPmanager is already installed

Note.

When you install DNSmanager and IPmanager on the same server you don't need to integrate them. 

Step 1. Configuring the control panels 

  1. Install and configure DNSmanager. Learn more in Installation and Getting started with DNSmanager.

    Note

    DNSmanager and IPmanager must work with the same DNS-server: BIND or PowerDNS.

  2. Create a new user in DNSmanager. IPmanager will store reverse domain zones in the namespace of that user.

  3. Add the ViewName parameter  into the IPmanager configuration file (by default it is located in /usr/local/mgr5/etc/ipmgr.conf):

    echo "ViewName <name space>" >> /usr/local/mgr5/etc/ipmgr.conf
    BASH

    <name space> — enter the name space of the user in DNSmanager that was created on step 2.

Step 2. Configuring the DNS-server 

If you use BIND:

  1. Edit the DNS-sever configuration file:
    1. CentOS: /etc/named.conf
    2. Debian: /etc/bind/named.conf

  2. Change :

    view "default" {
    BASH

    into

    view "<name space>" {
    BASH

    <name space> — enter the namespace of the user in DNSmanager that was created on step 2 of the

  3. In this section "view" change the values of the  match-destinations and transfer-source parameters:

    match-destinations { <user IP address>; };
transfer-source <user IP address>;
    BASH

    <User IP address> — IP address of the user in DNSmanager created on step 2 of the stage 1. You can find the IP address in DNSmanager → Accounts → Users→ Edit→ IP address.

If you use PowerDNS:

  1. Create the PowerDNS database dump:

    mysqldump <database name> > <path to file>
    BASH
    <database name> — powerdns for CentOS, pdns for Debian

    <path to file> — a full path of the dump

  2. Create a database

    mysql
CREATE DATABASE <database name>
    BASH

    <database name> — name space of the user in DNSmanager that was created on step 2 of stage 1. Change the dot in the space name into "_". E.g., if the space name is "example.test", the database name is "example_test".

  3. Import the data from the dump into the database: 

    mysql <database name> < <path to dump>
    BASH

    <database name> — created on step 2.

    <path to dump> — created on step 1.

Step  3. Check

  1. Restart  IPmanager:

    /usr/local/mgr5/sbin/mgrctl -m ipmgr exit
    BASH
  2. Make sure that IPmanager and DNSmanager are up and running correctly.