Upgrade from 10.1.2 to 10.1.2.1
The 10.1.2.1 patch updates the Control Tower component and its configuration.
Prerequisites
- You have WorkFusion IAC 10.1.2 up and running.
- No Business Processes are running.
Download and extract patch
To download and extract the patch, connect to the APP server via SSH, and run the following commands as the runtime user (<wf_user>):
Change directory to
INSTALL_DIR, create the patches directory.$ export INSTALL_DIR=/opt/workfusion $ cd $INSTALL_DIR $ mkdir patches $ cd patches/Download the patch to the INSTALL_DIR/patches/ directory with any available method, for example,
$ curl -o 'patch_10.1.2-10.1.2.1.tar.gz' 'download_url'Extract the patch:
$ tar xzf patch_10.1.2-10.1.2.1.tar.gzAfter the extraction, you'll see the patch_10.1.2-10.1.2.1/ directory:
$ ls -la drwxrwxr-x. 2 wfuser wfuser 58 Oct 21 17:06 patch_10.1.2-10.1.2.1 -rw-rw-r--. 1 wfuser wfuser 247901699 Oct 21 17:06 patch_10.1.2-10.1.2.1.tar.gz $ ls -la patch_10.1.2-10.1.2.1/ -rwxrwxr-x. 1 wfuser wfuser 4255 Nov 20 14:01 patch_10.1.2.1.sh drwxrwxr-x. 2 wfuser wfuser 168 Nov 20 09:06 sources
Apply patch
To apply the patch, on the APP server, go to the patch_10.1.2-10.1.2.1/ directory and run the following command:
$ ./patch_10.1.2.1.sh apply
You will see a similar output:
Mon Apr 13 17:11:10 UTC 2020 Updating Control Tower to version: 10.1.2.1
Mon Apr 13 17:11:13 UTC 2020 Enabling maintenance mode for Control Tower failover scrip...
maintenance-enabled
Mon Apr 13 17:11:17 UTC 2020 Stopping Control Tower if it is started...
Mon Apr 13 17:11:33 UTC 2020 Extracting Control Tower 10.1.2.1 artifact into /opt/workfusion/patches/patch_10.1.2-10.1.2.1/sources/extracted/...
mkdir: created directory ‘sources/extracted’
Mon Apr 13 17:11:39 UTC 2020 Applying Control Tower environment customizations in extracted workfusion.war 10.1.2.1 (JKS for SSO provider and static files for proper logout)...
Mon Apr 13 17:11:42 UTC 2020 Archiving workfusion.war 10.1.2.1 with customizations /opt/workfusion/patches/patch_10.1.2-10.1.2.1/sources/extracted/...
Mon Apr 13 17:11:58 UTC 2020 Updating Control Tower artifact in destination:...
Mon Apr 13 17:12:03 UTC 2020 Cleanup Control Tower Tomcat context directory...
Mon Apr 13 17:12:06 UTC 2020 Updating Control Tower java properties in workfusion.properties file...
Mon Apr 13 17:12:09 UTC 2020 Updating Control Tower secure java properties in vault...
Checking if Vault is reachable and unsealed...
100 294 100 294 0 0 2370 0 --:--:-- --:--:-- --:--:-- 2390 {"initialized":true,"sealed":false,"standby":false,"performance_standby":false,"replication_performance_mode":"disabled","replication_dr_mode":"disabled","server_time_utc":1586797939,"version":"1.0.3","cluster_name":"vault-cluster-fc3f95b9","cluster_id":"892f9da1-140e-06a1-a22e-e8ecd093a233"}
RETVAL=0
Vault is ready for connections...
[INFO ] You are working with safe : workfusion_WFInternal
[INFO ] Properties have been processing.
[INFO ] ct.quartz.datasource.url ct.quartz.datasource.url = jdbc:sqlserver://rcm-4063-wfan-10024-mssql1.workfusion.com:1433;databaseName=workfusion;schema=ct was added into secure storage
[INFO ] ct.quartz.datasource.username ct.quartz.datasource.username = workfusion was added into secure storage
[INFO ] ct.quartz.datasource.password ct.quartz.datasource.password = ********** was added into secure storage
[INFO ] Properties were loaded into the security storage
Mon Apr 13 17:12:24 UTC 2020 Disabling maintenance mode for Control Tower failover script...
maintenance-disabled
Mon Apr 13 17:12:27 UTC 2020 Starting Control Tower...
Mon Apr 13 17:12:31 UTC 2020 It might take Control Tower about 5 minutes for startup...
important
If Workfusion IA Cloud Enterprise was deployed in the High Availability mode, repeat the same steps on the second APP server.
Verify update
To verify that the update is successful, wait for the Control Tower service initialization, that means wait for the availability of the web interface in your browser). For that, go to the directory where the installer was extracted, and run the command:
./install.sh check app
Rollback to 10.1.2
To roll back to a previous version, on the APP server, go to the patch_10.1.2-10.1.2.1/ directory and run the following command:
$ ./patch_10.1.2.1.sh rollback
You will see a similar output:
Mon Apr 13 19:55:00 UTC 2020 Rollback Control Tower to version: 10.1.2
Mon Apr 13 19:55:03 UTC 2020 Enabling maintenance mode for Control Tower failover script...
maintenance-enabled
Mon Apr 13 19:55:06 UTC 2020 Stopping Control Tower if it is started...
Mon Apr 13 19:55:19 UTC 2020 Restoring Control Tower from backup...
Mon Apr 13 19:55:23 UTC 2020 Cleanup Control Tower Tomcat context directory...
Mon Apr 13 19:55:26 UTC 2020 Restoring Control Tower tomcat context directory from backup...
Mon Apr 13 19:55:30 UTC 2020 Reverting Control Tower java properties in workfusion.properties file...
Mon Apr 13 19:55:33 UTC 2020 Reverting Control Tower secure java properties in vault...
Checking if Vault is reachable and unsealed...
100 294 100 294 0 0 2013 0 --:--:-- --:--:-- --:--:-- 2027 {"initialized":true,"sealed":false,"standby":false,"performance_standby":false,"replication_performance_mode":"disabled","replication_dr_mode":"disabled","server_time_utc":1586807733,"version":"1.0.3","cluster_name":"vault-cluster-fc3f95b9","cluster_id":"892f9da1-140e-06a1-a22e-e8ecd093a233"}
RETVAL=0
Vault is ready for connections...
[INFO ] You are working with safe : workfusion_WFInternal
[INFO ] Properties have been processing.
[INFO ] ct.quartz.datasource.url property was removed from secure storage
[INFO ] ct.quartz.datasource.username property was removed from secure storage
[INFO ] ct.quartz.datasource.password property was removed from secure storage
[INFO ] Properties were loaded into the security storage
Mon Apr 13 19:55:38 UTC 2020 Disabling maintenance mode for Control Tower failover script...
maintenance-disabled
Mon Apr 13 19:55:41 UTC 2020 Starting Control Tower...
Mon Apr 13 19:55:45 UTC 2020 It might take Control Tower about 5 minutes for startup...