Upgrading IBM Task Mining
You can upgrade the IBM Task Mining application directly from the existing version to the next immediate version of IBM Task Mining. For example, you can upgrade directly from version 1.14.0 to version 1.14.1. However, you cannot upgrade directly from version 1.13.2 to version 1.14.1.
Before you begin
You must download the following IBM Task Mining installation package from IBM® Passport Advantage®:
taskminer_setup_X.Y.Z.tar.gz
Where X.Y.Z indicates the version of IBM Task Mining.
To know more about downloading packages, see Downloading Packages.
Procedure
-
Open the Terminal.
-
From the
root
user, stop the following IBM Task Mining (TM) services:- Stop Tomcat by running the following command:
cd /opt/taskminer
./bin/tm-web.sh stop
- Stop TM Backend by running the following command:
cd /opt/taskminer./bin/tm-processor.sh stop
- Stop TM Builder by running the following command:
cd /opt/taskminer./bin/tm-builder.sh stop
-
Copy the compressed IBM Task Mining installation files to the destination server and extract the files.
-
Set the location as an environment variable by using the following command:
export TM_INSTALL=/home/<mydir>/taskminer
-
Go to the directory where your existing Task Mining installation resides and set up the environment variable <TM_HOME> by using the following command:
export TM_HOME=/opt/taskminer
-
Create a backup folder
export BACKUP_DIR="${TM_HOME}/backup_`date '+%Y-%m-%d_%H%M'`" mkdir -p ${BACKUP_DIR}
-
-
Do the following steps to update the Task Mining directories for IBM Process Mining 1.14.1 and create backups for the Task Mining directories in IBM Process Mining 1.14.0:
-
Upgrade OpenJDK to version 17 by using the following commands:
mv ${TM_HOME}/ibm-openjdk-semeru ${BACKUP_DIR}/ibm-openjdk-semeru.1.14.0 cp -R ${TM_INSTALL}/ibm-openjdk-semeru ${TM_HOME}/ibm-openjdk-semeru
-
Upgrade the Tomcat to version 10.18 by using the following commands:
mv ${TM_HOME}/tomcat ${BACKUP_DIR}/tomcat cp -R ${TM_INSTALL}/tomcat ${TM_HOME}/tomcat
-
Take backup and update the files in the
tmprocessor
folder by using the following commands:mkdir ${BACKUP_DIR}/tmprocessor mv ${TM_HOME}/tmprocessor/*.jar ${BACKUP_DIR}/tmprocessor/. cp ${TM_INSTALL}/tmprocessor/*.jar ${TM_HOME}/tmprocessor/.
-
Take backup and update the files in the
tm
folder:mv ${TM_HOME}/tm ${BACKUP_DIR}/tm cp ${TM_INSTALL}/tm ${TM_HOME}/tm
-
Take backup and update the files in the
conf
folder:mkdir ${BACKUP_DIR}/conf cp ${TM_HOME}/conf/* ${BACKUP_DIR}/conf/. cp ${TM_INSTALL}/conf/*.conf ${TM_HOME}/conf/.
-
Take backup and update the files in the
bin
folder:mkdir ${BACKUP_DIR}/bin cp ${TM_HOME}/bin/* ${BACKUP_DIR}/bin/. cp ${TM_INSTALL}/bin/*.sh ${TM_HOME}/bin/.
-
Delete the settings for clean up as the clean up is not required in IBM Process Mining 1.14.1 (optional):
${TM_HOME}/bin/environment.conf # remove hostname_app= validation_domain=
-
-
With the new OpenJDK version 17, you must do all the configurations in the Basic setup topic.
-
With the new Tomcat version 10.18, you must do the configuration in the Configuration to bypass FOSS exception topic.
-
Allocate the run rights to shell scripts by using the following steps:
sh chmod +x ${TM_HOME}/tomcat/bin/*.sh chmod +x ${TM_HOME}/bin/*.sh
-
Change the owner of <TM_HOME> to the RUNAS user by using the following steps:
sh sudo chown -R taskminer:taskminer ${TM_HOME}/
-
Confirm the SSL configuration for NGINX per the type of Task Mining deployment, on a dedicated server or on the same server as Process Mining. See the SSL configuration on NGINX and Edit NGINX configuration for Task Mining on Process Mining Server topics for more information.
-
Remove the following locations:
location /jwtlong { location /Login { location /LoginAgent { location /PostLogin { location /PostLoginAgent { location /PostLoginWeb { location /PassiveSignout { location /AuthorizationError { location /openflow { location /Logout { location /taskbuilder-2.1.0 { location / { upstream ws-backend {
-
Add the following location:
location ~* ^/taskmining/(.*) {
-
Confirm the changes by using the following command:
nginx -T
-
Restart NGINX.
systemctl restart nginx
-
-
Start the IBM Task Minings application services.
-
Start Tomcat by running the following command:
cd ${TM_HOME}/bin ./tm-web.sh start
-
Start TM Backend by running the following commands:
./tm-processor.sh start ./tm-builder.sh start