DNSmanager Documentation

How to install IPmanager and DNSmanager on the same server

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
     View details

    <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

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 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
     View details

    <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" {

    into

    view "<name space>" {
     View details

    <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>;
     View details

    <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→ EditIP address.

If you use PowerDNS:

  1. Create the PowerDNS database dump:

    mysqldump <database name> > <path to file>
     View details
    <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>
     View details

    <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>
     View details

    <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
  2. Make sure that IPmanager and DNSmanager are up and running correctly.