Tungsten Automation

Kofax PSIsafe API 12.2.0 Fix Pack 5

Build date: April 04, 2024

© 2024 Tungsten Automation. All rights reserved.
Use is subject to license terms.

Introduction

Install Kofax PSIsafe API 12.2.0.5 to resolve the issues listed below.

Issue resolved in this fix pack

ID Issue
2099272 Resolved an issue related to multi-threading while reading a file stream that caused large files to become unreadable after upload.

Issues resolved in previous fix packs

Fix Pack 4


Self-Service Password Change: Added support for self-service password changes. See details in the PSIsafe Web 12.2.0.3 Readme.


Fix Pack 3

ID Issue
1977788 Resolved an issue when browsing attachments within a folder containing a large number of documents.
1955135 Added EULA and Terms of Service documents to PSIsafe API Source code.
1943542 Added new API call SetDocumentParentIDAsync.
1941867 Resolved an issue where a verbose error message was returned by PSIsafe API.
1861090 Resolved an issue where PSIsafe Web content revealed version information.

Fix Pack 2

ID Issue
1900071 Document Preview: Document displayed corrupt preview for some PDFs.
1857600 Upgraded ASPOSE SDK to Version 22.9 or later.

Fix Pack 1

ID Issue
1914828 Certain documents could not be searched with Template = "Blank".
1889763 Folder Indexes of type DateTime could not be set to blank/empty when creating or editing a folder.
1828148 An error message displayed the cabinet ID instead of the cabinet name.

Applies to

This fix pack is cumulative and includes the resolved issues released in previous Sample Product 3.0.0 fix packs.

Apply this fix pack to update any of the following versions:

Files included

This fix pack includes the following files.

File name Version
KofaxPSIsafeAPI-12.2.0.5.ZIP 12.2.0.5.0.190
ReadMe-KofaxPSIsafeAPI-12.2.0.5.htm N/A
Deployment Details

Full product installation

Follow this link to perform a complete PSIsafe API installation: Kofax PSIsafe API Installation Guide: On-Premise: New Installation

Prerequisite: Your database administrator should ensure the PSIsafeAPIDatabaseUpdates.sql script (included) is applied to your Kofax PSIsafe 12.1.3.7 or higher database for correct product functionality.

Install this Fix Pack

Update PSIsafe API (on-premise)

A Kofax PSIsafe Web installation consists of a website hosted in IIS, the Kofax PSIsafe API, PSIsafe SignalR and the PSIsafe API Server that runs as a Windows Service. To upgrade an existing Kofax PSIsafe API or legacy PSIGEN PSIsafe API:

Prerequisite Note: Your database administrator must ensure the PSIsafeAPIDatabaseUpdates.sql script (included) is applied to your Kofax PSIsafe 12.1.3.7 or higher database for correct product functionality. See the Kofax PSIsafe API Installation Guide: On-Premise: New Installation for more information.

Stop PSIsafe API Server Service and PSIsafe API website

  1. From the Start Menu, launch Services.msc.
  2. Select PSIGEN Affinity Server and right-click.
  3. Select Stop from the context menu.
  4. From the Start Menu, launch Internet Information Services (IIS).
  5. Find your PSIsafe API website.
  6. Stop your PSIsafe API website.

Back up PSIsafe API Server Service and PSIsafe API website

  1. Create a backup copy of the current Kofax PSIsafe Server and the API folders to be updated.

    Default path: "C:\Program Files\PSIsafe\PSIsafeAPIServer" and "C:\Program Files\PSIsafe\PSIsafeAPI"

  2. Save the copies to a separate, safe location.

Update Kofax PSIsafe API Server or legacy PSIGEN PSIsafe API Server

  1. Right-click KofaxPSIsafeAPI-12.2.0.5.ZIP, and click Properties. If there is an "Unblock" check box, select it and click Apply.
  2. Extract KofaxPSIsafeAPI-12.2.0.5.ZIP to a location on the server.
  3. Follow all instructions in the topic Upgrade existing API installation located in the Kofax PSIsafe API Installation Guide: On-Premise: New Installation

Deploy the PSIsafe SignalR Service..

  1. Enable the WebSocket Protocol on the server. This can be found in the Application Development Section.
  2. For more information regarding WebSocket, search "WebSocket" at: https://learn.microsoft.com/
  3. Follow all instructions in the topic Kofax PSIsafe SignalR service deployment located in the Kofax PSIsafe API Installation Guide: On-Premise: New Installation.

Start PSIsafe API Server Service and the PSIsafe API website

  1. From the Start Menu, launch Services.msc.
  2. Select PSIGEN Affinity Server and right-click.
  3. Select Start from the context menu.
  4. From the Start Menu, launch Internet Information Services (IIS).
  5. Find your PSIsafeAPI and PSIsafeSignalR website.
  6. Start your PSIsafeAPI and PSIsafeSignalR website.

Test your PSIsafe API Service and PSIsafe API upgrade

  1. In IIS Manager under Default website, select your PSIsafe API website.
  2. On the right side of IIS Manager, select Browse.
  3. Append /api to the URL within the address bar of your browser to confirm that the API name and version appear on the page.
  4. Test that the API can connect to your PSIsafe database by appending the following to the URL:

    /databases?customercode=default

    Verify that names of your databases appear.