Skip to main content
ExLibris

Knowledge Assistant

BETA
 
  • Subscribe by RSS
  • Back
    Voyager

     

    Ex Libris Knowledge Center
    1. Search site
      Go back to previous article
      1. Sign in
        • Sign in
        • Forgot password
    1. Home
    2. Voyager
    3. Knowledge Articles
    4. "Could not retrieve field order configurations" when open Cataloging after upgrade to 9.2.0

    "Could not retrieve field order configurations" when open Cataloging after upgrade to 9.2.0

    1. Last updated
    2. Save as PDF
    3. Share
      1. Share
      2. Tweet
      3. Share
    1. Problem symptoms
    2. Cause
    3. Resolution
      1. If you do not wish to use MARC Field Ordering
      2. Configure MARC Field Ordering
      3. Configure server.xml
        1. Configure RemoteAddrValve in tomcat's server.xml
    4. Additional Information
    • Product: Voyager
    • Product Version: 9.2.0
    • Relevant for Installation Type: Dedicated-Direct; Direct; Local; Total Care

    Problem symptoms

    • Log into Cataloging and see message "Could not retrieve field order configurations."
    • Click OK and able to work in client

    Cause

    MARC Field Ordering is new feature in Voyager 9.2.0 and has not yet been configured; this message will appear if the feature is not configured.

    If this feature has been configured, additional configuration for vxws may be needed.

    Operators can click OK on the message and move on to working in the client. This message does not impact any functionality other than MARC Field Ordering; all other functionality is available.

    Resolution

    If you do not wish to use MARC Field Ordering
    1. System Administration > Cataloging > Miscellaneous
    2. Remove any information from Reorder Service URL
    3. Click Save.

    Otherwise ... 

    Configure MARC Field Ordering
    1. System Administration > Cataloging
    2. Miscellaneous: ensure that Reorder Service URL is populated and has the correct IP address or hostname.
      Example: http://my.voyager.edu:7014/vxws/marc-field-order
    3. MARC Field Ordering Rules: Add at least one set of field ordering rules.
    Configure server.xml
    • The tomcat server.xml file contains Remote Address Valves, which may restrict access to vxws services including MARC Field Ordering.
    • The Remote Address Valve must either be correctly configured to allow IP's used by all workstations using cataloging; OR
    • The Remote Address Valve must be opened by adding a wildcard to the RemoteAddrValve stanzas.
    • Recommended practice, where possible, is to add an open wildcard to the Valve rule and utilize a network firewall to appropriately restrict access to VXWS services.

    You must stop Tomcat before editing the server.xml file.  See: Do I have to stop Tomcat to edit server.xml file?

    Configure RemoteAddrValve in tomcat's server.xml
    1. Navigate to /m1/voyager/xxxdb/tomcat/conf
    2. Open server.xml for editing.
    3. Find RemoteAddrValve parameter for vxws (e.g. <Valve className="org.apache.catalina.valves.RemoteAddrValve"...)
    4. The Remote Address Valve may be configured to allow only connections from local host by default. In this case the complete stanza will appear as:
    <Valve className="org.apache.catalina.valves.RemoteAddrValve" allow="127.\d+.\d+.\d+|::1|0:0:0:0:0:0:0:1"/> 
    1. The recommended practice, where possible, is to restrict access to vxws via network firewall rather than Remote Address Valve settings in server.xml. Consult the network administrator to verify firewall rules in place appropriately restrict IP addresses.
    2. If appropriate firewall rules are in place for the network, open the valve by adding an open wildcard to the end of the "Valve: statement. e.g.:
    <Valve className="org.apache.catalina.valves.RemoteAddrValve" allow="127.\d+.\d+.\d+|::1|0:0:0:0:0:0:0:1|.*"/>
    
    1. If modifying the Remote Address Valve Rules proves necessary, these allowed IP ranges are set by regular expression within the allow flag. A variety of utilities are available online to aid with configuring these rules. Contact Support for additional assistance.
    2. Confirm VXWS access is open to allowed machines by accessing <hostname>:7014. A successful test will result in a page containing the heading "Voyager XWS Interface".  Example:

      vxws test.jpg
       
    3. Note that if after following the above steps, the issue persists, try restarting Tomcat (see: How to Properly Restart Voyager, Apache and Tomcat).  

     

    Additional Information

    See also How to limit external access to the vxws web services

    More information on MARC Field Ordering in System Administration User's Guide

     


    Last updated: 25-Feb-2020

     

    View article in the Exlibris Knowledge Center
    1. Back to top
      • "Could not reorder fields" when using https/SSL with your OPAC
      • "Error parsing date" in Primo extract log
    • Was this article helpful?

    Recommended articles

    1. Article type
      Topic
      Language
      English
      Product
      Voyager
    2. Tags
      This page has no tags.
    1. © Copyright 2025 Ex Libris Knowledge Center
    2. Powered by CXone Expert ®
    • Term of Use
    • Privacy Policy
    • Contact Us
    2025 Ex Libris. All rights reserved