Migration Process

To migrate the AppViewX Server from CentOS to another supported operating system, you can create a backup of your server running CentOS and restore it on the new server with the supported OS. However, it is important to ensure that the data is compatible for restoration. To successfully complete the migration, please follow the appropriate instructions.
  1. To ensure compatibility for data restoration on the new server, it is necessary to upgrade your existing server.
    1. Upgrade your existing server to either 2020.3.0 FP10 or 2022.1.0 (Ganga) FP3 if you are currently using a lower version. This upgrade will make your data compatible for restoration on the new server.
    2. If you are already using 2020.3.0 FP11, there is no need to upgrade your existing server as it is already compatible with the data restoration process on the new server.
  2. Take a backup of your existing AppViewX installation which is running in CentOS. Refer section below - Taking Backups from the Existing AppViewX Environment
  3. Install the new server with RHEL/Ubuntu operating system.
    1. You have the option to download either the 2020.3.0 FP10 or 2022.1.0 (Ganga) FP3 installer from the release portal and proceed with the installation. Make sure to select the version that is compatible with your current server version.
    2. In case you have taken a backup from 2020.3.0 FP11, you can install 2020.3.0 FP10 first and then upgrade to 2020.3.0 FP11 to ensure compatibility.
  4. Restore the backed up data on the system with the newly installed OS. Refer section below - Restoring the Backups

Upgrading the Existing Server for Compatibility

To ensure a successful migration of the AppViewX Server from CentOS to another supported operating system, it is important to have both the existing server and the new server running the same version. This is crucial for a smooth migration process. The AppViewX installer supports two versions:
  • 2020.3.0 FP10
  • 2022.1.0 FP3
This gives you the flexibility to install the new server with either versions. If your existing server is not compatible with these specified versions, you will need to upgrade your current server to make it compatible with either 2020.3.0 FP10 or 2022.1.0 FP3, depending on the version you have chosen for the new server installation.

However, if your existing server is already running version 2020.3.0 FP11, you can directly upgrade the new server from 2020.3.0 FP10 to 2020.3.0 FP11 before restoring it. This ensures compatibility for the migration process, hence you can skip this step for now.

Refer these guides for upgrading AppViewX

  1. 2020.3.0 Upgrade Guide - Documentation (appviewx.com)
  2. 2022.1.0 Upgrade Guide - Documentation (appviewx.com)

Taking Backups from the Existing AppViewX Environment

For an AppViewX 2020.3.0 and above setup (Kubernetes-based)

  1. Navigate to installer node’s scripts directory - <appviewx_installer_location>/appviewx_kubernetes/scripts/
  2. Initiate a backup of the AppViewX Database using the following command 
    ./mongo_backup.sh
    After the backup is taken successfully, the database's backup file and its location are displayed on the screen.
    Note: Copy this backup file to a safe location for future reference.
  3. Initiate a backup of the Secrets Vault using the command 
    ./vault_backup.sh
    After the backup is taken successfully, the database's backup file and its location are displayed on the screen.
    Note: Copy this backup file to a safe location for future reference.

For a Legacy Setup

If you have a Legacy Setup, execute the following command. 
appviewx --databasebackup

Installing the New Server

If you have completed the backup process, proceed to install the new server with the chosen version on the supported operating system.

  1. Choose the preferred OS or OVA from the supported list.
    1. RHEL 8 (8.6, 8.7)
    2. Ubuntu 20.04 LTS
    3. Ubuntu OVA (with Ubuntu 20.04 LTS)
  2. Once you have decided on the OS or OVA, install the AppViewX server by following the steps below:
    1. Install 2022.1.3 (Ganga FP3) with OVA - Click here
    2. Install 2020.3.0 FP10 or 2022.1.3 (Ganga FP3) with installer - Click here

Restoring the Backups

Now, you can proceed to restore the backup on the new server. Please note that if you took the backup from 2020.3.0 FP11 and installed 2020.3.0 FP10 on the new server, you must upgrade the new server to 2020.3.0 FP11 by following these steps to ensure compatibility.

For an AppViewX 2020.3.0 and above setup (Kubernetes-based)

Follow the steps below to restore data to your new environment.
Note: The following steps assume you have installed the same AppViewX version as you are OR were previously running. For example – AppViewX 2020.3.10 (20.3 FP10)
  1. Copy the backed up file(s), from the step 2, to the new environment’s installer node.
  2. Navigate to the installer location’s scripts directory - <appviewx_installer_location>/appviewx_kubernetes/scripts/
  3. Restore the database through triggering database restoration script by using the following command: 
    ./mongo_restore.sh <location of mongo backup file>
    Example: 
    ./mongo_restore.sh /home/appviewx/mongo_backup/mongo_backup_Fri_Jul_7_10_14_12_IST_2023.tar.gz
  4. Wait for the successful completion message.
  5. Restore the Secrets Vault through triggering the vault restoration script by using the following command: 
    /vault_restore.sh -p <location of vault backup file>
    Example: 
    ./vault_restore.sh -p /home/appviewx/vault_backup/vault_backup_Wed_Jul_28_05_50_40_UTC_2021

For a Legacy Setup

If you have a Legacy Setup, execute the following command. 
appviewx --databaserestore /path/of/backup_file
Example: 
appviewx --databaserestore /home/appviewx/mongo_backup/mongo_backup_Fri_Jul_7_10_14_12_IST_2023.tar.gz