Skip to main content Skip to complementary content

Migrating Talend Data Catalog 7.3 to 8.0 installed with the embedded PostgreSQL

Before you begin

  • You have applied the latest Talend Data Catalog 7.3 cumulative patch.
  • You have downloaded Talend Data Catalog 8.0.
  • You have downloaded the latest Talend Data Catalog 8.0 cumulative patch, if necessary.

Procedure

  1. Stop Talend Data Catalog application server in the same way it was started, such as stopping the Windows service, stopping the desktop command window, or using the tomcat/bin/shutdown.bat file.
  2. Stop Talend Data Catalog database server as a new version of PostgreSQL server can be included as part of the upgrade.
  3. Remove the application server service and the database server service if created:
    1. In the software home directory, right-click the Setup.bat file and click Run as administrator.
    2. Click Yes to allow the application to make changes to your device.
    3. In the Database Server tab, clear the Enable Windows Service check box, and click the Configure button.
    4. In the Application Server tab, clear the Enable Windows Service check box, and click the Configure button.
  4. Back up your data including your database and data file directories.
    You can back up the PostgreSQL database instance by double-clicking backupDB.bat in TalendDataCatalog\postgresql\scripts.

    By default, the backup file is saved in the TalendDataCatalog\postgresql\backup folder.

    For more information, see https://www.postgresql.org/docs/.

  5. Back up your Talend Data Catalog software by copying the <TDC_HOME> directory to <TDC_HOME>.old.
  6. Create a new <TDC_HOME> installation directory.
  7. Unzip the Talend Data Catalog 8.0 package in the new directory for a clean installation of a new version.
  8. Apply the latest Talend Data Catalog 8.0 cumulative patch.
    Make sure you unzip the patch file in overwrite mode in the installation directory.
    Information noteWarning:

    You cannot use cumulative patches for major version upgrades. You must first start from a clean installation of the new major GA version.

    You cannot reverse an older cumulative patch, you must restart from a clean install of the original GA version.

  9. To restore your data and software customizations and setup performed in Talend Data Catalog version 7.3, copy the appropriate files and directories from <TDC_HOME>.old to <TDC_HOME> including at least \data and \conf\conf.properties but possibly more as used and customized such as \conf\resources, or \tomcat\conf.
    For more information, see Data storage location.
  10. Copy any new version of files from <TDC_HOME>\conf\Template into their matching directories in <TDC_HOME>\conf\ to integrate new or updated software features in your configuration.
    For example, ModelBridgeList.xml can contain new or updated bridges.
    If you have customized some files such as conf\resources\MM.properties, you must merge these customizations starting from the new version of that file copied from <TDC_HOME>\conf\Template.
  11. Reconfigure the database server using the Setup.bat file to upgrade it as the PostgreSQL software version has changed and the database server need to be upgraded.
    1. In the <TDC_HOME>.old directory, right-click the Setup.bat file and click Run as administrator.
    2. In the Database Server tab, select the Enable Windows Service check box, and click the Configure button to restore the old database service.
    3. In the <TDC_HOME> directory, right-click the Setup.bat file and click Run as administrator.
    4. In the Database Server tab, select the Enable Windows Service check box, and click the Configure button. The setup utility will retrieve the existing PostgreSQL data from the old installation directory which was already running as a service, migrate them to the new installation directory, and remove the old PostgreSQL service before starting the new PostgreSQL service in the new directory.
  12. Restart the Talend Data Catalog database server from Windows Services.
  13. Restart the Talend Data Catalog application server by executing the RestartServerApplication.bat file in the <TDC_HOME> directory. Your first login as Administrator may prompt you for an upgrade of your database.
    You can also create the application server Windows service using the setup utility in the installation directory. For more information, see Installing and configuring Talend Data Catalog using the embedded PostgreSQL database.
  14. Update your Talend Data Catalog repository content if the upgrade contains new and improved import bridges that would require to fully re-import the model. You need to remove incremental harvesting in such case and re-build the related configurations.

Did this page help you?

If you find any issues with this page or its content – a typo, a missing step, or a technical error – let us know how we can improve!