The following upgrade considerations have been compiled by OnBase subject matter experts. These upgrade considerations are general and applicable to most OnBase solutions and network environments and should be considered each time an upgrade is performed.
Carefully consider the impact of making any changes, including those listed below, prior to implementing them in a production environment.
For additional general information about upgrading OnBase, refer to the Upgrade Guidelines reference manual , and visit the Hyland Community at: https://www.hyland.com/community.
- Deprecation of Desktop
-
As of OnBase 17, OnBase Desktop has been replaced with the Unity Client for use with SAP ArchiveLink. If you had previously used OnBase Desktop, after installing the Unity Client for use with SAP ArchiveLink you must configure the new client as an OLE application in SAP as described in Define an OLE Application in the Configuration chapter of the MRG.
- Upgrading from 32-bit to 64-bit
-
Before installing the new 64-bit version of Connector for use with SAP Archive Link, you must remove any existing 32-bit .dll files. In addition, you must unregister the 32-bit Hyland.ArchiveLink.SSF.dll file and register the 64-bit Hyland.ArchiveLink.SSF.dll file.
- Back Up Your Database
-
Before upgrading your SAP solution, back up your database.
- Update Web.config File
-
Run the install wizard to automatically update the web.config file with most of the required information for your updated solution. If using Workflow, you must also manually update the file to set the AddToWorkflow setting to true.
- Keep Versions Consistent
-
If using the Business Indexing Connector for use with SAP ArchiveLink or the Unity Client for use with SAP ArchiveLink in conjunction with the Connector for use with SAP ArchiveLink, ensure that all products are updated to the same version of the software.
- Do Not Move the BIC .config File
-
If using the Business Indexing Connector for use with SAP ArchiveLink, leave the BIC .config file in the ArchiveLink folder. This ensures that any existing BIC configurations remain available.