About Features Downloads Getting Started Documentation Events Support GitHub

Love VuFind®? Consider becoming a financial supporter. Your support helps build a better VuFind®!

Site Tools


Warning: This page has not been updated in over over a year and may be outdated or deprecated.
configuration:ils:troubleshooting

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
configuration:ils:troubleshooting [2021/10/06 14:01] demiankatzconfiguration:ils:troubleshooting [2023/03/08 13:14] (current) demiankatz
Line 1: Line 1:
 ====== ILS Driver Troubleshooting ====== ====== ILS Driver Troubleshooting ======
  
-If you are having difficulty getting VuFind to talk to your ILS, this page offers tips that may help.+If you are having difficulty getting VuFind® to talk to your ILS, this page offers tips that may help.
  
 ===== 1. Check Configuration Files ===== ===== 1. Check Configuration Files =====
  
-Each driver has its own configuration file in the web/conf subdirectory of your VuFind installation.  For example, Voyager users need to fill in the Voyager.ini file.  Make sure you have configured your ILS correctly!+Each driver has its own configuration file in the $VUFIND_HOME/config/vufind directory inside your VuFind® installation. If you have not already, you should copy this file into your $VUFIND_LOCAL_DIR/config/vufind directory and configure it appropriately. Comments within each file should help to guide you. For example, Voyager users need to fill in the Voyager.ini file. Make sure you have configured your ILS correctly!
  
 ===== 2. Look for error messages in the browser debugging console ===== ===== 2. Look for error messages in the browser debugging console =====
  
-VuFind talks to your ILS in real time on search result pages.  By looking at these communications, you can sometimes find clues about what is going wrong.  Follow these steps:+VuFind® talks to your ILS in real time on search result pages. By looking at these communications, you can sometimes find clues about what is going wrong. Follow these steps:
  
   * Open your browser's debugging toolbar (hit F12 or select it from the appropriate menu).   * Open your browser's debugging toolbar (hit F12 or select it from the appropriate menu).
   * Switch to the toolbar's Net or Network tab, and make sure the panel is activated.   * Switch to the toolbar's Net or Network tab, and make sure the panel is activated.
   * Switch to the "XHR" sub-tab (XHR is short for XML-HTTP-Request, the communication method used for AJAX calls).   * Switch to the "XHR" sub-tab (XHR is short for XML-HTTP-Request, the communication method used for AJAX calls).
-  * Perform a search in VuFind.  You should see a line in the toolbar that says something like "GET JSON?method=getItemStatuses" Expand this line.+  * Perform a search in VuFind®.  You should see a line in the toolbar that says something like "GET JSON?method=getItemStatuses" Expand this line.
   * Click the "Response" tab of the getItemStatuses line.  This may show you an error message or some other helpful clue.  If you find the response hard to read inside Firebug, you can also right-click the line and "Copy Location" in order to paste it into another browser tab.   * Click the "Response" tab of the getItemStatuses line.  This may show you an error message or some other helpful clue.  If you find the response hard to read inside Firebug, you can also right-click the line and "Copy Location" in order to paste it into another browser tab.
  
-If you are seeing errors but don't know what to do about them, please get in touch with the [[https://lists.sourceforge.net/mailman/listinfo/vufind-tech|vufind-tech]] mailing list.+If you are seeing errors but don't know what to do about them, please get in touch with the [[https://lists.sourceforge.net/mailman/listinfo/vufind-tech|vufind-tech]] mailing list or use one of our other [[https://vufind.org/vufind/support.html|support options]].
  
 ===== Related Video ===== ===== Related Video =====
Line 23: Line 23:
 See [[videos:ils_drivers_1|ILS Drivers, Part 1]] for further discussion of ILS drivers. See [[videos:ils_drivers_1|ILS Drivers, Part 1]] for further discussion of ILS drivers.
 ---- struct data ---- ---- struct data ----
 +properties.Page Owner : 
 ---- ----
  
configuration/ils/troubleshooting.txt · Last modified: 2023/03/08 13:14 by demiankatz