Installing Contiamo

The Contiamo platform is available through the Azure and AWS marketplaces, as a standalone solution (for testing and evaluation purposes only), and as a clustered deployment.

On Premise

  • Download and run our install script

** The script cannot be run under the root user.

** The script should be run by a user that has sudo access.

wget https://contiamo-public.s3.eu-central-1.amazonaws.com/install-from-scratch/install-preview.sh && chmod +x install-preview.sh
./install-preview.sh "companyname" "admin@admin.com" "password"

or

curl -sfL https://contiamo-public.s3.eu-central-1.amazonaws.com/install-from-scratch/install-preview.sh | bash -s -- "companyname" "admin@admin.com" "password"

Important:

Your company name must be at least 4 characters long and can not contain spaces or special characters.

Make sure to set your organization name, email, and password

  • Navigate to the ip of the host machine, if this is your laptop, this can be http://localhost

  • Login with the credentials you set in step 1.

Airgapped Environments (Servers with no Internet access)

Contiamo Datahub can be installed on a server with no Internet access.

Deploying to an Airgapped Server

  1. Upload the downloaded files to the airgapped server.

Important:

  • The files should be placed in the home directory of your OS user.

  • Your OS user MUST have full SUDO access for the duration of the installation.

  • Sudo privileges can be removed for the user after the installation is completed, except for allowing the following:

RedHat/CentOS:

sudo systemctl restart k3s.service

or Ubuntu:

sudo service k3s restart

In order to allow specific commands for your user do the following:

  • Run visudo as root.

  • Add the following line:

yourusername ALL=(ALL) NOPASSWD: /full/path/to/systemctl restart k3s.service

The path to the systemctl and service depends on the OS. To find the path suitable for your environment run which systemctl.

  1. SSH to your airgapped server.

  2. Run the installation script you downloaded:

./install-preview.sh "yourcompany" "admin@admin.com" "your_password"

Operating systems the installation has been tested on:

  1. RHEL 8, 7.8

  2. Ubuntu LTS 20.04, 18.04 and 16.04

  3. CentOS 8

Amazon Web Services (AWS)

  1. Review the usage details and then click “Continue to Subscribe”

  2. Usage Instructions:

    • Launch the AMI, making sure that the instance is accessible via HTTP (port 80).

    • The Platform might take up to 5 minutes to get initialised.

    • Navigate to the instance public or private IP (depending on your network setup).

    • You will be presented with a registration page. Enter your project or your company name (this will personalise the Datahub for you).

    • Wait for the platform to initialise.

    • When the platform in initialised you will be presented with a login screen. Use admin@admin.admin as your username and the AWS instance ID as the password.

Azure

  1. Review the usage details and then click “Create”

  2. Usage Instructions:

    • Launch the VM image, making sure that the instance is accessible via HTTP (port 80).

    • The Platform might take up to 5 minutes to get initialised.

    • Navigate to the instance public or private IP (depending on your network setup).

    • You will be presented with a registration page. Enter your project or your company name (this will personalise the Datahub for you).

    • Wait for the platform to initialise.

    • When the platform in initialised you will be presented with a login screen. Use admin@admin.admin as your username and your Azure Subscription ID as the password.

Clustered Environment

Contact us to get instructions for how Contiamo can be deployed in a Kubernetes cluster.