Step 3. Install DataClarity

Before you install

• Ensure that you prepare a clean environment (VM) with no other 3rd party software installed.

• Ensure the system requirements for platform installation are met. For details, see System requirements.

  You can use a standalone script to verify the minimum “Proof of Concept” requirements for the environment. The script checks the minimum CPUs, RAM, free disk space, whether the needed ports are open, and that the required external repositories are accessible. The script must be run as root (superuser).

  Copy

  check.sh

  curl -O https://raw.githubusercontent.com/DataClarityCorp/distribution/main/system_check.sh

• Obtain the distribution file, <distribution>.tar.gz, provided by DataClarity.

• Obtain the license script provided by DataClarity.

• Prepare the domain name (hostname) or IP address to be used for the DataClarity platform.

• SSL: If you want to use the certificate for your domain, prepare the certificate and the key files (.crt, .key).

• We recommend that you update OpenSSL. Otherwise, you may get an error when running the install script. However, it does not impact the installation.

• Check firewall rules to ensure that ports 80, 443, and 5432 are open.

  Depending on your Linux distribution, choose the appropriate commands:

  Ubuntu

  Copy

  sudo ufw allow 80

  Copy

  sudo ufw allow 443

  Copy

  sudo ufw allow 5432

  Copy

  sudo iptables -P FORWARD ACCEPT

  Copy

  sudo apt-get install iptables-persistent

  Copy

  sudo ufw default allow routed

  Red Hat Enterprise Linux (RHEL)/CentOS

  Copy

  sudo firewall-cmd --zone=public --add-port=80/tcp --permanent

  Copy

  sudo firewall-cmd --zone=public --add-port=443/tcp --permanent

  Copy

  sudo firewall-cmd --zone=public --add-port=5432/tcp --permanent

  Copy

  sudo firewall-cmd --zone=public --add-masquerade --permanent

  Copy

  sudo firewall-cmd --reload

1. Download or copy over the distribution file provided by DataClarity, <distribution>.tar.gz.

   You may use the following command to download the file by inserting the URL to the file, for example:

   Copy

   curl -LO https://github.com/DataClarityCorp/distribution/raw/main/compose/free/dataclarity-free-latest.tar.gz

2. Unpack the tar file:

   Copy

   tar -zxf dataclarity-free-latest.tar.gz

3. From the distribution folder, execute the install script:

   Copy

   ./install.sh

   1. For Channel [production, beta], enter production to install the latest stable production version or beta to install the pre-release version.

   2. For Public entry point (ip address or domain name), specify your hostname/IP.

   3. For Setup SSL (Secure Sockets Layer), enter one of the following:

      • y — To enable HTTPS when accessing the platform via browser and SSL when connecting to Data Server.

        To use your custom certificate, place the certificate files (.key, .crt) in /distribution/template/assets/certs/.
        If no SSL certificate is provided, then the self-signed certificate will be generated.

      • n — To use HTTP when accessing the platform and no SSL when connecting to the Data Server by default.

   4. For Deploy to Docker now, enter y.

      Wait approximately 15 minutes (or more, depending on your internet connection) for the docker images to download and the containers to start.