9.2

Edit

Upgrade from v9.2.1.4 to v9.2.1.5

Prerequisites

  • You have WorkFusion SPA 9.2.1.4 installed.
  • All actions for the upgrade must be performed as <WF_USER>. The Root user is not required.

Preparation

To prepare the 9.2.1.5 service pack, on the APP server, run the following commands as <WF_USER>:

$ mkdir -pv <install_dir>/patches/patch_9.2.1.5
$ cd <install_dir>/patches/patch_9.2.1.5
$ curl -o 'patch_9.2.1.5.tar.gz' 'patch download url'

$ tar xzf patch_9.2.1.5.tar.gz

Upgrade

To upgrade, on the APP server, run the following command as <WF_USER>:

$ cd <install_dir>/patches/patch_9.2.1.5
$ ./patch_9.2.1.5.sh apply

You will see a similar output:

Mon Nov 23 16:31:57 UTC 2020 Check if backup exists: ./backup/workspace.war_bak
Mon Nov 23 16:31:57 UTC 2020 Backing up workspace.war to ./backup/workspace.war_bak
Mon Nov 23 16:31:59 UTC 2020 Check if backup exists: ./backup/workspace-api.war_bak
Mon Nov 23 16:31:59 UTC 2020 Backing up workspace-api.war to ./backup/workspace-api.war_bak
Mon Nov 23 16:32:01 UTC 2020 Check if backup exists: ./backup/workspace-sandbox.war_bak
Mon Nov 23 16:32:01 UTC 2020 Backing up workspace-sandbox.war to ./backup/workspace-sandbox.war_bak
Mon Nov 23 16:32:03 UTC 2020 Check if backup exists: ./backup/workspace-api-sandbox.war_bak
Mon Nov 23 16:32:03 UTC 2020 Backing up workspace-api-sandbox.war to ./backup/workspace-api-sandbox.war_bak
Mon Nov 23 16:32:04 UTC 2020 Stopping service: workspace_production
workspace_production: stopped
Mon Nov 23 16:32:15 UTC 2020 Stopping service: workspace_sandbox
workspace_sandbox: stopped
Mon Nov 23 16:32:26 UTC 2020 Copying ./sources/workspace-9.2.0.8.war to /opt/workfusion/workspace_production/webapps/workspace.war
Mon Nov 23 16:32:28 UTC 2020 Copying ./sources/workspace-api-9.2.0.8.war to /opt/workfusion/workspace_production/webapps/workspace-api.war
Mon Nov 23 16:32:29 UTC 2020 Copying ./sources/workspace-sandbox-9.2.0.8.war to /opt/workfusion/workspace_sandbox/webapps/workspace-sandbox.war
Mon Nov 23 16:32:30 UTC 2020 Copying ./sources/workspace-api-sandbox-9.2.0.8.war to /opt/workfusion/workspace_sandbox/webapps/workspace-api-sandbox.war
Mon Nov 23 16:32:32 UTC 2020 Cleanup tomcat context dir: /opt/workfusion/workspace_production/webapps/workspace/
Mon Nov 23 16:32:33 UTC 2020 Cleanup tomcat context dir: /opt/workfusion/workspace_production/webapps/workspace-api/
Mon Nov 23 16:32:34 UTC 2020 Cleanup tomcat context dir: /opt/workfusion/workspace_sandbox/webapps/workspace-sandbox/
Mon Nov 23 16:32:35 UTC 2020 Cleanup tomcat context dir: /opt/workfusion/workspace_sandbox/webapps/workspace-api-sandbox/
Mon Nov 23 16:32:36 UTC 2020 Starting service: workspace_production
workspace_production: started
Mon Nov 23 16:32:38 UTC 2020 Starting service: workspace_sandbox
workspace_sandbox: started
Mon Nov 23 16:32:40 UTC 2020 Patch complete. It might take Workspace about 5 minutes for startup.

Post-upgrade steps

After the upgrade, on the APP server, run the following command as <WF_USER>:

$ cd <package_dir> ## directory where initial installer was extracted
$ ./install.sh check_raw app

Validate installation

To validate that you have installed the correct patch, see the following instructions.

To verify the WorkSpace sandbox, do the following:

  1. On the APP server, go to the /opt/workfusion/workspace_sandbox/webapps/workspace-sandbox/WEB-INF/classes/ directory.
  2. Open file git.properties, and check the git.build.version and git.commit.id properties. The value of git.build.version property must be 9.2.0.8.

To verify the WorkSpace API sandbox, do the following:

  1. On the APP server, go to the /opt/workfusion/workspace_production/webapps/workspace/WEB-INF/classes/ directory.
  2. Open file git.properties, and check the git.build.version and git.commit.id properties. The value of git.build.version property must be 9.2.0.8.

Validate the issue is resolved

To check that the problem addressed with the patch is resolved, you will need at least 2 Control Tower instances connected to a single WorkSpace instance under the same license. You have to reproduce the problem first and, after the upgrade, make sure the patch has resolved it.

To reproduce the problem, complete the following steps:

  1. Create a new Use Case and a Use Case Category on Control Tower instance 1.
  2. Create a Manual Task for the sub-category and run it on instance 1.
  3. Import the Manual Task to instance 2 and run it.

When the problem is resolved, you will see categories both from instance 1 and instance 2 displayed in WorkSpace. Otherwise, only categories from one of the instances are shown.

Rollback

To roll the changes back, on the APP server, run the following command as <WF_USER>:

$ cd <install_dir>/patches/patch_9.2.1.5
$ ./patch_9.2.1.5.sh rollback

You will see a similar output:

Mon Nov 23 16:35:15 UTC 2020 Stopping service: workspace_production
workspace_production: stopped
Mon Nov 23 16:35:26 UTC 2020 Stopping service: workspace_sandbox
workspace_sandbox: stopped
Mon Nov 23 16:35:37 UTC 2020 Copying ./backup/workspace.war_bak to /opt/workfusion/workspace_production/webapps/workspace.war
Mon Nov 23 16:35:38 UTC 2020 Copying ./backup/workspace-api.war_bak to /opt/workfusion/workspace_production/webapps/workspace-api.war
Mon Nov 23 16:35:40 UTC 2020 Copying ./backup/workspace-sandbox.war_bak to /opt/workfusion/workspace_sandbox/webapps/workspace-sandbox.war
Mon Nov 23 16:35:41 UTC 2020 Copying ./backup/workspace-api-sandbox.war_bak to /opt/workfusion/workspace_sandbox/webapps/workspace-api-sandbox.war
Mon Nov 23 16:35:42 UTC 2020 Cleanup tomcat context dir: /opt/workfusion/workspace_production/webapps/workspace/
Mon Nov 23 16:35:43 UTC 2020 Cleanup tomcat context dir: /opt/workfusion/workspace_production/webapps/workspace-api/
Mon Nov 23 16:35:44 UTC 2020 Cleanup tomcat context dir: /opt/workfusion/workspace_sandbox/webapps/workspace-sandbox/
Mon Nov 23 16:35:45 UTC 2020 Cleanup tomcat context dir: /opt/workfusion/workspace_sandbox/webapps/workspace-api-sandbox/
Mon Nov 23 16:35:46 UTC 2020 Starting service: workspace_production
workspace_production: started
Mon Nov 23 16:35:49 UTC 2020 Starting service: workspace_sandbox
workspace_sandbox: started
Mon Nov 23 16:35:51 UTC 2020 Rollback complete. It might take Workspace about 5 minutes for startup.
← PreviousNext →