Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Table of Contents

Standard upgrade

Before upgrading to the new version please backup your current config.yml and default.yml (or any other sites you may have configured) files as well as the database driver.

To upgrade, please download the twbe.war file from the Support and Resources page and follow these steps:

  1. Back-up, as stated above, of the configuration files and database driver
  2. (recommended) Rename the war file to be just twbe.war (without the version)
  3. Stop Write-Back Server service
  4. Go to <installation_path>\apache-tomcat\webapps\
  5. Delete twbe from webapps
  6. Now copy the new twbe.war to the webapps folder
  7. Start Write-Back Server
    1. Notice that a new twbe folder is created
  8. Copy your config.yml and default.yml to the new twbe\WEB-INF\classes and twbe\WEB-INF\classes\sites, respectively.
  9. Copy the database driver to twbe\WEB-INF\lib
  10. Restart Write-Back Server service

...

0 - Before you start

It is HIGHLY recommended that you perform a backup of the schema where the extension is running as well as a copy of the current web app (a zip of the web app in the tomcat folder) in order to migrate the old config.yml file to a new one. This is all it takes to roll back the installation if anything goes wrong, you just have to restore the database backup and unzip the webapp. 

1 - Backing up config.yml and default.yml

Before proceeding, you have to save your current configuration files to migrate them to the new version.

  1. These files can be found in the installation path of Write-Back under apache-tomcat/webapps/twbe/WEB-INF/classes/config.yml and apache-tomcat/webapps/twbe/WEB-INF/classes/sites/default.yml. If you have more sites configured besides default you will have to save those as well.
  2. Please save these files to a location that you can access later.

2 - Backing up database driver

Besides configuration files, you'll also have to backup the driver for the database you are currently using; save it to a place that you'll be able to reach later.

  1. It can be found under apache-tomcat/webapps/twbe/WEB-INF/lib. The PostgreSQL driver, for example, is postgresql-42.2.5.jar.
  2. Please save these files to a location that you can access later.

3 - Install the new version and remove the old one

Now after backing up everything you do the installation.

  1. Stop Write-Back Server service
  2. To download the new version simply go to our Support & Resources page and in there you can find the war to download (not the installer) and you should rename it to twbe.war
  3. Go to <installation_path>\apache-tomcat\webapps\
  4. Delete twbe from webapps
  5. Now copy the new twbe.war to the webapps folder
Info

When you download the twbe.war it comes with a version in the file name. We recommend removing the version from the file name, so this way you don't need to update your trex files to the new war name.

5 - Apply your existing configuration and Start Write-Back

Finally you need to restore your existing settings. 

  1. Copy your config.yml and default.yml to the new twbe\WEB-INF\classes and twbe\WEB-INF\classes\sites, respectively.
  2. Copy the database driver to twbe\WEB-INF\lib
  3. Start Write-Back Server
    1. Notice that a new twbe folder is created

Upgrading from Release 2.1.x to Release 2.2

Please follow the Standard upgrade instructions.


Upgrading from Release 2.1.2 to Release 2.1.3

...

Version 2.1 brings improvements and new features to 2.0. These include new customization options, optional selection of marks to add data, support for boolean types from Tableau as well as an improved way to deal with Tableau source fields that is much more intuitive and secure. You can find all about this in our Release Notes.

0 - Before you start

It is HIGHLY recommended that you perform a backup of the schema where the extension is running as well as a copy of the current web app (a zip of the web app in the tomcat folder) in order to migrate the old config.yml file to a new one. This is all it takes to roll back the installation if anything goes wrong, you just have to restore the database backup and unzip the webapp. 

1 - Backing up config.yml and default.yml

Before proceeding, you have to save your current configuration files to migrate them to the new version. These files can be found in the installation path of Write-Back under apache-tomcat/webapps/twbe/WEB-INF/classes/config.yml and apache-tomcat/webapps/twbe/WEB-INF/classes/sites/default.yml. If you have more sites configured besides default you will have to save those as well. Please save these files to a location that you can access later.

2 - Backing up database driver

Besides configuration files, you'll also have to backup the driver for the database you are currently using; save it to a place that you'll be able to reach later. It can be found under apache-tomcat/webapps/twbe/WEB-INF/lib. The PostgreSQL driver, for example, is postgresql-42.2.5.jar.

...

Along with the new features, you may see some changes on your datasets tables and metadata to account for the new features to allow for backward compatibility with the previous version. You can find all about this in our Release Notes.

0 - Before you start

It is HIGHLY recommended that you perform a backup of the schema where the extension is running as well as a copy of the current web app (a zip of the web app in the tomcat folder) in order to migrate the old config.yml file to a new one. This is all it takes to roll back the installation if anything goes wrong, you just have to restore the database backup and unzip the webapp. 

...