Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

Overview

Hyland Software's OnBase is a system for managing documents stored electronically, usually known as a document imaging system. This is a Windows client/server system used in many offices on campus.

Product Details

There were two OnBase client applications in use on campus: the traditional "thick" client, and the new Unity client with its Office-like ribbon.

The version of the Unity Client that is current is version 17.0 [17.0.0.45] as . As of 83/25/201709/2018, the new version will be 17 SP1 [17.0.1.75].

As of 8/25/2017, the "thick" client version is no longer distributed.Contact Russ Bauer for more information.

...

This software is supported by Russ Bauer in the EIS group in ITS. It uses a Carleton-based Microsoft SQL Server database, hosted on (as of 8/22/2014) onbasedb.ads.carleton.edu.

System Requirements

The OnBase Client hardware requirements are so low that any college-owned computer purchased and setup in the last four years should qualify.

...

That first component is part of every Carleton build of Windows 7 and later, and there is an installer available in the /wiki/spaces/TAR/pages/26444085 . The last has been added to the KBOX installer for the OnBase Unity Client. There is also an optional Virtual Print Driver component, which has been added to the KBOX installer.

Licensing Information

The OnBase clients, and the Virtual Print Driver, are freely distributable on campus. Specific stations will be licensed for indexing and for scanning documents into the system.

Licensing Restrictions

None for OnBase clients

Usage Restrictions

None for OnBase clients

Home Use

It is not recommend that this client be installed on non-college-owned computers. The Unity Client is available from off campus via Citrix (XenApp).

Lab and Classroom Availability

This is administrative software not used in labs or classrooms.

Rollout

On Friday, August 25March 9, 20172018, the OnBase servers were will be upgraded to version 17 SP1, and new Unity client 17 SP1 (17.0.01.4575) was will be rolled out to computers that had any old Unity or "thick" client. Compatibility with Microsoft .NET Framework 4.7 has not been tested, and since many other applications are reporting problems, and 4.7.1 are both compatible with and preferred for this new client, so the upgrade will not be offered through our campus WSUS server.

Users wishing to install the Unity client themselves (rather than letting the K1000 do it) may use the KBOX user portal to choose "Install Windows: Hyland Unity Client  17 SP1" anytime after 83/2509/20172018. Users needing the "thick" client should contact Russ Bauer for more information.

Installation Instructions

College Owned Equipment

The Hyland OnBase Client and Unity Client installers are available from the /wiki/spaces/TAR/pages/26444085 for all users.

Info

OnBase also requires the Microsoft .NET Framework 4.5.1 (Full) or later, which may not be present on the oldest workstations on campus. The .NET Framework 4 installer is also on the /wiki/spaces/TAR/pages/26444085 if you discover you need to install it as well. Then normal Windows Updates from our campus WSUS server will upgrade it to version 4.67.1 0 or later.

Step by step instructions for installing either the Unity client:

  1. Log in to the KBOX user portal.
  2. Click on the Software Library tab
  3. Click on the link to for "Install Hyland OnBase Client" or "Install Hyland Windows: Hyland Unity Client 17 SP1"
  4. Click Install Now
  5. There will be a cmd.exe window and a series of dialog boxes with progress bars.
    1. If the cmd.exe window goes away relatively quickly, the workstation may need to have the .NET Framework 4 installed first.
    2. The cmd.exe window will say "ignore errors until further notice", and then several errors will pop up as it attempts to uninstall all old clients.
    3. It will then say "errors are relevant again", but there will be one error that comes up virtually immediately that is very much like the previous errors. This one error is safe to ignore.
  6. You may or may not be presented with a dialog box about installing the Hyland Virtual Printer Driver. If prompted, install the driver. (If you are prompted, the VPDcertificate trick did not work.)
  7. When the installation is finished the cmd.exe window will disappear and the OnBase Client or Hyland Unity Client shortcut will appear on the Programs menu and desktop.
  8. Launch the OnBase or Unity client. It should launch without a login screen, using the context of the current Windows login. If an OnBase login screen is displayed, you probably tried launching it from a shortcut you created previously, so delete that old shortcut.

/wiki/spaces/itskb/pages/26120653 is the ITS restricted installation information.

Labs and Classrooms

To request this software be installed on a refreshing lab/classroom contact xxx

Personal Machines

Not applicable: use the Citrix service instead.

Citrix

The Unity Client is available in the Carleton Citrix service at https://citrix.carleton.edu . The Application Enabler feature may not work as well in the Citrix environment, however.

...

The next time this user gets back into Citrix, if Unity gets the same error, run the “OnBase Unity Client FIX for Error” again. The third time this user gets back into Citrix, if Unity gets the same error, run the “OnBase Unity Client FIX for Error” again. After running this fix 3 times, this user should never have to run it again (because it was run once on each of the 3 Citrix app servers). Then the user can right-click this FIX icon on the green Citrix page and choose Remove.

Who To Call

For OnBase questions, call the Help Desk at x5999.

Questions, Tips and Tricks

Technical Troubleshooting

Unity Client troubleshooting:

The Unity Client has been installed with an optional component called Application Enabler (AE), which allows the Unity Client to interface with other applications installed on the computer. Application Enabler is controlled by an XML configuration file that is continually being enhanced, and so needs to be updated occasionally on every computer to get the latest changes. To get the latest version of this file (CarletonAEconfig.xml), in the KBOX user portal, run the Kscript titled, "Update OnBase Unity Application Enabler".

Miscellaneous Information

.