Body
Overview
This article is designed to act as a guide for the installation of the latest version (23,1) of the DuckDocs (OnBase) Unity Client. The client is only available for use on Windows. Depending on your level of access, you may need to reach out to IT support to assist you with this installation.
Prerequisites
The following software packages are required for successful installation of the Unity client. If these packages are missing, you’ll encounter an error, and the Unity client installation process will halt until they are installed.
Installers for these packages can be found along with the other files described in installation step 2 via software.uoregon.edu, below.
- Microsoft Visual C++ 2012 Redistributable (x64)
- Microsoft Visual C++ 2012 Redistributable (x86)
Installation
Select either the Via Software Center or Via software.uoregon.edu tab depending upon your situation.
Note: The upgraded software will be available to download from the Software Center beginning September 10th, 2024.
Follow the steps below:
- In the search box on your Windows task bar, search for and open Software Center.
- On the Applications page of the Software Center, search for OnBase Unity Client. Click on the application to open the Unity Client application details page.
- Verify that the client version is 23.1 on the application details page. If viewing version 23.1, click the Install button.
Note: The upgraded software will be available to download from software.uoregon.edu beginning September 10th, 2024.
Follow the steps below:
- Navigate to https://software.uoregon.edu. You may need to use the login button to access available software.
- Click on the Software Downloads link in the main navigation menu. Scroll down to find the OnBase Unity Client, and click the button labeled 23.1.9.1000. This will take you to the download page for the Unity Client and relevant prerequisites.
- Click the OnBase 23.1 Unity Client Installer link to download OnBase-23.1-UnityClient.zip.
- Locate the downloaded folder on your computer, right-click and choose Extract All….
- Navigate to the extracted folder, then navigate to OnBase-23.1-UnityClient > Unity Client.
- Right-click on both the setup.exe and Hyland Unity Client, and click Properties. If the option is available on the General tab in this Properties window, check Unblock.
- Double-click setup.exe to begin the installation. A welcome screen should appear. Click Next.
- Note: You may be prompted to install additional prerequisites. To proceed click Install.
- The following details explain how to navigate the steps in the installer:
- On the Destination Folder screen, accept the default Installation Directory and click Next.
- On the Custom Setup screen, click the drop-down menu next to Unity Client and select Will be installed on local hard drive. You may also choose to install the Virtual Print Driver Listener (required for using the Virtual Print Driver). Otherwise, accept the default setup options and click Next.
- On the Service Location screen, if prompted, update the fields to the following values and click Next.
Display Name: OnBase Prod SSO
Service Path: https://onbaseapp-prod.uoregon.edu/AppServer/Service.asmx
Data Source: ECM Prod
Use NT / LDAP Authentication: No
- On the Additional Settings screen, if prompted, accept the Default Mail Client option of Microsoft Outlook by clicking Next.
- If presented with additional Service Mode Options, accept the default options and click Next.
- On the Unity Configuration File Location screen, uncheck the option to deploy pre-configured Unity configuration file from specific location.
- On the Ready to install Hyland Unity Client screen, click Install.
- Once the installation is complete, click Finish.
Additional Required Configuration
Some additional configuration is required to login to the Unity Client when installing via software.uoregon.edu. Please complete the following before launching the application.
- Locate the obunity.exe.config in the OnBase-23.1-UnityClient folder you downloaded and extracted from software.uoregon.edu
- Navigate to the directory where you installed the Unity Client (default is c:\Program Files (x86)\Hyland\Unity Client)
- Copy the obunity.exe.config file to that location and specify that you would overwrite the existing file if prompted.
Log in
When you launch the client, you should be prompted to log in using Single Sign On (SSO), which requires your Duck ID and password. (Please note that those not on a campus network will need to use VPN in order to access the application.) Please be sure you choose OnBase Prod SSO, unless you are intending to access the Test version of the application.
Troubleshooting and Common Issues
Error appears: This installation must be launched with administrative privileges.
- Ensure you’re attempting to install via the setup.exe file, and not the “Hyland Unity Client” Windows Installer Package. Double-clicking on the setup exe file should launch the installer with the appropriate privileges
Pop-up appears: This application requires Microsoft Visual C++ 2012 Redistributable...
- Navigate to the Unity Client 23.1.9.1000 files described in installation steps 1 and 2 of the installation instructions via software.uoregon.edu.
- Download and run each of the Microsoft Visual C++ 2012 Redistributable installers (x86 and x64) to ensure the prerequisites have been installed.
Prompted for a username and password but no UO login screen appears
- The specified config file may not have been put in the correct folder to overwrite the default file. Ensure you have followed the Additional Configuration steps if attempting to install via software.uoregon.edu
The login or DUO screen appears but one or both are blank
- Close the window with the X and try launching again
I'm encountering additional issues with installing the client
Virtual Print Driver Installation (Optional)
The Virtual Print Driver is installed automatically if installing the Unity Client via Software Center. If you have installed the Unity client via software.uoregon.edu and would like to install the Virtual Print Driver, you may do so by following the steps in the Installing the OnBase Virtual Print Driver for the Unity Client article.