Reinstall an Edge site

You always reinstall an Edge site by restoring a backup of that Edge site. Reinstallation may be necessary to resolve an issue or to upgrade the software included in the Edge site installer.

Warning If you have any existing connections, we highly recommend backing up your site and reinstalling the site from the backup. If you do not use a backup, you will need to manually re-enter passwords, encrypted text parameters, and any file parameters in each connection to restore full functionality.

Note This process is certified for restoring an Edge site to the Collibra environment on which the site was originally created, for example, restoring Development to Development or Production to Production. The process is not certified or tested for promoting an Edge site migration from one environment to another, for example, from Development to Production. These types of migrations require the reinstallation of the Edge application each time the migration is promoted.

  • Reinstall an Edge site on K3S
  • Reinstall an Edge site on EKS
  1. Back up your current Edge site.

    On the server that runs your Edge site, execute the following command:

    ~$ edge backup -o /<path to folder where you want to save the backup file>/<backup-name>.yaml

    Edge creates a backup of your Edge site in the selected folder of the command.

    Important If the Edge command is not available, you will need to download the Edge tool and make it available in /usr/local/bin/edge

  2. If you are reusing the same server as your old Edge site:
    1. Uninstall the old installation.
      Run the following Edge command from any location on the server Edge is installed on: uninstall-edge.sh
    2. Recreate the Linux disk mount for the /var/lib/rancher/k3s directory.
      mkdir -p /var/lib/rancher/k3s
mkfs.xfs /dev/<block-device-name>
mount /dev/<block-device-name> /var/lib/rancher/k3s
echo '/dev/<block-device-name> /var/lib/rancher/k3s xfs defaults 0 0' >> /etc/fstab
      Note This is the default installation path. If it is not created as a separate mount point after following the steps above, the installation will use 50 GB of disk space from either /var, or if not present, the root level of the drive.
  3. Redownload the installer.
    1. Go to the Edge site page in your Edge enviornment.
    2. Click Actions.
    3. Click Redownload installer.
    4. Click Download.
    5. Save the new installer to your server where the old installer was saved.

    Note This is a new installer for your Edge site. The previous installer will no longer work.

  4. Extract the installer. 
    tar -xf <edge-site-id>-installer.tgz
    Note 
    • Keep the installer or the contents of the extracted installer in a secure location on your server. These contents contain various tools that you may need later, for example to troubleshoot issues.
    • If you want to run a script or executable file from the extracted directory, ensure that the directory is not mounted as noexec. If a directory is mounted as noexec, scripts and executable files will be prevented from being run within the directory.
  5. If you use a custom setup, such as proxy.properties and ca.pem for forward proxies or classification, ensure that it is available or included as it was in the previous setup.
  6. Reinstall using the new installer with the backup option: ./install-master.sh --storage-path <storagepath> -b backup.yaml
    • If you originally installed your Edge site with classification, you must reinstall with classification: ./install-master.sh --storage-path <storagepath> -b backup.yaml --set collibra_edge.collibra.classification.enabled=true
  1. Back up your current Edge site.

    On the server from which you manage your EKS cluster, execute the following command:

    ~$ edge backup -o /<path to folder where you want to save the backup file>/<backup-name>.yaml

    Edge creates a backup of your Edge site in the defined folder of the last command.

    Important If the Edge command is not available, you will need to download the Edge tool and make it available in /usr/local/bin/edge

  2. Redownload the installer and save it on your Linux server that has kubectl access to the k8s cluster.
    1. Go to the Edge site page in your Edge environment.
    2. Click Actions.
    3. Click Redownload installer.
    4. Click Download.
    5. Save the new installer to your server where the old installer was saved.

    Note This is a new installer for your Edge site. The previous installer no longer works.

  3. Extract the installer.
    tar -xf <edge-site-id>-installer.tgz
    Note 
    • Keep the installer or the contents of the extracted installer in a secure location on your server. These contents contain various tools that you may need later, for example to troubleshoot issues.
    • If you want to run a script or executable file from the extracted directory, ensure that the directory is not mounted as noexec. If a directory is mounted as noexec, scripts and executable files will be prevented from being run within the directory.
  4. Uninstall the previous Edge site installation.
    Follow the path inside the extracted installer and run the uninstall command. Example: <extracted installer>/resources/installer-job/tools/uninstall-edge-on-managed-k8s.sh
  5. If you use a custom setup, such as proxy.properties and ca.pem for forward proxies or classification, ensure that it is available or included as it was in the previous setup.
  6. Reinstall using the new installer and backup: ./run-installer-job.sh properties.yaml -b backup.yaml 
    • Optionally, with classification: -b backup.yaml --set collibra_edge.collibra.classification.enabled=true