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 invalid.

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 outbound proxy, if necessary.
Your server meets the system requirements.
Tip If you are an early adopter or you use Edge for beta testing purposes, we highly recommend to disable SELinux.

On the server, you have mounted dedicated storage for the Edge sites:

mkdir -p /var/lib/rancher/k3s/storage
mkfs.xfs /dev/<block-device-name>
mount /dev/<block-device-name> /var/lib/rancher/k3s/storage
echo '/dev/<block-device-name> /var/lib/rancher/k3s/storage xfs defaults 0 0' >> /etc/fstab

Note Change <block-device-name> to the name of the device that contains the storage.

If you use the default CentOS 7 software, you have to run the following commands to add the cni0 and loopback interfaces to a trusted zone, so that Kubernetes can use it between its' services:
```
firewall-cmd --zone=trusted --change-interface=cni0 --permanent
firewall-cmd --zone=trusted --change-interface=lo --permanent
firewall-cmd --reload
```

Steps

Download the installer:
1. Open an Edge site.
  1. In the main menu, click , then Settings.
    The System tab page appears.
  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-intaller>.tgz
```
Execute the installation.

Note If the Edge site has to connect via an outbound HTTP proxy, then first configure the outbound proxy before executing the installation.
```
sudo sh install-master.sh --storage-path <path> properties.yaml -r registries.yaml
```
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"}}}'