Please complete the instructions in this section if you are upgrading from version 5.0 of
Before you upgrade, please do the following:
Steps:
- Login as an admin to the application.
- From the left nav bar, select Settings > Admin Settings.
Locate the following parameter:
Code Block |
---|
azure.wasb.defaultStore.sasTokenId |
- Store the current value for safekeeping. It must be applied again to a new parameter after upgrade.
Upgrading your instance of
for Azure follows these basic steps:
- Back up the databases and configuration for your existing platform instance.
- Download the latest version of
- Uninstall the existing version of . Install the version you downloaded in the previous step.
- Upgrade the databases.
- Start up . 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
on your current Marketplace instance: Code Block |
---|
sudo service trifacta stop |
- 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:
Code Block |
---|
https://raw.githubusercontent.com/trifacta/trifacta-utils/release/5.0/azure/trifacta-backup-config-and-db.sh
Example command to download the script:
Code Block |
---|
curl --output trifacta-backup-config-and-db.sh \
https://raw.githubusercontent.com/trifacta/trifacta-utils/release/5.0/azure/trifacta-backup-config-and-db.sh |
Overwrite the downloaded script to the following location:
Code Block |
---|
/opt/trifacta/bin/setup-utils/trifacta-backup-config-and-db.sh |
Verify that this script is executable:
Code Block |
---|
sudo chmod 775 /opt/trifacta/bin/setup-utils/trifacta-backup-config-and-db.sh |
Run the backup script:
Code Block |
---|
sudo /opt/trifacta/bin/setup-utils/trifacta-backup-config-and-db.sh |
- /
When the script is complete, the output identifies the location of the backup. Example:
Code Block |
---|
opt/trifacta-backups/trifacta-backup-5.0.0+110.20180615100731.e4ded4d-20181211213601.tgz
Store the backup in a safe location.
Download the latest version by using the command below
code:
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
To uninstall older version of
, execute as root user the following command on the
:
Code Block |
---|
apt-get remove trifacta |
Upgrade supervisor
package:
Code Block |
---|
apt-get install supervisor=3.2.4 |
Excerpt Include |
---|
| Upgrade the Databases |
---|
| Upgrade the Databases |
---|
nopanel | true |
---|
|
Install the latest version that was downloaded. Execute the following command as root:
Code Block |
---|
dpkg -i <location of the 5.1 deb file> |
To migrate the DBs and upgrade configs from the older version of
to the latest version, the platform needs to be started. To start the
on the instance:
Code Block |
---|
service trifacta start |
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.
Steps:
- Login to the .
Edit the following file:
Code Block |
---|
/etc/postgresql/9.6/main/postgresql.conf |
- Locate the listed database port number. Typically, this value is
5433
. - Close the file.
Locate the following parameters, which define the port numbers used by each
. The values below are the defaults but may be different: Info |
---|
NOTE: All databases should use the same port number. |
Code Block |
---|
"webapp.db.port" = 5433;
...
"batch-job-runner.db.port" = 5433;
...
"scheduling-service.database.port" = 5433;
...
"time-based-trigger-service.database.port" = 5433; |
The above values should be updated with the value from the postgresql.conf
file, if they differ.
Save and close the file.
Info |
---|
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
, 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 false
.
Steps:
Locate and set the following property to true
:
Code Block |
---|
"azure.wasb.fetchSasTokensFromKeyVault": true |
Locate your saved value for azure.wasb.defaultStore.sasTokenId
. Set the following property to the saved value:
Code Block |
---|
"azure.wasb.defaultStore.keyVaultSasTokenSecretName" |
- Save your changes.
No other configuration is required to enable your previous WASB access.
Info |
---|
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.
Info |
---|
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:
Steps:
Restart the platform:
Code Block |
---|
sudo service trifacta start |
- 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.