This documentation applies to installation from a supported Marketplace. Please use the installation instructions provided with your deployment.
If you are installing or upgrading a Marketplace deployment, please use the available PDF content. You must use the install and configuration PDF available through the Marketplace listing.
This guide steps through the requirements and process for upgrading Trifacta® Wrangler from the Azure Marketplace.
Please complete the instructions in this section if you are upgrading from version 5.0 of Trifacta® Wrangler Enterprise .
NOTE: These instructions apply only to Trifacta® Wrangler Enterprise available through the Azure Marketplace.
Before You Begin
Before you upgrade, please do the following:
- Login as an admin to the application.
- From the left nav bar, select Settings > Admin Settings.
Locate the following parameter:
- Store the current value for safekeeping. It must be applied again to a new parameter after upgrade.
Upgrading your instance of Trifacta Wrangler Enterprise for Azure follows these basic steps:
- Back up the databases and configuration for your existing platform instance.
- Download the latest version of Trifacta Wrangler Enterprise
- Uninstall the existing version of Trifacta Wrangler Enterprise. Install the version you downloaded in the previous step.
- Upgrade the databases.
- Start up Trifacta Wrangler Enterprise. This step automatically upgrades the configurations.
- Within the application, perform required configuration updates in the upgraded instance.
Instructions for these steps are provided below.
Before you begin, you should backup your current instance.
- SSH to your current Marketplace instance.
Stop the Trifacta platform on your current Marketplace instance:
- Update the backup script with a more current version.
If you have not done so already, download 5.0.0 backup script from the following location:
Example command to download the script:NOTE: Below, some values are too long for a single line. Single lines that overflow to additional lines are marked with a
\. The backslash should not be included if the line is used as input.
Overwrite the downloaded script to the following location:
Verify that this script is executable:
Run the backup script:
When the script is complete, the output identifies the location of the backup. Example:
Store the backup in a safe location.
Download the latest version by using the command below:
wget 'https://trifactamarketplace.blob.core.windows.net/artifacts/trifacta-server-5.1.0m5-120~xenial_amd64.deb?sr=c&si=trifacta-deploy-public-read&sig=ksMPhDkLpJYPEXnRNp4vAdo6QQ9ulpP%2BM4Gsi/nea%2Bg%3D&sv=2016-05-31' -O trifacta-server-5.1.0m5-120~xenial_amd64.deb
Uninstall and install software
Uninstall old version
To uninstall older version of Trifacta® Wrangler Enterprise, execute as root user the following command on the Trifacta node:
Upgrade for Ubuntu 16.04 (Xenial)
Stop the platform:
Install the upgraded version. Below, PostgreSQL 9.6 is installed.
Upgrade the PostgreSQL 9.3 version to PostgreSQL 9.6, using the newly installed version:
NOTE: Below, some values are too long for a single line. Single lines that overflow to additional lines are marked with a
\. The backslash should not be included if the line is used as input.
Remove the old version of PostgreSQL (9.3):
Restart PostgreSQL and the platform:
Install new version
Install the latest version that was downloaded. Execute the following command as root:
Start up platform
To migrate the DBs and upgrade configs from the older version of Trifacta® Wrangler Enterprise to the latest version, the platform needs to be started. To start the Trifacta platform on the instance:
Change database ports
The database version is PostgreSQL 9.6, which uses a different port number than the previous version. You must verify that the platform is using the appropriate port number to access the databases.
- Login to the Trifacta node.
Edit the following file:
- Locate the listed database port number. Typically, this value is
- Close the file.
- To apply this configuration change, login as an administrator to the Trifacta node. Then, edit
trifacta-conf.json. Some of these settings may not be available through the Admin Settings Page. For more information, see Platform Configuration Methods.
Locate the following parameters, which define the port numbers used by each Trifacta database. The values below are the defaults but may be different:
NOTE: All databases should use the same port number.
The above values should be updated with the value from the
postgresql.conffile, if they differ.
Save and close the file.
Reconfigure use of Key Vault for WASB access
NOTE: This section applies only if you are upgrading Release 5.1 or later.
Beginning in Release 5.1, you can configure the platform to access WASB using configuration stored in the Trifacta configuration, including the SAS token.
In your pre-upgrade environment, if you enabled WASB access through a Key Vault, you must set the following property to
true. This property is new in Release 5.1 and defaults to
- You can apply this change through the Admin Settings Page (recommended) or
trifacta-conf.json. For more information, see Platform Configuration Methods.
Locate and set the following property to
Locate your saved value for
azure.wasb.defaultStore.sasTokenId. Set the following property to the saved value:
- Save your changes.
No other configuration is required to enable your previous WASB access.
Storage protocol wasb replaced by wasbs
NOTE: This section applies to upgrades to Release 5.1 and later.
Beginning in Release 5.1, the
wasb: storage protocol is no longer supported. All interactions with WASB are managed through
wasbs: at this point, using the SAS token that must be created for all environments using WASB as the base storage layer.
NOTE: If you created any External Datasources for a SQL DW connection using the
wasb: protocol before you upgraded, then you must recreate them using the
wasbs: protocol in your upgraded instance. See Create SQL DW Connections.
The upgrade is complete. To verify:
Restart the platform:
- Run a simple job with profiling.
- Verify that the job has successfully completed.
- In the Jobs page, locate the job results. See Jobs Page.
- Click View Details next to the job to review the profile.
You can access complete product documentation online and in PDF format. From within the product, select Help menu > Product Docs.
After you have accessed the documentation, the following topics are relevant to Azure deployments. Please review them in order.
|Supported Deployment Scenarios for Azure||Matrix of supported Azure components.|
Top-level configuration topic on integrating the platform with Azure.
Tip: You should review this page.
|Configure for HDInsight|
Review this section if you are integrating the Trifacta platform with a pre-existing HDI cluster.
|Enable ADLS Access||Configuration to enable access to ADLS.|
|Enable WASB Access||Configuration to enable access to WASB.|
|Configure SSO for Azure AD|
How to integrate the Trifacta platform with Azure Active Directory for Single Sign-On.
This page has no comments.