Library Home Catalog My Library Account Room Reservations LibGuides LibGuide of the Month Resource of the Month Contact Us Give to the Library
In order to install and use CTK, you must:
a) be running Windows XP or later,
b) have installed and configured the ODBC drivers for Oracle, and
c) have defined an ODBC data source name for your production database connection in the ODBC Data Source Administrator (located under Control Panel > Administrative Tools > Data Sources (ODBC)).
The installation of Oracle and the configuration of the ODBC settings are not covered in this document.
To complete the CTK installation successfully, you will need to know:
a) the data source name (DSN) associated with your production database connection in the ODBC Data Source Administrator,
b) the Oracle database user ID and password,
c) the table prefix of your production database,
d) the path to your voyager.ini file, and
e) the path to the folder containing your tag tables.
Also, note that this process will require you to download files and to install programs. Be sure you have the necessary permissions before you begin.
01 Determine your version of the BatchCat interface.
Currently, the only BatchCat version which corresponds to Voyager 9.0.0 is BatchCat2009-00.dll. To determine your BatchCat version for any version of Voyager prior to Voyager 7, follow the following steps:
For versions of Voyager after Voyager 6, the BatchCat file will probably be located in a subfolder of the folder where Voyager was installed. Look for it in the folder C:\Voyager\System (substitute the folder where you installed Voyager for "Voyager" in the path).
02 Download the version of CTK that corresponds to your version of BatchCat from http://files.library.northwestern.edu/public/CatalogersToolkit/.
For BatchCat2009-00.dll this is the file 2009.00.2204.CatalogersToolkit.zip.
If you have difficulty obtaining the file, the contact (listed below) should be able to e-mail a copy that works with the University System of Georgia's current version of Voyager upon request.
03 Download the file CtkSupport.zip from the same site as in step 2 above.
04 Unzip the file that you downloaded in step 2 (again, for BatchCat2009-00.dll this is 2009.00.2204.CatalogersToolkit.zip), and run the extracted file setup.exe.
05 If prompted with a security warning stating, "The publisher could not be verified," click Run.
06 When prompted "Welcome to the ctk installation program"...
07 At the next dialog box, choose the directory where CTK will be installed. Either:
08 At the next dialog box, choose the program group where CTK will reside on the Start menu. Either:
09 When prompted "Cataloger's toolkit Setup was completed successfully" ...
10 Unzip the file CtkSupport.zip into the folder you chose as the destination of CTK in step 7.
11 Copy the following extracted files to the C:\Users\[your user name]\AppData\Local\virtualstore\windows (if you are using a version of Windows later than XP) and/or the C:\windows folders:
ctkv.ini validit.ini verifit.ini vgerread.ini
Do not move the other extracted files.
12 Run CTK.
13 Open the Options dialog by clicking on the icon.
14 Click on the Connections tab, and then click Add.
15 Under add/change a connection, enter the following values:
16 Click on OK inside the add/change a connection area.
17 Enter the full path of the folder containing the voyager.ini file (the one that points to the production database) in the box at the bottom of the dialog box. Do not include the name of the file itself. End the path with a "\" (example: C:\Voyager\). Click OK.
18 At this point, CTK should automatically close (if it does not, close it manually). Restart CTK. Click on the options button and connection tab again, making sure that both the name of the connection you entered, and the path to the voyager.ini file, have been retained.
19 Click on the Institution codes tab. You should enter the code you would like CTK to supply in the MARC 040 field when it creates new bibliographic or authority records. For example, you may want to use your institution's OCLC symbol in the "Institution code for the 040 field of bibliographic records" box, and your institution's MARC organization code in the "Institution code for the 040 field of authority records" box.
20 Click on the Button Details tab. Click on the BAM button to view the settings for the validation and verification module. Click on the Files tab. Enter the following values:
21 Click OK.
CAUTION: This completes only the initial portion of the installation: establishing a connection between CTK, your production database, and your local files. Since CTK is such a powerful program, there are many further settings that a cataloger needs to look at, before the program is used to work on records.
For example, the General tab under Options has settings for the cataloging "happening" location and the Voyager owning library which will be used by CTK as it works on records. These may need to be adjusted during the course of work.
Other important settings include all of those that can be accessed under the options button, and include the many tabs under Options > Button Details > BAM. No attempt will be made to discuss them in this document. Look at these options (and their descriptions in the online manual) and make sure you understand their implications, before proceeding.
Installing the Correction Receiver
In the course of its work, the Correction Receiver will need to use a folder called the "approved queue" to hold pending correction requests. This can be any folder that you have permission to read from and write to.
Before you begin, make sure:
a) that you have installed CTK and that your connection was established successfully,
b) that you know the information required for installing CTK (items a-e prior to CTK step 01), and
c) that you have created a folder to serve as your approved queue, or selected an already existing folder for this purpose.
For more detailed information about the Correction Receiver, and its installation, see the Word document entitled "Making Changes to Headings"(available here).
01 Download the version of the Correction Receiver that corresponds to your version of CTK from http://files.library.northwestern.edu/public/CorrectionReceiver/.
For example, if you installed 2009.00.2204.CatalogersToolkit.zip, than you need to download 2009.00.2204.CorrectionReceiver.zip.
02 Unzip the file that you downloaded in step 1 and run the extracted file setup.exe.
03 If prompted with a security warning stating, "The publisher could not be verified," click Run.
04 When prompted "Welcome to the Correction receiver installation program"...
05 At the next dialog box, choose the directory where the Correction Receiver will be installed. Either:
06 At the next dialog box, choose the program group where the Correction Receiver will reside on the Start menu. Either:
07 When prompted "Correction receiver Setup was completed successfully" ...
08 Run the Correction Receiver program.
09 On the menu bar, click Options. Next, click on the Approved queue tab, and then on the Add... button. Enter the full path to the folder which you have chosen to use as your approved queue, including the name of the folder itself, and click OK in the Add an approved queue dialog (remember to end the path with a "\").
10 Next, click on the ODBC connection tab, and enter the following values (use the same values entered in step 15 of the CTK installation):
11 Next, click on the Voyager tab, and enter the following values (While different values are possible, in most cases you will want to enter the same values entered in steps 15 and 17 of the CTK installation):
12 Next, click on the Validation tab, and enter the following values:
13 Click on OK to close the Options window. Then, click on Exit on the menu bar to close the Correction Receiver program.
14 Run CTK and open the Options dialog. Click on the Button details tab and then on the red cross button. In the "Path for writing correction request" box enter the full path to the approved queue, which should be the same path that you entered into the Correction Receiver in step 9 (and must end with a "\"). Click OK.
CAUTION:This completes the basic installation of the Correction Receiver. Since this program, together with CTK, has the power to make large batch changes to your database, you should review the document"Making Changes to Headings," and the sections from CTK's online documentation on the yellow authority-related buttons (click here), before proceeding.
Among the settings that may need to be adjusted before batch heading changes are attempted are: the Validation scheme setting on the Correction Receiver's Validation tab, and the settings for the Red Cross button accessed through CTK's Button details tab.
It is recommended that you only perform test batch heading changes (by selecting the "This is a test" option on the Correction Receiver's Output handling tab) until you are confident that the Correction Receiver is performing as expected.
UPDATING CTK AND THE CORRECTION RECEIVER: The versions of CTK and the Correction Receiver that are made available for download and installation on the public web site are frequently updated (as often as several times a month). Features and settings are sometimes added, deleted, or changed, but in many cases the only changes are "behind the scenes." It is not necessary to always have the most recent version installed.
For those who wish to install the updated versions: it is not necessary to uninstall the older versions before installing the newer ones. Nor will it be necessary to re-enter your settings, since all settings are retained when the newer version is installed. After downloading the updated versions, simply extract and run the updated installation files (steps 4-9 [for CTK] and steps 2-7 [for the Correction Receiver] in the above instructions). Note that it is usually necessary to update all of the programs together. If after updating one program, the other does not run, simply installing the most recent version of the second program will usually solve the problem.
 This userid and password should be defined in SysAdmin to allow all of the actions you expect CTK to perform, which will probably include full privileges to add, delete, and change bibliographic and authority records. No password is needed to use CTK. Anyone with access to and permission to run CTK will have the ability to make all the changes to your database which this userid allows, but will not have any privileges which this userid lacks. Using multiple .ini files for CTK to place restrictions on individual operators is possible but not discussed here.
 Although the Voyager userid and password entered here do not need to be the same as those entered during the installation of CTK; nonetheless, as with that userid/password combination, make sure that the userid and password provided here are defined in SysAdmin to allow all of the actions you expect the Correction Receiver to perform, notably: full privileges to add, delete, and change bibliographic and authority records.
In addition to the GIL Service Sites, the author of this webpage can respond to questions about the installation process:
Adam KubikHead of Monographic CatalogingClayton State University678.email@example.com
© Copyright 2006.
Instructions written by Adam Kubik, Head of Monographic Cataloging, Clayton State University. Thanks to Tessa Minchew, Electronic Resources Librarian, North Carolina State University, for providing very thorough editorial assistance during their preparation. Any errors or omissions are the responsibility of the former. Direct questions/suggestions for improvements to: firstname.lastname@example.org.
Page created: Oct. 6, 2006
Last updated: Jan. 5, 2015