Contents x
Installing Matillion ETL using the Universal Installer (RPM install)
  • Dark
    Light
Contents

Installing Matillion ETL using the Universal Installer (RPM install)

  • Dark
    Light

Overview

Customers installing Matillion ETL via the Matillion Hub and the "bring your own license" (BYOL) method must download the correct configuration files for their environment, and then download and execute a single install script, as described below.

This article replaces the detailed instructions given in the article Installing Matillion ETL from RPMs with a process that uses a pre-packaged script, to make the installation quicker and simpler to perform.

Note
  • To use this build process, all RPM build actions must be run as a root user on the virtual machine (VM) that the installation is being executed on.
  • The RPM installation method only applies to Matillion Hub customers and bring your own license (BYOL) customers. AWS customers who launch Matillion ETL via the original marketplace method can only install Matillion ETL on their golden AMI, via Private Image Build. Please submit a case at the Matillion Support Portal if you require further assistance with this.
  • New customers are advised to go through the Matillion Hub to select their preferred cloud provider and data warehouse to begin their Matillion ETL journey. For further information, read Matillion Hub - Instance Creation.
  • To update Matillion ETL to a specific version, refer to Updating - Specific Releases.

Download the configuration files

There are two configuration files needed for the installation of Matillion ETL:

  • installation.vars — is used to tell your environment how Matillion ETL will be installed.
  • Emerald.properties — is used to define the product you want to install. There are several versions of this file, one for each possible product variant. You will need to choose the file that matches your requirements.

To download the installation.vars file, run the following command:

curl https://bitbucket.org/matillion/matillion-etl-system-configuration/raw/stable/example-config/installation.vars > /tmp/installation.vars

To download the correct Emerald.properties file:

  1. In a browser, go to https://bitbucket.org/matillion/matillion-etl-system-configuration/src/stable/example-config/. This will show you a list of Emerald.properties files.
  2. The filename suffix will identify which product variant the properties file is for. For example, Emerald.properties-AWS-SF-HUB is the properties file for Snowflake (SF) on AWS, for Hub licensing. Identify which file you need and copy or make a note of the filename for use in the following command.
  3. Download the correct Emerald.properties file into the /tmp directory using the following command:
curl https://bitbucket.org/matillion/matillion-etl-system-configuration/raw/stable/example-config/[filename] > /tmp/Emerald.properties

Where filename is the name you determined in step 2. For example, to install Matillion ETL for Snowflake on AWS using Hub licensing, the command is:

curl https://bitbucket.org/matillion/matillion-etl-system-configuration/raw/stable/example-config/Emerald.properties-AWS-SF-HUB > /tmp/Emerald.properties

Execute the install script

  1. Login with administrator privileges (root):
sudo -i
  1. Run the following command to download the latest install script:
curl https://bitbucket.org/matillion/matillion-etl-system-configuration/raw/stable/orchestrate-install.sh > /tmp/orchestrate-install.sh
  1. Change the script permissions as follows:
chmod a+x /tmp/orchestrate-install.sh
  1. Run the script as follows:
/bin/bash /tmp/orchestrate-install.sh /tmp/installation.vars
  1. After a successful install, restart your Matillion ETL instance by running the following command:
reboot
Note
What's Next

Cookie consent

We use our own and third-party cookies to understand how you interact with our knowledge base. This helps us show you more relevant content based on your browsing and navigation history.