Skip to content

Updating to a specific release

We advise that customers always update to the latest version of Matillion ETL, but in some cases you may wish to update to a specific earlier release. Updating to the latest version is the default assumption described in Updating and migrating overview. Updating to specific earlier releases requires some different considerations, which will be described below. If you are upgrading to the most recent release, you can disregard this article.

There are three possible scenarios for updating between specific releases, and each requires a different process. Select the scenario which applies to you:

For interim releases, you can only update to the most recent interim release pertaining to a specific major release.

Note

Always backup your instance before performing any updates.

You should contact support before making any updating decision, to ensure that it is correct for you.

Note

If you choose to downgrade, make sure to take snapshots and have backups to fall back to.

Run yum downgrade matillion-universal-1.68.12-1 matillion-emerald-cdata-1.68.12-1 replacing the version numbers here as appropriate.


Updating from version 1.60 or later

Note

You may need to ensure that the following URL is allow listed first:

artifacts.matillion.com
  1. Check the version of your Matillion ETL instance by issuing the following command from an SSH session as root:

    yum list installed matillion*
    

    The following package should appear:

    matillion-universal.noarch
    
  2. Check package availability with this command:

    yum list available matillion-universal --showduplicates
    
  3. To upgrade to a specific version, by default choose the latest point release inside the 1.x version. For example, you might choose matillion-universal.noarch 1.64.11-1.

  4. Using the above example, you would then stop the Tomcat service and install your selected version, like so:

    systemctl stop tomcat
    yum update matillion-universal-1.64.11-1
    

    Tomcat8:

    systemctl stop tomcat8
    yum update matillion-universal-1.64.11-1
    
  5. Finally, restart the Tomcat service:

    systemctl start tomcat
    

    Tomcat8:

    systemctl start tomcat8
    

Updating from a version pre-1.60 to version 1.60 or later

  1. Check the version of your Matillion ETL instance by issuing the following command from an SSH session as root:

    yum list installed matillion*
    

    You should see two packages:

    matillion-emerald.noarch
    matillion-emerald-cdata.noarch
    
  2. Use the yum swap command to allow updating to version 1.60 or newer. There are two forms of this command.

    If you don't have a BYOL (Bring Your Own Licence) version of Matillion ETL, use:

    yum swap matillion-emerald matillion-universal-1.64.8-1
    

    If you do have a BYOL version of Matillion ETL, use:

    yum swap matillion-emerald-byol matillion-universal-1.64.8-1
    
  3. Check package availability with this command:

    yum list available matillion-universal --showduplicates
    
  4. To upgrade to a specific version, by default choose the latest point release inside the 1.x version. For example, you might choose matillion-universal.noarch 1.64.11-1.

  5. Using the above example, you would then stop the Tomcat service and install your selected version, like so:

    service tomcat stop
    yum update matillion-universal-1.64.11-1
    
  6. Finally, restart the Tomcat service:

    service tomcat start
    

Updating from a version pre-1.60 to another version pre-1.60

  1. Check the version of your Matillion ETL instance by issuing the following command from an SSH session as root:

    yum list installed matillion*
    

    You should see two packages:

    matillion-emerald.noarch
    matillion-emerald-cdata.noarch
    
  2. Check package availability with these commands:

    yum list available matillion-universal --showduplicates
    yum list available matillion-emerald-cdata --showduplicates
    
  3. To upgrade to a specific version, by default choose the latest point release inside the 1.x version. You must keep the 1.x the same for both packages. For example, you might choose:

    matillion-emerald.noarch 1.58.6-1
    matillion-emerald-cdata.noarch 1.58.6-1
    
  4. Using the above example, you could then stop the Tomcat service and install your selected version, like so:

    service tomcat stop
    yum update matillion-emerald-1.58.6-1
    yum update matillion-emerald-cdata-1.58.6-1
    
  5. Finally, restart the Tomcat service:

    service tomcat start