Skip to main content
OCLC Support

Install and upgrade for Relais ILL

Find information for installing and upgrading Relais version 2016.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 2016 for more detailed instructions.

Introduction

Starting with Relais 2016, 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 apply only those changes relevant to the product you select.

Relais 2016 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 2016 must select either the "Relais ILL (not hosted)" or "Relais ILL (hosted)" product as appropriate.  Once that is complete, for all other workstation select the 'Workstation' option from the list of products.  

Notes

Important to note when installing Relais 2016.x:

  • You still need to run an application server with Relais 2016.
  • There is currently no end of life date for Relais 2014.3.1.
  • There will be no issues for customers continuing to run the Relais 2014 client once we have upgraded the Hosted Service to Relais 2016.

Download and unzip Relais 2016.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.

  1. Download the current build from the North American server.
  2. Unzip the build to the desktop of the workstation. The setup icon displays.

  3. 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

  1. Once extracted, the 'Welcome to the Relais 2016 Installation' window appears.
  2. Click Next.
  3. Accept the License agreement terms on the next screen.
  4. Click Next.

Select which product to install

  1. Enter the name of your organization (Optional).
  2. Select the appropriate 'Product' from the drop down list. 
  3. 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:\Relais 2016".

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 2016 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 

  1. Once you click "Install", the Install process starts. The entire process may take several minutes to complete.
  2. Once complete the following window displays.
  3. 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 2016.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 D2D

Install/updates Relais applications and dlls used by Relais D2D customers.

  • CreateODBC.exe   
  • MonitorQueues.exe
  • PrintRequest.exe 
  • ReprintRequest.exe     
  • UserMaintenance.exe    

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 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
  • RelaisNCIP2014.dll
  • RelaisSearch2014.dll
  • RequestFlow2014.dll
  • RelaisDiscovery2014.dll
  • RelaisEncryption2014.dll
  • RelaisRequestFlow2014.dll 
  • RelaisUserControls.dll
  • RelaisWebService2014.dll
  • RelaisZeutschel2014.dll

Install Relais ILL 2016.x  on Windows 10

When installing Relais ILL 2016.x client on a workstation ( OS: Windows 10 only) you may receive the error .

Cause: The Windows feature “.NET Framework 3.5 (includes .NET 2.0 and 3.0)” is not enabled prior to installing Relais 2016.

Error message:  "This setup requires the .NET Framework version 2.0.50727.  Please install the .NET Framework and run this setup again.  The .NET Framework can be obtained from the web.  Would you like to do this now?"

 Notes: 

  • This step can be done prior to starting the installation to avoid this issue during the install process.
  • Installing the  Windows feature “.NET Framework 3.5 (includes .NET 2.0 and 3.0)” takes about 30 min to complete.
  • This issue only occurs when the Relais ILL 2016.x client is installed on a workstation running Windows 10.
  • In most case this Windows feature is already turned and will not be an issue when a client installs 2016.x in their local environment.

Solution: Install “.Net Framework 3.5” on Windows 10 (Required).

  1. Press Windows Logo + keys on the keyboard.
  2. Type appwiz.cpl in the Run command box and press ENTER.
  3. In the Programs and Features window, click on the link Turn Windows features on or off.
  4. Check if the .NET Framework 3.5 (includes .NET 2.0 and 3.0) option is available in it.
  5. If yes, then enable it and then click on OK.
  6. Follow the on-screen instructions to complete the installation and restart the computer, if prompted.

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.

RelaisILL_FAQ1.png

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 2016.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:

  1. 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
  2. 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.

 

  • Was this article helpful?