8.5

Edit

Upgrade OCR 8.2 to 8.5

Description

SPA versions 8.2 and 8.5 are operating on different operating systems (RHEL6 for 8.2, RHEL7 for 8.5) and use different ways of deployment (bash scripts for 8.2 and ansible playbook for 8.5). Regarding this, the best way to accomplish integration of 8.5 OCR with 8.2 is to create a patch, which replace artifacts and updates the config files. Also, there was a change in ABBYY licensing in 8.5, which causes the need of requesting it.

The following steps are to be performed during the upgrade:

  1. Back up existing OCR.
  2. Copy Java OCR 8.5 artifacts.
  3. Update existing OCR configs to point to a new artifacts and add some new parameters.
  4. Request the ABBYY license from the IT Ops team.
  5. Restart the OCR services.
  6. Run a test BP.

Steps 1-3 are automated by the script.

Resolve

To resolve the issue:

  1. Download and unpack the archive to the /opt/workfusion/apps/ directory on the OCR server:

    curl 'https://spa-releases-private.s3.amazonaws.com/8.5.3%2Focr_patch_8.5.2.tar.gz?AWSAccessKeyId=AKIAILFB3XKWI2P5LQ6A&Expires=1562247053&Signature=mNUKK1Z8mZGP5dEPxADeAuzfWMw%3D' | tar -x

  2. In the ./ocr_patch_8.5-8.2 directory, open upgrade.sh for editing:

    $ cd ./ocr_patch_8.5-8.2/
$ vi ./upgrade.sh

  3. Change the following parameters in accordance to the environment configuration:

    • WORK_DIR: the directory, where OCR is installed to: /opt/workfusion/apps/ocr.

    • BACKUP_DIR: the directory, where the backup will be saved to: /tmp/ocr_backup.

    • WFUSER: the WorkFusion user (wfuser).

    • WFGROUP: the WorkFusion group (wfuser).

    • JAVA_PATH: a path for the latest Java binary: /opt/workfusion/lib/java/bin/java.

    • OCR_WORKER: the name of the OCR worker JAR: ocr-worker-8.5.1.jar.

    • OCR_REST - the name of the OCR Rest JAR: ocr-rest-8.5.1.jar.

    • OCR_TASK - the name of the OCR task JAR: ocr-task-8.5.1-jar-with-dependencies.jar.

  4. Stop the OCR service:

    $ su - wfuser
$ ocr2-service stop

  5. Switch to a root user and run the upgrade.sh script:

    $ exit
$ whoami
root
$ ./upgrade.sh

Backup has been created in /tmp/ocr_backup
Copying artifacts
Patching abbyy-ocr
Patching ocr2.init
Patching etc/ocr-rest.yml
Patching etc/ocr-worker.yml

  6. Switch to the workfusion user, start the service and check if it works:

    $ su - wfuser
$ ocr2-service start
$ ocr2-service status

  7. Request and activate the ABBYY license.

    1. Prepare the license. Run the following command and save the output:
    $ curl -X POST http://127.0.0.1:9002/api/v1/cloud/prepareLicense

    1. Assign a new ticket to IT Ops and attach the command output to it.

    2. Save the license response to file license.response and run the command:

    $ curl -X POST --form license=@./license.response http://localhost:9002/api/v1/cloud/activateLicense
    1. Check that the license has been applied successfully:
    $ curl http://localhost:9002/api/v1/cloud/listLicenses

    For more information, see the OCR license guide.

  8. Go to Control Tower and run a test business process.

← PreviousNext →