This section describes how to upgrade the Talend Administration Center database. Note you can skip the database backup, for data security
reasons or other important circumstances.
Warning: Skipping the backup may lead to database loss if migration fails. Only skip the
backup for necessary reasons.
The source and target databases must be of the same type. To migrate from a database X to
a database Y, for example from H2 to MySQL, first see Backing up the administration database.
Procedure
-
Stop the Apache Tomcat server.
-
To avoid errors during the migration process, increase the
memory of Tomcat.
-
Delete the old Talend Administration Center application .war file
and/or the org.talend.administrator folder in <TomcatPath>/webapps to undeploy it.
-
Delete the <TomcatPath>/work directory to empty
Apache Tomcat cache.
-
Download the new
Talend-AdministrationCenter-YYYYMMDD_HHmm-VA.B.C.zip
from the link listed in your license email.
-
Unzip
Talend-AdministrationCenter-YYYYMMDD_HHmm-VA.B.C.zip.
This will give you access to the different components needed to
benefit from all the
Talend Administration Center
capabilities:
-
org.talend.administrator.war, the archive containing
the actual Talend Administration Center Web application.
-
Artifact-Repository-Nexus-VA.B.C.D.zip, the archive
containing an artifact repository software, based on Sonatype Nexus, that
will be used to handle software updates, DI artifacts and also ESB
artifacts.
-
Artifact-Repository-Artifactory.zip, the archive
containing Talend scripts to initialize users in the artifact repository, that will be used
to handle software updates, DI artifacts and also ESB artifacts.
-
Copy the Web application, org.talend.administrator.war, into the webapps directory of Tomcat.
Once you have copied this war file, you can either unzip it manually under
the same directory, or let Tomcat unzip the web application at startup.
-
Start Apache Tomcat.
-
Open a Web browser and type in the application URL. The database configuration
page opens and a message indicates that the database version needs to be
updated.
-
Click Proceed migration to
start the migration process. A dialog box opens:
-
In the backup settings area, check your
database connection information and enter the path to your folder where the
backed up database will be stored in the Dump
Path field.
The command used to migrate the database can be updated
according to your needs. If you are migrating an Oracle database from an earlier
version of the Talend Administration Center to
the latest version of Talend Administration Center, make sure the -Dtalend.schema=<schemaName>
parameter is present in the
migration command.
Select skip backup if
you do not want to perform the backup. A
confirmation message is displayed.
Warning: Only skip the backup for necessary reasons.
-
Click Proceed to start the database backup
and migration operation.
-
When the message Database migration completed
successfully shows, click Finish.
The database is migrated and a
.zip file holding the backed up database is created in
the folder you have defined previously.
-
On the database configuration page, set your new license then log in the Web
application. The database migration process is finished.