Region Domain Name Change

Virtuozzo Application Platform provides the ability to automatically add new domain names for regions via the admin panel. Go to the Regions section and select the needed one. Within the opened sub-section, switch to the Domains tab to see the list of attached domain names and manage them:

  • add domain
  • deactivate domain
  • change primary domain
  • manage domain SSL

region domains section

1. Click the Add button to attach a new domain name to the region. In the opened dialog, you need to specify:

  • Region – automatically set as the currently selected region
  • Domain – provide a new domain name for the region
  • Use as Primary – tick to change the primary domain to the current one immediately after addition (not recommended)

add region domain

Be aware of the specifics when adding a new domain:

  • Be patient, the process can take several minutes.
  • Added domains cannot be removed (only disabled) after the addition.
  • Check the result window for errors and resolve them (if any).

add domain log

Once a domain is added to the platform, all the existing environments in the region will be able to operate using this new domain (as well as all the previously existing domains). Also, all newly created environments and nodes will be provided with DNS records for all the domains. Any infrastructure applications in the region will also be accessible via the new domain.

2. You can Deactivate any non-primary domain with the appropriate button in the tools panel. After deactivation, the domain cannot be re-activated, so you need to confirm the action.

deactivate region domain

Once deactivated, new DNS records will not be generated for that domain. However, due to possible domain records in configurations and scripts, all the already existing records will remain indefinitely to ensure that internal communication within and between environments won’t be interrupted.

3. In order to change the primary domain of the region, select any active domain and click the Use as Primary button in the tools panel.

set as primary domain

After switching the primary, all the active domains will continue to work. However, the new primary domain will be used for:

  • internal communication between infrastructure components
  • reverse DNS zone
  • endpoint for internal infrastructure API calls
  • Zabbix checks
  • infrastructure containers hostnames
  • newly created user environment hostnames

4. You can manage SSL certificates for each active domain in the panel.

manage domain SSL

The process is the same as described for the region’s primary domain (follow the linked guide above).

What’s next?