- Product: Voyager
- Product Version: 7.2 and greater
- Relevant for Installation Type: All
Prepackaged Reports (PPR, Reports.mdb) allow sites to make a read-only connection to Voyager's database on the server via Microsoft Access on a workstation using an ODBC connection. PPR allow institutions to query the database for information that may not be available via batch jobs or other reporting functions in Voyager.
These instructions cover installation of ODBC 10g Full Client Drivers and linking tables for pre-packaged reports for all currently supported versions of Voyager.
Voyager Prepackaged Reports using MS Access require the installation of Oracle Client to function correctly.
Voyager currently only supports the use of the 32-bit Oracle 10g Full Client installation package. Later versions of Oracle client and 64-bit versions of the software are not supported for use with Voyager.
Oracle 10g Client installer for 32-bit MS Access is available via FTP from downloads.exlibrisgroup.com using the 'odbc' user. See this Article for the download login and password. The filename is Oracle_10g_ODBC_Win7-10.zip and its date stamp is 10-13-2017. This file is 600MB. It can take a while to download.
Using Prepackaged Reports also requires that the Voyager Clients be installed on the workstation (see Overview of Voyager client installation process for detailed instructions on installing the Voyager clients).
- MS Access 2013 or greater, 32-bit
- Voyager Version 7.2 or greater
- Administrator privileges on PC
- Using an SFTP/FTP client, the ODBC installation package (Oracle10g_ODBC_Win7-10.zip) may be downloaded from downloads.exlibrisgroup.com using the odbc user. The password for this user is available from FTP Passwords for voyager, odbc, preview, and patch users.
- Create a folder in the root of your workstation's C:\ drive (for example: C:\orainst) to hold the installation package zip file, and unzip the package in that folder. Avoid using a deep file folder location, or placing the zip file in your Documents directory, or on the Desktop or on a shared drive.
Download this client and not any other Oracle ODBC client package. Support will only troubleshoot the Ex Libris ODBC installation package.
- 32-bit MS Access 2003 or greater (Not 64-bit). To determine your Access version:
- Open MS Access > File > Account > click About Access
- Box will pop up; note version at top of box.
- tnsnames.ora template (See attached)
- Hostname or IP address of your Voyager server; the Oracle read-only username and password (usually ro_xxxdb, where xxxdb is your Voyager instance name)
Follow all of the steps below. Do not deviate from the instructions. Install only the installation package specified in the previous section.
BEFORE YOU BEGIN: Restart your PC.
- Reboot the PC and then login with an account that has full administrative rights.
- Avoid opening any unnecessary programs. Turn off anti-virus protection temporarily (if possible).
- Completely remove any Oracle 10g Client which was installed previously. Any later versions of Oracle Client (e.g. Oracle 11g) should also be uninstalled if possible, to aid in preventing any complications. After any such uninstalls, reboot your PC again.
- From the unzipped Ex Libris ODBC installation package, run setup.exe
- Click "Next."
- Select "Administrator" as the installation type, and click "Next"
- In Specify Home Details verify directory names and paths do not have a "1" or an "_1" at the end of the Name or Path. If they do, just remove it so that the Name ends in "home" and Path ends in "client". Click Next.
- At Available Product Components, click "Next"
- At Product-Specific Prerequisite Checks", click the check box next to any errors and select "Yes" in any "Warning" dialogs.
- At "Summary select "Install", installation will run for a few minutes.
- At "Oracle Net Configuration Assistant" select "Perform Typical Configuration" and click "Next". And click Next on the following screen.
- Once the installation has completed Click "Finish" -> "Exit" -> "Yes"
- Open the attached tnsnames.ora template in a plain-text text editor (e.g. Notepad)
- In tnsnames.ora replace xxx.xxx.xxx.xxx with the IP or host name of the Voyager server.
- Copy the configured tnsnames.ora file to C:\oracle\product\10.2.0\client\network\ADMIN\
- Check permissions on tnsnames.ora to ensure "Full Control" is granted to "Authenticated Users"
- Locate and run the correct odbcad32.exe file for your Windows O.S. System Type (found in System > About > System Type) as Administrator (Right Click -> 'Run as Administrator'):
- For 64-bit Windows O.S. System Type: C:\Windows\SysWOW64\odbcad32.exe
- For 32-bit Windows O.S. System Type: C:\Windows\System32\obdcad32.exe
- Select the "System DSN" tab and select "Add."
- Select the driver "Microsoft ODBC for Oracle."
- Enter the following values:
Data Source Name: VGER
Username: ro_xxxdb (Replace 'xxxdb' with the db name of the voyager instance)
- Click 'OK' to close odbcad32.exe
- Open Reports.mdb from C:\Voyager\Access Reports\
(Make sure the Reports.MDB file that you are using is for the correct version of Voyager you are running)
- Select "External Data" from the MS-Access Ribbon, select "New Data Source", then select "From Other Sources" and select "ODBC Database"
- Select "Link to the data source by creating a linked table."
- Select the "Machine Data Source" tab.
- Select "VGER" and click "OK."
- Enter the following values and click "OK":
User Name: ro_xxxdb (Replace 'xxxdb' with the db name of the voyager instance)
- Click "Deselect All" (this can take a minute or so), and then click "OK." You can also check the "Save password" box.
- Locate the navigation pane on the left hand side of the screen in MS-Access. At the top of the navigation pane select the drop down menu, and change the selection to "Forms".
- Open "Build Database Links to Voyager" form.
- Enter the following values and select "Connect"(Replace 'XXXDB' with the db name of the Voyager instance):
ODBC Name: VGER
Connect String: VGER
DB User ID: ro_xxxdb
Tablespace: XXXDB (typically you will want to use ALL CAPS for the Tablespace name)
If you get errors, double-check your credentials are correct and enter ALL CAPS for the Tablespace name, then re-try this step.
- If successful, results indicating that links are being built successfully will appear as below. Be patient, this process can take 30 minutes or longer to complete successfully. When successfully completed, the "Cancel" button will be grayed out (inactive), and the "Connect" and "Close" buttons will be active. Select "Close". You are done.
Otherwise, if failures occur, double-check the configuration and permission of tnsnames.ora, and the configuration of the DSN. For further assistance open a support case with Voyager support.
- Article last edited: 18-Dec-2020