Install an Edge site

After you have created the Edge site in Collibra Data Intelligence Cloud, you have to install the Edge software on a server.

Tip

Every time you download an Edge site installer, the previously downloaded Edge site installer becomes outdated. If you use this outdated installer, the Edge site cannot communicate with Collibra.

Prerequisites

You have a global role with the Install Edge sites and the User Administration global permission, for example Edge site administrator
You have a global role that has the System administration global permission.
You have created an Edge site.
You have configured the forward proxy, if a forward proxy is required for Edge to connect to Collibra, Datadog, SignalFX and jFrog. Contact your network administrator if this is applicable.
Your server meets all system requirements.
Tip If you are an early adopter or you use Edge for beta testing purposes, we highly recommend to disable SELinux.

Steps

Download the installer:
1. Open an Edge site.
  1. In the main menu, click , then Settings.
    The Collibra settings page opens.
  2. Click Edge
    The Edge sites overview appears.
  3. In the Edge site overview, click the name of an Edge site.
    The Edge site page appears.
2. In the Installer and properties files section, click Download.
  Tip When you download the installer, an Edge user is automatically created in Collibra.
3. Depending on your operating system and browser, follow the regular steps for downloading files.
  The installer file is a TGZ archive that contains the files proxy.properties, properties.yaml and registries.yaml.
  Note If you download an installer, the previously downloaded Edge site installer becomes invalid.
Extract the TGZ archive on the server on which you are going to install the Edge site.
```
tar -xf <edge-site-id>-installer.tgz
```
Tip Keep the installer or the content of the extracted installer somewhere safe on your server. It contains various tools that you may need later, for example to troubleshoot issues.

Execute the installation.

Note If the Edge site has to connect via a forward HTTP proxy, then first configure the forward proxy before executing the installation.

Use Collibra certificates or use the proxy server's CA certificate, that is saved in the Edge site installer directory:

sudo sh install-master.sh --storage-path /path/mounted/storage properties.yaml -r registries.yaml

for example:

sudo sh install-master.sh --storage-path /var/edge/storage properties.yaml -r registries.yaml

Use a proxy server CA certificate, that is not saved in the Edge site installer directory:

sudo sh install-master.sh --storage-path /path/mounted/storage properties.yaml -r registries.yaml --ca /path/to/<proxy-server-ca-cert.pem file>

for example:

sudo sh install-master.sh --storage-path /var/edge/storage properties.yaml -r registries.yaml --ca /path/to/<proxy-server-ca-cert.pem file>

In the Edge sites overview, you can see the status of the installation.

Run the following commands to verify the status of the installation.
- To ensure that Kubernetes is running and that there is an existing node:
```
sudo /usr/local/bin/kubectl get nodes
```
- To ensure the state of the installation is either running or finished:
```
sudo /usr/local/bin/kubectl get pods --all-namespaces
```

Optionally, enable classification via Edge.

sudo /usr/local/bin/kubectl patch  --type=merge -n kube-system HelmChart edge-install -p '{"spec":{"set":{"collibra_edge.collibra.classification.enabled":"true"}}}'