Upgrade Decipher IDP

Blue Prism recommend that customers use the latest version of SS&C | Blue Prism® Decipher IDP. Download the required files from the Decipher IDP portal page and update as described below.

Before you upgrade

Blue Prism strongly advise that existing Decipher IDP environments and databases are fully backed up prior to upgrade, enabling the restoration of a working environment in the event of a failed installation. The backup should be a system or full volume backup and not a backup of specific files within Decipher IDP.

When a Decipher environment is upgraded, all existing data, templates (Data Form Definitions) and learning is retained. Once the upgrade is complete, all existing information is retained, but new functions and features are now available for use, whether with newly created or existing Data Form Definition files.

Upgrade Decipher IDP 1.2 to 2.1

Decipher IDP version 2.1 follows version 1.2. There are no Decipher IDP releases between these versions.

To upgrade from Decipher IDP 1.2 to 2.1:

  1. Import the latest Decipher VBO, BPA Object - Decipher.xml, into Blue Prism and overwrite the existing VBO.

  2. Paste the BluePrismDecipher.VBO.Interop.dll file into C:\Program Files\Blue Prism Limited\Blue Prism Automate, and replace the existing file.

  3. Decipher Licensing Service – Run the Decipher Licensing Service.msi and click through the install wizard, following the on-screen instructions as prompted. See Install Decipher licensing service for details.

  4. Decipher Server – Run the Decipher Server 2.12.01070.msi and click through the installation wizard, following the on-screen instructions as prompted. The installation wizard will display your current settings. Click Edit to amend the settings or create a new reporting database (see below for details), or click Install to continue. See Install Decipher server for details.

    5. To create a new, separate reporting database as part of this Decipher IDP upgrade (optional):

    1. Click Edit on the Setup configurations summary screen.

    2. The Configure Server Settings screen displays.

    3. Select Enable reporting database.
      • If the existing reporting database is on the same server as Decipher Server, but you want to create a database on a separate server, deselect Reporting database on same server. The Reporting Database Server Configuration screen displays. Add the location and credentials for the reporting database server and click Next.
    4. Click Install to complete the installation, then Finish to exit the wizard.

  5. Decipher Web Client – Run the Decipher Web Client 2.11.12150.msi and click through the install wizard, following the on-screen instructions as prompted. See Install Decipher web client for details.

  6. Decipher Automated Clients – Run the Decipher Automated Clients 2.11.09201.msi and click through the install wizard. The install wizard will display your current settings. See Install Decipher automated clients for details.

    When upgrading Decipher Automated Clients, the destination folder and configuration settings are grayed out to ensure the existing installation configuration is retained.

  7. Decipher Server Plugin – Run the Decipher Server Plugin.msi and click through the install wizard. The install wizard will display your current settings. See Install Decipher server plugin for details.

    8. After upgrading to the latest version of the Decipher Server Plugin, the previous version will need to be manually removed. From the Windows Start menu, open Settings > Apps, select the Decipher Server Plugin and click Uninstall. This will be addressed in a future release.

Log locations

Decipher 2.1 introduced new default log locations for the Decipher clients. For details, see Decipher IDP 2.1 release notes. The log locations for existing installations upgrading to 2.1 will not be changed, but the client config files can be manually updated to use the new log location.

Follow the steps below to update the config files for the following clients: OCR, Classification, Capture, Export, Web client, Web SDK Service, and SDKWrapper.

  1. Locate and open the config file as an Admin. For details on locations, see Default locations.

  2. In the appSettings section, locate the LogRoot key and set to its value to "%PUBLIC%".

  3. Save the changes to the config file.

Upgrade Decipher IDP 1.1 to 2.1

To upgrade from Decipher IDP 1.1 to 2.1:

  1. Import the latest Decipher VBO, BPA Object - Decipher.xml, into Blue Prism and overwrite the existing VBO.

  2. Paste the BluePrismDecipher.VBO.Interop.dll file into C:\Program Files\Blue Prism Limited\Blue Prism Automate, and replace the existing file.

  3. Decipher Licensing Service – Run the Decipher Licensing Service.msi and click through the install wizard, following the on-screen instructions as prompted. See Install Decipher licensing service for details.

  4. Decipher Server – Run the Decipher Server 2.12.01070.msi and click through the installation wizard, following the on-screen instructions as prompted. The installation wizard will display your current settings. Click Edit to amend the settings or create a new reporting database (see below for details), or click Install to continue. See Install Decipher server for details.

    5. If required, the separate reporting database must be created when installing/upgrading the Decipher Server component.

    To create a new, separate reporting database as part of this Decipher IDP upgrade (optional):

    1. Click Edit on the Setup configurations summary screen.

      2. The Configure Server Settings screen displays.

    2. Select Enable reporting databaseand click Next.
    3. Click Install to complete the installation, then Finish to exit the wizard.

  5. Decipher Web Client – Run the Decipher Web Client 2.11.12150.msi and click through the install wizard, following the on-screen instructions as prompted. See Install Decipher web client for details.

  6. Decipher Automated Clients – Run the Decipher Automated Clients 2.11.09201.msi and click through the install wizard. The install wizard will display your current settings. See Install Decipher automated clients for details.

  7. Decipher Server Plugin – Run the Decipher Server Plugin.msi and click through the install wizard. The install wizard will display your current settings. See Install Decipher server plugin for details.

Following upgrade

The following scenarios should be considered after upgrading Decipher IDP:

Scenario

Action
You created a separate reporting database as part of the upgrade process.

If you need to copy existing reporting data from the Decipher database to the new reporting database see Reporting database configuration for details.
You bound the Decipher IDP 1.1 website to HTTPS, via Internet Information Services (IIS) Manager. Check whether the site setting has reverted to HTTP and rebind if necessary.
Caching issues are impacting the display of DFDs, document types, and batch types across multiple users. Clear your browser cache following upgrade. This can be done by pressing CTRL + F5.

If you encounter any issues after you have followed every step above and referred to the relevant sections of the install guide, please see Troubleshooting for further advice.