Migrate domains from DNS hosting (legacy) to Selectel DNS hosting (actual)

warning

We have released a new version of DNS hosting (actual) and are gradually disabling the legacy version (legacy) according to the migration stages.

Migrate domains to DNS hosting (actual) now to avoid site downtime when DNS hosting (legacy) is discontinued.

If you registered after January 30, 2024, only DNS hosting (actual) is available to you.

Domain migration occurs without DNS downtime. You create a copy of the data from DNS hosting (legacy) in DNS hosting (actual) and then delegate record management to the authoritative servers of DNS hosting (actual). The migration may take up to 72 hours; during this time, records will continue to be served by the authoritative servers of DNS hosting (legacy).

If a domain in DNS hosting (legacy) only has NS and SOA records, it will not be migrated to DNS hosting (actual). If you need to migrate such a domain, you must add it via the control panel.

All domains from DNS hosting (legacy) are migrated to one project.

You can migrate domains:

via the control panel;
via octoDNS.

After migration to DNS hosting (actual), you can transfer the domain zone to another project.

Migrate domains via the control panel

Migrate the data.
Delegate the domain to DNS hosting (actual).

1. Migrate data

In the control panel, on the top menu, click Products and select DNS hosting Legacy.
Click Copy zones to DNSv2.
Select the project to which you need to migrate the zones.
Click Copy. When the window closes, the migration will be complete.
To check the migration result, on the top menu, click Products and select DNS hosting.
Ensure you are in the project to which you migrated the data.
Check that the migrated domains appear in the zones list, and that the migrated domain records appear on each zone's page.

Resource records of the same type are displayed as a group of records. NS and SOA resource records are not migrated; they will be automatically created in DNS hosting (actual) with default values that cannot be edited:
- NS — a.ns.selectel.ru., b.ns.selectel.ru., c.ns.selectel.ru., d.ns.selectel.ru.
- SOA — a.ns.selectel.ru. support.selectel.ru. <zone_serial_number> 10800 3600 604800 60, where <zone_serial_number> is the zone serial number, which changes when the zone is updated and signals to caching servers that the records need to be re-cached.
If data was migrated incorrectly or incompletely, create a ticket.

2. Delegate domain to DNS hosting (actual)

If you migrated multiple domains, you must delegate each one.

Go to the control panel of the domain registrar where your domain is registered.
In the NS records, replace the values with the NS servers of DNS hosting (actual): a.ns.selectel.ru, b.ns.selectel.ru, c.ns.selectel.ru, d.ns.selectel.ru. Specify each server in a separate record.
Wait for the migrated resource records to propagate to the DNS servers. Record propagation may take up to 72 hours; during this time, records will continue to be served from the authoritative servers of DNS hosting (legacy): ns1.selectel.ru, ns2.selectel.ru, ns3.selectel.ru, ns4.selectel.ru.
Optional: check the records on the authoritative servers.

Migrate domains via octoDNS

Install octoDNS.
Migrate data.
Delegate the domain to DNS hosting (actual).

1. Install octoDNS

Install Python 3, virtualenv, and pip3:

Linux
macOS

sudo apt-get update
sudo apt-get install python3 virtualenv
sudo apt-get install python3-pip

Create a directory for octoDNS:
```
mkdir ~/octodns
```
Go to the ~/octodns: directory:
```
cd ~/octodns
```
Create a virtual environment for octoDNS:
```
virtualenv env
```
Activate the virtual environment:
```
source env/bin/activate
```
Install octoDNS in the virtual environment:
```
pip3 install octodns
```
Check that the package was installed correctly:
```
octodns-sync --version
```
The response will show the installed octoDNS version, for example:
```
octoDNS 1.4.0
```
Install the Selectel provider for octoDNS:
```
pip3 install octodns_selectel
```
Check that the Selectel provider was installed correctly:
```
pip3 list | grep octodns-selectel
```
The response will show the installed provider version, for example:
```
octodns_selectel 0.99.1
```
The minimum version of the Selectel provider for migration is 0.99.1.

2. Migrate data

Go to the ~/octodns: directory:
```
cd ~/octodns
```
Create a migration_config.yaml: file:
```
nano migration_config.yaml
```

Copy the contents into the file:

---
processors:
  no-root-ns:
    class: octodns.processor.filter.IgnoreRootNsFilter

providers:
  selectel_legacy:
    class: octodns_selectel.SelectelProviderLegacy
    token: <x_token>
  selectel:
    class: octodns_selectel.SelectelProvider
    token: <x_auth_token>

zones:
    <example.com.>:
        sources:
        - selectel_legacy
        processors:
        - no-root-ns
        targets:
        - selectel

Specify:

<x_token> — static token (X-Token);
<x_auth_token> — IAM token for the project to which you want to migrate data;
<example.com.> — domain name as it appears in DNS hosting (legacy), with a trailing dot. To migrate all domains, specify "*" without a dot instead of the domain name.

Start the migration:

octodns-sync --config-file=migration_config.yaml --doit

In the control panel, on the top menu, click Products and select DNS hosting.
Ensure you are in the project to which you migrated the data.
Check that the migrated domains appear in the zones list, and that the migrated domain records appear on each zone's page.

Resource records of the same type are displayed as a group of records. NS and SOA resource records are not migrated; they will be automatically created in DNS hosting (actual) with default values:
- NS — a.ns.selectel.ru., b.ns.selectel.ru., c.ns.selectel.ru., d.ns.selectel.ru.
- SOA — a.ns.selectel.ru. support.selectel.ru. <zone_serial_number> 10800 3600 604800 60, where <zone_serial_number> is the zone serial number, which changes when the zone is updated and signals to caching servers that the records need to be re-cached.
If data was migrated incorrectly or incompletely, create a ticket.

3. Delegate domain to DNS hosting (actual)

If you migrated multiple domains, you must delegate each one.

Go to the control panel of the domain registrar where your domain is registered.
In the NS records, replace the values with the NS servers of DNS hosting (actual): a.ns.selectel.ru, b.ns.selectel.ru, c.ns.selectel.ru, d.ns.selectel.ru. Specify each server in a separate record.
Wait for the migrated resource records to propagate to the DNS servers. Record propagation may take up to 72 hours; during this time, records will continue to be served from the authoritative servers of DNS hosting (legacy): ns1.selectel.ru, ns2.selectel.ru, ns3.selectel.ru, ns4.selectel.ru.
Optional: check the records on the authoritative servers.