Install and upgrade for Relais ILL

Last updated
Save as PDF

Find information for installing and upgrading Relais version 2020.x for Relais ILL.

Supported operating systems

Windows XP Sp3
Windows 7 (32bit and 64bit)
Windows 8.1 (32bit and 64bit)
Windows 10 (32bit and 64bit)

Note: If you are not using the Relais Hosted service, please contact OCLC Support prior to upgrading to Relais 2020 for more detailed instructions.

Introduction

Starting with Relais 2019, a single build is used for all Relais products. At the beginning of the install/upgrade, you will be prompted to identify the product you use. The update will only apply to the changes relevant to the product you select.

Relais 2020, also includes auto-update software that will be installed on each workstation. This allows Relais to issue updates about which customers can be notified automatically. Once the notification is received the update can be downloaded and applied.

For Relais ILL customers installing to a shared network location, please be aware that the first workstation on which you install Relais 2020, you must select either the "Relais ILL (not hosted)" or "Relais ILL (hosted)" product as appropriate. Once that is complete, for all other workstations, select the 'Workstation' option from the list of products.

Notes

Important to note when installing Relais 2020.x:

You still need to run an application server with Relais 2020.
Changes incorporated in v2020.1 will mandate that ALL hosted customers migrate to v2020.1.
- Customers utilizing RapidILL will need to do so on or before mid-May 2020 in order to avoid service disruptions with the RapidILL service, as the current production Relais Windows applications do not contain support for TLS 1.2. Also, as of mid-May, access to the RapidILL API will require support for TLS 1.2., and v2020.1 will address this issue.
- For customers not using RapidILL interoperability, the current host post-to-web environment will not be maintained past August 31, 2020. There are security concerns with the existing hosted post-to-web functionality, so the new Post-to-Web development included within v2020.1 and Portal 3.1 have been completed to address this issue.
Challenges with the hosted site having been upgraded to 2020 but are still using the 2016 or 2019 versions:
- Customers utilizing RapidILL will need to update their hosted site on or before mid-May 2020 in order to avoid service disruptions with the RapidILL service, as the current production Relais Windows applications do not contain support for TLS 1.2. Also, as of mid-May, access to the RapidILL API will require support for TLS 1.2., and v2020.1 will address this issue.
- For customers not using RapidILL interoperability, the current host post-to-web environment will not be maintained past August 31, 2020. There are security concerns with the existing hosted post-to-web functionality, so the new Post-to-Web development included within v2020.1 and Portal 3.1 have been completed to address this issue.

Download and unzip Relais 2020.x

Ensure that you have Administrator rights on the workstation(s) to which you are applying the update.

Relais ILL customers who use a shared network drive, be sure to install/update your primary environment first by selecting Relais ILL (hosted) or Relais ILL (non-hosted) from the product list.

Once this is done, install/update your remaining workstations by selecting Relais Workstation from the product list.

Download the current build from the North American server.
Unzip the build to the desktop of the workstation. The setup icon displays.
Launch the setup icon and acknowledge any User Account Control messages.

Note: You no longer need to right-click the setup icon and 'Run as Administrator'. This requirement has been built into the application.

Initiate the installation

Once extracted, the Welcome to the Relais 2020 Installation window appears.
Click Next.
Accept the License agreement terms on the next screen.
Click Next.

Select which product to install

Enter the name of your organization (Optional).
Select the appropriate Product from the drop-down list.
Click Next.

Notes:

Product definitions are provided below.
If you are not sure which product to install, please contact OCLC Support.

Caution:

Relais ILL customers who use a shared network drive, be sure to install/update your primary environment first by selecting Relais ILL (Hosted Service) or Relais ILL (not hosted) from the product list.

Once this is done install/update your remaining workstations by selecting Relais Workstation from the product list.

Specify the destination folder

By default, the destination folder is "C:\Relais2020".

You will need to change the destination folder if your institution has a specific location to which you have already installed a previous version of Relais. Use the Change... button to select the destination folder you wish to use.

Once you have selected the destination folder for Relais 2020 click on Next.

