Installation Guide, Fix Summary, and Known Issue Workaround
| Product | Xerox DocuShare 8.0 |
| Patch | Patch 4 (ds800p4) |
| Applies to | Existing DocuShare 8.0 systems |
| Source | Xerox DocuShare 8.0 Patch 4 Release Notes |
Overview
DocuShare 8.0 Patch 4 (ds800p4) is a cumulative patch for DocuShare 8.0. It includes field issue fixes, security fixes, an upgrade of the bundled Solr search engine to version 9.10.1, and a browser compatibility update for the removal of client-side XSLT support. No configuration change is required after the patch is installed unless the Content Encryption known issue described in this article applies.
| Important: This patch can only be installed on an existing DocuShare 8.0 system. Upgrade paths from earlier DocuShare versions are documented in the DocuShare 8.0 release notes. |
What This Patch Changes
- Upgrades the bundled Solr search engine to version 9.10.1 through the automated installation process.
- Replaces browser-native XSLT rendering with a JavaScript bootstrap for affected pages, including Quick Search and content rules pages.
- Includes the field issue fixes and security fixes listed below.
- The remaining system requirements are the same as DocuShare 8.0.
Before You Install
Complete the following checks before starting the patch installation:
- Confirm that the target system is already running DocuShare 8.0.
- Review the DocuShare 8.0 system requirements and verify that the host meets them.
- Determine whether DocuShare 8.0 Patch 2 (ds800p2) was previously installed; this controls whether a reindex is required.
- If the PDF Forms add-on is installed, plan to reinstall it after applying Patch 4.
- If the DocuShare Tomcat 9.0.120 patch has not been installed, plan to install it before or after Patch 4.
Installation and Post-Installation Procedure
1. Back up the DocuShare system and confirm that you have a tested recovery path.
2. Install DocuShare 8.0 Patch 4 (ds800p4) using the supplied automated installation process.
3. Verify that DocuShare starts successfully and that the bundled Solr service is running.
4. If the PDF Forms add-on is installed, reinstall the PDF Forms add-on now.
5. If Patch 2 was not previously installed, run `dsindextool index_all` to reindex all content.
6. If Patch 2 was previously installed, no reindex is required for this patch.
7. Perform a functional check of login, Quick Search, content rules pages, document access, and any ConnectKey workflows used by the site.
| Reindex decision: Patch 2 not installed previously: run dsindextool index_all. Patch 2 installed previously: no reindex is required. |
Bug Fixes in This Release
| AR number | SPAR number | Description |
| 55662 | 4141 | In an approval workflow with more than one approver, a content rule using the (PS) Assign Routing Data action did not populate fields for the second approver, and that approver's comments were not added. |
| 65238 | 6165 | Scanning from a Xerox ConnectKey device failed when SAML authentication was enabled on the DocuShare server. |
| 82184 | 7666 | In ConnectKey, the Scan another document link shown after a scan completed was not clickable, so a further scan could not be started from that page. |
| 83451 / 84665 | 8443 | Cutting, pasting, or deleting documents and collections could stop responding and require a server restart. The affected operations now release their processing slot correctly. |
| Various | Various | Various security fixes. |
Known Issue: Content Encryption and Full-Text Search
On systems with Content Encryption enabled, documents added after Content Encryption was turned on may not be returned by full-text searches. Property and metadata searches are not affected. Documents indexed before Content Encryption was enabled remain searchable, so the issue may not be immediately apparent. The issue affects systems upgraded from an earlier DocuShare release; new installations are not affected.
| Warning: Do not reindex affected content until the Index Server classpath change has been confirmed. Reindexing first can add documents with metadata only and remove extracted text that was previously searchable. |
Workaround
Add the Content Encryption library to the Index Server classpath:
1. Stop DocuShare.
2. Open `<DSHome>\config\Monitor.xml` and locate the `<Server>` block whose `<Name>` is `IndexServer`.
3. Append `;+DSH+\lib\cryptoContent.jar` to the `<StartJVMClassPath>` element within that block.
4. Save the file and restart DocuShare.
5. Confirm that the change took effect. The effective classpath is written to `Monitor.log` each time the JVM launches, and the `dsix` command line must list `cryptoContent.jar`.
6. Only after the classpath change is confirmed, reindex the affected content. The classpath change is not retroactive.
Validation Checklist
- DocuShare 8.0 Patch 4 is installed successfully.
- Solr reports version 9.10.1 and is available to DocuShare.
- The correct reindex decision was followed based on the prior Patch 2 installation state.
- The PDF Forms add-on was reinstalled, if applicable.
- Quick Search and content rules pages render correctly in supported browsers.
- ConnectKey scanning and the Scan another document workflow work as expected, if used.
- For Content Encryption systems, `cryptoContent.jar` is present in the effective Index Server classpath before reindexing.