How to Upgrade Central Server to Ubuntu 18.04 Using a Configuration Backup?


This document describes the steps required for migrating Central Server from an existing Ubuntu 14.04 LTS host to a new Ubuntu 18.04 LTS host. The migration is done taking a backup of the central server configuration on the Ubuntu 14.04 host and restoring the backup on the Ubuntu 18.04 LTS host. Please read carefully through the whole document and Central Server installation instructions before starting the upgrade process.

Preparation

Connecting a hardware security module (HSM) to a new server may require additional steps that are not covered by these instructions. Check the HSM documentation and verify that it supports Ubuntu 18.04.

  • Ensure that the current central server's software is updated to version 6.20.0/1 or 6.21.0.
  • Review the Central Server Installation Guide.
  • If you are upgrading a cluster, review the Central Server High Availability Installation Guide
  • On the current server, use the admin UI to take a backup of the central server configuration and download it to a safe location.

    • Note that the backup does not include X-Road admin user account(s).
    • In a clustered setup, take a configuration backup from each node.
  • Prepare to update your network configuration.
    •  After the upgrade, you may need to change the upgraded server's IP address(es) to match the old addresses and/or update DNS,  firewall, NAT, or other network configuration so that security servers and configuration proxies can reach the upgraded server.
    • The exact steps depend on your network setup and are not covered in this guide.

Upgrade process

Clustered central server:

  • You need to setup a new cluster (see the Central Server High Availability Installation Guide for instructions)
  • To restore the backups, follow the recovery instructions in the installation guide.
  • Verify that the central server services are running and the system is functioning.

  • Switch over to the new servers
    • e.g. change the new server's IP address(es) to match the old addresses and/or update DNS,  firewall, NAT, or other network configuration.
      • If the new cluster needs to use the old IP addresses, stop the old servers before changing the addresses.
    • Update the PostgreSQL cluster configuration (see Changing Nodes' IP Addresses in HA Cluster in the installation guide) if the IP addresses used by the database change.

Stand-alone central server:

  • Do a clean install of central server software version 6.20.0/1 or 6.21.0 (N.B.! must be the same version from which the backup was taken) on Ubuntu 18.04 (see the X-Road Central Server Installation Guide)
  • Restore the central server configuration from the backup
  • Verify that the central server services are running and the system is functioning.

  • Switch over to the new server
    •  e.g. change the new server's IP address(es) to match the old addresses and/or update DNS,  firewall, NAT, or other network configuration.