Upgrade Process
We recommend the following upgrade process:
- Stop your application server in the same way it was started such as stopping the Windows services / Linux daemon, stopping the desktop command windows, or using the tomcat/bin/shutdown.
Remove the application server service if one was created (Windows only). - Stop your database server and ONLY if you are using the bundled PostgreSQL database on Windows then use the $MM_HOME/Setup.sh utility to remove the Database Service as follows: Go to the Database Server tab, enable disable or uncheck the database service check box, and click on the Configure button.
- Backup your Talend Data Catalog data including your database and data file directories as explained above.
- Backup your Talend Data Catalog software by copying the $MM_HOME directory as $MM_HOME.yyyymmdd.
- Install the complete Talend Data Catalog new software (ONLY needed for clean install of a new version) by deleting the old $MM_HOME, and then creating a new one by unzipping the new Talend Data Catalog full package.
- Apply the latest software cumulative patch by unzipping it from inside the new $MM_HOME directory.
- WARNING 1: Make sure you unzip with overwrite on Windows, and use unzip -u on linux to update files while retaining permissions.
- WARNING 2: You cannot use cumulative patches for major version upgrades, you must first start from a clean install of the new major GA version.
- WARNING 3: You cannot reverse / unzip an older cumulative patch, you must restart from a clean install of the original GA version.
- Restore your Talend Data Catalog data and software customization/setup (ONLY needed for a clean install of a new version) by copying the appropriate files and directories (as previously explained) from $MM_HOME.yyyymmdd to $MM_HOME, including at least $MM_HOME/data and $MM_HOME/conf/conf.properties but possibly more as used and customized such as $MM_HOME/conf/resources, or $MM_HOME/tomcat/conf.
- Integrate the new software features in your configuration by copying potential new versions of files from $MM_HOME/conf/Template into their matching directories in $MM_HOME/conf/. For example, the new $MM_HOME/conf/ModelBridgeList.xml may contain some new or updated bridges. WARNING: if you had customized some files such as $MM_HOME/conf/resources/MM.properties, you must re-apply/merge such customization starting from the new version of that file copied Template.
- Reconfigure your Database Server (ONLY if you are using the bundled PostgreSQL database on Windows). As the PostgresSQL server software version may have changed and the database server needs to be upgraded. Therefore, you must:
- Execute the (old renamed installation) $MM_HOME.yyyymmdd/Setup.sh utility to restore the old Database Service as follows: Go to the Database Server tab, enable the database service check box, and click on the Configure button.
- Execute the (new installation) $MM_HOME/Setup.sh utility as follows: go to the Database Server tab, enable the database service check box, and click on the Configure button. At this point the $MM_HOME/Setup.sh utility will retrieve the existing PostgreSQL data from the old install directory (which was already running as a service), will migrate them to the new install directory, and will remove the old PostgreSQL service, before starting the new PostgreSQL service on the new directory.
- Restart your database server (ONLY if you are using the bundled PostgreSQL database on Windows).
- Restart your application server after which your first login as Administrator may prompt you for an upgrade of your MM database.
- Redo all above steps for any other Talend Data Catalog Application server configured as MIMB harvesting agent.
- Update your repository content (ONLY as needed) if the upgrade contains new and improved import bridges that would require to fully re-import the model (remove incremental harvesting in such case) and this will therefore require to re-build the related Configurations.
Typical DevOps Linux bash scripts include the following commands:
#! /bin/bash
##############
# MM INSTALL #
##############
######## START SETUP ########
sudo su
MM_INSTALL=/home
MM_INSTALLER=Talend Data Catalog -1110-20241231
MM_SOFTWARE=TalendDataCatalog
MM_HOME=${MM_INSTALL}/${MM_SOFTWARE}
######## DOWNLOAD INSTALLER TO INSTALL DIRECTORY ########
# get $MM_INSTALL/$MM_INSTALLER
######## STOP SERVER ########
$MM_HOME/ShutdownServerApplication.sh
# double check for any tomcat process still running
# ps -edf | grep tomcat
# kill -9 <Process Id>
######## FULL CLEAN INSTALL NEW SERVER ########
# Backup old install and extract new one
cd $MM_INSTALL
mv $MM_SOFTWARE $MM_SOFTWARE.yyyymmdd
tar -xvf $MM_INSTALLER.tbz2
rm MM_INSTALLER.tbz2
# optional ThirdParty software extract for brand new install on machines with no access to internet
mv *ThirdParty*.zip $MM_SOFTWARE
cd $MM_SOFTWARE
unzip *ThirdParty*.zip
rm *ThirdParty*.zip
######## COPY SETUP AND DATA ########
cd $MM_INSTALL_DIR/$MM_SOFTWARE.yyyymmdd
# data directory with large MM search index and MIMB cache
# cp -r data ../$MM_SOFTWARE
mv data ../$MM_SOFTWARE
# conf properties (memory, path, etc.)
#M_BROWSE_PATH=
#M_JAVA_OPTIONS=-Xmx64G
cp conf/conf.properties ../$MM_SOFTWARE/conf
# tomcat conf properties (URL, ports, services, etc)
cp tomcat/conf/tomcat.properties ../$MM_SOFTWARE/tomcat/conf
######## HARVESTING AGENT SERVERS ########
# conf agent identification to MM server
cp conf/agent.properties ../$MM_SOFTWARE/conf
# conf agent access to SSL based MM server
$MM_HOME/Setup.sh -ch abc.def.com -cp 443
######## MM MAIN SERVER ########
# MM conf properties (database connection, email setup, etc.)
cp conf/mm.conf.properties ../$MM_SOFTWARE/conf
# MM resources such as the UI look & feel
alias cp=cp
cp -rf conf/resources ../$MM_SOFTWARE/conf
# Tomcat SSH Setup
cp tomcat/conf/keystore ../$MM_SOFTWARE/tomcat/conf
cp tomcat/conf/server.xml ../$MM_SOFTWARE/tomcat/conf
######## RESTART SERVER ########
$MM_HOME/RestartServerApplication.sh
######## END ########