How to move DNSmanager between servers

You may need to move the panel and the license from one server to another when upgrading your hardware or when changing the license version. 

To do so:

1. Import user data from the old server to the new one.
2. Assign the software license to the new server. 

Step 1. Import user data

1. Before you start the import process,  activate a separate license for the new server. Follow the installation guide to install and activate a trial version. 
2. Import data to the new server. 

Import DNSmanager files

1. Install DNSmanager on a new server. Select the same name server as on the old server. 
2. Import the requires settings from the DNSmanager configuration file (the default location is /opt/ispsystem/dnsmanager6/etc/dnsmgr.conf) to the new server. Do not copy the whole configuration file from the old server into the new one. E.g., if the operating systems differ, the paths that are used in the configuration file will differ as well. 

3. Create a dump of the DNSmanager database on the old server:

   mysqldump dnsmgr > dump.sql

4. Copy the dump to the new server:

   scp root@<old server IP address>:<path to the file where the dump is stored> <path to the file to which the dump will be added>

5. Import the database from the dump on the new server:

   mysql dnsmgr < dump.sql

6. In the following databases change the IP address of the old server into the IP address of the new one:

   • the ips table. It corresponds to the control panel section Settings → IP-address pool → Addresses;
   • the ranges table. It corresponds to the control panel section Settings → IP-address pool;
   • the namespace table. 

Import files from the DNS server

1. Import the required settings from the PowerDNS configuration file to the new server:
   • CentOS: /etc/pdns/pdns.conf;
   • Ubuntu: /etc/powerdns/pdns.conf.
   Do not copy the whole configuration file: if operating systems on the servers differ, paths and access details to mysql will differ as well.
2.  Import the configuration files of the namespaces to the new server. 
   • CentOS: /etc/pdns/pdns-*.conf;
   • Ubuntu: /etc/powerdns/pdns-*.conf.
   Note

   The configuration files of the domain namespaces contain MySQL connection details: gmysql-user — username, gmysql-password — password. Change them into the new login and password for the new server.
3. Import the PowerDNS database to the new server: 

   1. Create a dump on the old server.

      mysqldump --databases <default name space> <user name space> > <path to the file to which the dump will be added>

      View details

      <default name space> — powerdns for CentOS, pdns for Ubuntu

      <user name space> — PowerDNS creates a separate database for every names space. Enter all the namespaces space separated

   2. Copy the dump to the new server.:

      scp root@<old server IP address>:<path to the file where the dump is stored> <path to the file to which the dump will be added>

   3. Upload the database from the dump on the new server.:

      mysql <database name> < <path to the file one the new server to which the dump is copied>

      View details

      <database name> — powerdns for CentOS, pdns for Ubuntu

Check

1. Restart DNSmanager on the new server:

   /opt/ispsystem/dnsmanager6/sbin/mgrctl -m dnsmgr exit

2. Restart the DNS-server:

   systemctl restart pdns

3. Make sure DNSmanager is up and running.

Configure slave name servers

In the configuration files change the IP address of the old server into the IP address of the new one: 

1. Define the required file:

   The configuration file on CentOS: /etc/pdns/pdns.conf

   The configuration file on Ubuntu: /etc/powerdns/pdns.conf

2. Execute the command:

   sed -i 's/\<<old server IP address>\>/<new server IP address>/g' <path to the configuration file>

   Note

   \<<old server IP address>\> means the IP address in the angle brackets. The brackets are escaped, e.g. "\<192.168.0.1\>".

Disable the DNS-server on the old server 

Disable the DNS-server on the old server and delete it from the auto-start: 

systemctl stop pdns
systemctl disable pdns

Step 2. Assign the license to the new server

1. After you have imported all the users to the new server, log in to the Client area where you ordered the license. 
2. Delete the trial license from the client area.
3. Open the configuration form of the commercial license and specify the IP address of the new server.
4. If you upgrade or change the product version you also need to change the tariff plan in the Client area. For more information about how to do so, please contact your license provider.

5. Update the license file. Go to  Help → About program → click on Update license. Or run the command to update it manually:

   /opt/ispsystem/dnsmanager6/sbin/licctl fetch dnsmgr