Skip to main content
  • Subscribe by RSS
  • Ex Libris Knowledge Center

    How do I set up Patron Self-Registration?

    • Product: Voyager
    • Product Version: 7.2.1


    How do I configure Patron Self-Registration (PSR) for Tomcat WebVoyage?


    1. Set up Tomcat process
      1. Add following lines to /m1/shared/apache2/conf/ConfiguredVirtualHosts/xxxdb_vwebv.httpd.conf JkMount /webvoyage ajp13_lb_xxxdb_PSR
        JkMount /webvoyage/* ajp13_lb_xxxdb_PSR
      2. Add entry to /m1/voyager/xxxdb/tomcat/PSR/conf/ Typically, use port xx33.
    2. Set up voytomcat.ini file
      1. Add IP and port of OPAC server to /m1/voyager/xxxdb/tomcat/PSR/context/webvoyage/ini/voytomcat.ini.
      2. You may need to use localhost for IP if server IP or hostname does not work.
    3. Make any additional customizations to remaining files.
      1. patron.xml: controls which form fields display on the page, and which ones are required
      2. patron.css: controls look and feel of the page
      3. patron.html: controls page itself (headers, scripts, logo, etc.)
      4. patron.xsl: edit only if you have advanced changes you must make
    4. Set Default Patron Group in System Administration > OPAC Configuration > Patron Self-Registration. Ensure patron group has permission for OPAC activities.
    5. Load URL defined in voytomcat.ini file.

    Additional Information

    See Voyager 6.5.4 WebVoyage User's Guide for additional information on customization.

    Note that this Article assumes you are running Tomcat OPAC as your primary OPAC on port 80, and the Classic OPAC is not being used.

    There is also a Patron RESTful Web Service, which allows a patron to self register, that is configured in Voyager System Administration > Web Services > Patron Self-Registration.  See the Developer Network:

    • Article last edited: 22-May-2020
    • Was this article helpful?