Reinstall an Edge site
In Collibra 2024.05, we launched a new user interface (UI) for Collibra Data Intelligence Platform! You can learn more about this latest UI in the UI overview.
Use the following options to see the documentation in the latest UI or in the previous, classic UI:
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.
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 managed Kubernetes
Steps
- Back up your current Edge site. How to back up an Edge site...
On the server that runs your Edge site, run the following command:
Copy~$ 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
-
If you are reusing the same server as your old Edge site:
- Use the Edge tool command to uninstall the old installation.How to uninstall...Run the following Edge command from any location on the server Edge is installed on:
uninstall-edge.sh --remove-local-data
- Recreate the Linux disk mount for the
/var/lib/rancher/k3s
directory.How to mount...- Create
/var/lib/rancher/k3s
withmkdir -p /var/lib/rancher/k3s
- Mount the disk with "mount -a"
- Delete the contents with
rm -rf /var/lib/rancher/k3s/*
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. - Create
- Use the Edge tool command to uninstall the old installation.
- Redownload the installer.How to redownload...
- Go to the Edge site page in your Edge enviornment.
- Click ActionsSite Actions.
- Click Redownload Installer.
- Review and check the required acknowledgment checkbox.
- Click DownloadDownload Installer.
- 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.
- Extract the installer. How to extract the installer...Copy
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 asnoexec
, scripts and executable files will be prevented from being run within the directory.
- 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.
- Reinstall using the new installer with the backup option:Note Unified Data Classification is now the default classification method and is configured separately from the Edge site installation. This means Edge doesn't require additional setup for Unified Data Classification. You can use the deprecated data classification via Edge method until September 30.Deprecated data classification via Edge method…Copy
sudo install-master.sh
--storage-path /var/edge/storage properties.yaml r registries.yaml
--set collibra.classification.enabled=true
-b backup.yamlCopysudo sh install-master.sh
--storage-path /path/mounted/storage properties.yaml -r registries.yaml
-b backup.yaml- If you want to use a private docker registry, add the following parameters to the install command:
Parameters Description --registry-url
(required)The URL of your private docker registry.
For example:
https://edge-docker-delivery.repository.collibra.io
--registry-host
(optional)Where your private docker is hosted. If you do not specify this parameter, it is automatically derived from
--registry-url
For example:
edge-docker-delivery.my-registry.docker.io
--registry-user
(optional)The username of the private docker registry. This parameter is not required if registry is public. --registry-pass
(optional)The password of the private docker registry. This parameter is not required if registry is public. Show me an example…sudo sh install-master.sh --storage-path /var/edge/storage properties.yaml -r registries.yaml --registry-url https://private-docker.registry.com --registry-user user1 --registry-pass pass12
- If you want to use a private docker registry, add the following parameters to the install command:
You can reinstall your Edge site on a managed Kubernetes cluster by using the Edge CLI tool.
- AKS
- AWS Fargate using EKS
- EKS
- GKE
- OpenShift
Follow the steps below if you use a supported Kubernetes cluster.
Steps
- Back up your current Edge site. How to back up an Edge site...
On the server from which you manage your managed, dedicated kubernetes cluster, run the following command:
Copy~$ 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
- Redownload the installer and save it on your Linux server that has kubectl access to the k8s cluster.How to redownload...
- Go to the Edge site page in your Edge environment.
- Click ActionsSite Actions.
- Click Redownload Installer.
- Review and check the required acknowledgment checkbox.
- Click DownloadDownload Installer.
- 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.
- Extract the installer.How to extract the installer...Copy
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 asnoexec
, scripts and executable files will be prevented from being run within the directory.
-
Use the Edge uninstall command, depending on your Edge site installation method, to uninstall the old installation.
- If you installed your Edge site using the previous method, follow the path inside the extracted installer and run the following command: Copy
extracted installer>/resources/installer-job/tools/uninstall-edge-on-managed-k8s.sh
- If you installed your Edge site using the Edge CLI method, run one of the following command:
- If you installed your Edge site using the previous method, follow the path inside the extracted installer and run the following command:
- 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.
- Reinstall using the new installer and backup: Note
- You can install your Edge site with either terminal logging or terminal and file logging. Both options log the output of your Edge site installation.
- Terminal logging only saves the output to the Edge terminal.
- Terminal and file logging saves the output both to the terminal and a separate file. This file will be saved in the current directory with the naming format: edge-installer-$(date +"%Y-%m-%d_%H-%M-%S").log
- Unified Data Classification is now the default classification method and is configured separately from the Edge site installation. This means Edge doesn't require additional setup for Unified Data Classification. You can use the deprecated data classification via Edge method until September 30.
- With terminal logging…Copy
./edgecli install -b backup
- With terminal and file logging…Copy
./edgecli install -b backup 2>&1 | tee "edge-installer-$(date +"%Y-%m-%d_%H-%M-%S").log"
- If you want to use a private docker registry, add the following parameters to the install command:
Parameters Description --registry-url
(required)The URL of your private docker registry.
For example:
https://edge-docker-delivery.repository.collibra.io
--registry-host
(optional)Where your private docker is hosted. If you do not specify this parameter, it is automatically derived from
--registry-url
For example:
edge-docker-delivery.my-registry.docker.io
--registry-user
(optional)The username of the private docker registry. This parameter is not required if registry is public. --registry-pass
(optional)The password of the private docker registry. This parameter is not required if registry is public. Show me an example…- With terminal logging:
./edgecli install --registry-url https://private-docker.registry.com --registry-user user1 --registry-pass pass12 -b backup
- With terminal and file logging:
./edgecli install --registry-url https://private-docker.registry.com --registry-user user1 --registry-pass pass12 -b backup 2>&1 | tee "edge-installer-$(date +"%Y-%m-%d_%H-%M-%S").log"
- With terminal logging:
Warning Do not exclude-b backup.yaml
from this command. If you exclude-b backup.yaml
from the command, your Edge site will be reinstalled without your backup and previous configurations, such as passwords, encrypted text parameters, and any file parameters in each connection. Additionally, you will not be able to use that backup in any future reinstallations. - You can install your Edge site with either terminal logging or terminal and file logging. Both options log the output of your Edge site installation.