Skip to main content Skip to complementary content

Backing up the environment

About this task

Before backing up and migrating the data of each Talend solution, you need to make sure your environment is correctly backed up and your Talend Administration Center configuration settings are saved.

The environment backup process includes the following mandatory procedures:
Information noteNote: You need to complete these steps in the following order.

Saving the configuration parameters

Procedure

  1. Log on to Talend Administration Center as Administrator.
  2. Click Configuration on the menu tree view. The Configuration page opens on the workspace.
  3. Click the Export parameters button located at the top of the Configuration page to export your system parameters and settings into a file.
    This file will be used to restore your configuration parameters when your new instance of Talend Administration Center will be set up. It includes information related to the user environment, such as database vendor and version, application server and version, disk space usage and so on.
    Information noteNote: This operation only saves the parameters of the Configuration page. The business information (user, project, task creation, etc.) is retrieved during the database migration.

Saving the local projects

Procedure

  1. Launch Talend Studio.
  2. Click the Export local projects icon and export your local projects to an archive file.

Stopping the services

Procedure

  1. Make sure that all users are disconnected from Talend Studio.
  2. Make sure that the following modules and services are stopped:
    • Apache Tomcat
    • Talend CommandLine
    • Talend JobServer
    • Git
    • Talend Artifact Repository

Backing up the administration database

Pausing tasks in Talend Administration Center

Before backing up the project administration database for migration purposes, it is best practice to pause all currently active tasks.

This will prevent the Job Conductor from trying to run those tasks while the database migration process is running. Once the backup is complete, unpause all the tasks.

Procedure

  1. Access Talend Administration Center.
  2. In the Menu tree view, click Job Conductor to display the list of all currently active and scheduled tasks.
  3. Click Pause.

What to do next

You can now back up the project administration database.

Backing up a MySQL database

Procedure

  1. Execute the following dump command:
    • On Windows: mysqldump -u tisadmin -ptisadmin talend_administrator > c:/<DB_Backuppath>/DumpTalendAdministrator.sql
    • On Linux: mysqldump -u tisadmin -ptisadmin talend_administrator > /home/<DB_Backuppath>/DumpTalendAdministrator.sql
  2. On Linux, if you want to load this back-up file to the talend_administrator database in case of error, use the following command:
    mysql -u tisadmin -ptisadmin talend_administrator</home/<DB_Backuppath>/DumpTalendAdministrator.sql

What to do next

Once the backup is complete, unpause all the tasks in Talend Administration Center.

Backing up an H2 database

Procedure

Copy the following files and folders to a convenient and safe place for backup:
  • <Applicationpath>/WEB-INF/Database/talend_administrator.h2.db
  • <Applicationpath>/WEB-INF/Database/talend_administrator.trace.db
  • talend_administrator.lobs.db

Note that an automatic backup is performed every day and at each startup and shutdown of the application server. Oldest backups are deleted when their number is above 30. These parameters are set by default in the configuration.properties file and can be customized.

What to do next

Once the backup is complete, unpause all the tasks in Talend Administration Center.

Backing up the Git repository

Procedure

After you backed up the administration database, duplicate the old repository and connect it to a new repository in Git.
For more information, see Github's documentation.
Information noteWarning: After connecting your new Talend Studio to repositories from your old Talend environment, you will not be able to access these repositories from the old Talend Studio versions.

Backing up the archive folder holding the generated tasks

Before migrating your Talend products, back up the archive folder holding the tasks generated by the Talend CommandLine of the current version.

Procedure

To backup this folder, copy its content into a folder of your choice.

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 – please let us know!