Note: If you do not see the drive on which Relais is installed it is because the Windows UAC (User Account Control) is preventing the installation package from seeing any network locations. Follow the solution outlined in this Microsoft article: https://technet.microsoft.com/en-ca/library/ee844140(v=ws.10).aspx

Installation

Once you click Install, the install process starts. The entire process may take several minutes to complete.
Click Finish.

Install/update all remaining workstations

For Relais ILL customers using a shared network drive once the primary environment is installed/updated with the appropriate Relais ILL product repeat Steps C through G on the remaining workstations. Select Relais Workstation from the product list.

If you use the default Windows “SQL Server” driver to create the windows ODBC connection after installing 2020.x, ensure that the “UseEncryption” option is set to N in your Relais.ini

If you wish to enable the encryption of the database connection you must select a Native SQL server driver from the list of potential drivers when running the CreateODBC application.

Product Descriptions

Product	Description
Relais ILL (Hosted Service)	Installs/updates Relais ILL applications and dlls required by customers who are using the Hosted Service. Is installed on the workstation from which the Relais applications run, i.e., from a shared drive. Must be installed/updated on the workstation from with the Relais applications run prior to installing/updating the remaining Relais workstations.
Relais ILL (not hosted)	Installs/updates Relais ILL applications and dlls required by customers who are NOT using the Hosted Service Is installed on the workstation from which the Relais applications run, i.e., from a shared drive. Must be installed/updated on the workstation from with the Relais applications run prior to installing/updating the remaining Relais workstations.
Relais Workstation	Installs/updates only the dlls that needed for running Relais applications. No Relais applications are install on the workstation. For use by Relais ILL customers that run Relais applications on a shared drive. This option can be used to add the Relais workstation to your Relais hosted or non-hosted environment. Must be selected after you have updated either the Hosted Service or non-hosted product on your primary Relais Workstation. RelaisILL.dll (2016) RelaisNCIP2016.dll RelaisSearch2016.dll RequestFlow2016.dll RelaisDiscovery2016.dll RelaisEncryption2016.dll RelaisRequestFlow2016.dll RelaisUserControls.dll RelaisWebService2016.dll RelaisZeutschel2016.dll

Additional information

Issue running the CreateODBCexe utility on a staff workstation

This issue involves a scenario when a user with Administrator rights enters their credentials while running the CreateODBCexe utility on a staff workstation and the CreateODBC.exe utility completes successfully, but when they try to use Relais they still receive indications that the Relais applications cannot find the required ODBC entry.

In this situation, Windows has determined that the user running this utility does not have sufficient privileges to allow the CreateODBC.exe utility to complete successfully. This issue only occurs when running the CreateODBC.exe utility on Windows Vista and higher.

The user data sources are stored on the HKEY_CURRENT_USER tree in the windows registry

If someone with Administrator rights has entered their credentials into this prompt, the CreateODBC.exe utility completes successfully but the ODBC setting is created under that user's profile and not the user that is currently logged into the staff workstation.

The Relais ODBC entry must appear under the “User DSN” tab in the windows “ ODBC data Source Administrator”

Temporarily add the user's account into the windows local administrators group. This ensures the user in question has sufficient privileges to allow the CreateODBC.exe utility to add the required entries into the HKEY_CURRENT_USER tree under their profile in the windows registry.

Once this is done you can remove the user account from the windows local administrators group.

Configure for an encrypted connection in 2020.x

Starting in Relais 2016.x, the build no longer contains the SQL Native Client driver due to security concerns expressed about including potentially outdated versions of the driver. By removing this component from the build, if the default Windows SQL Server driver is used to create the windows ODBC connection, users will not be able to set the "UseEncryption" option equal to "Yes" in the Relais Windows client. To configure your system to allow for encrypted connections the following must be done:

Install the third party “Microsoft® ODBC Driver 13.1 for SQL Server” driver.

Link: https://www.microsoft.com/en-us/download/details.aspx?id=53339
Run the CreateODBC.exe Utility and select the “ODBC Driver 13.1 for SQL Server” from the list of approved drivers:

Note: Any version of the Native SQL server driver will work in this scenario. The root issue is that the default Windows “SQL Server” driver does not support the encryption of the database correction.