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

    Configuring Apache and WebVoyage for sites with different internal and external IP addresses

    • Article Type: General
    • Product: Voyager

    Description:
    Configuring Apache and WebVoyage for sites with different internal and external IP addresses

    Resolution:
    For example, imagine that your server's internal IP is 10.0.0.1 and its external IP, for outside users, is 123.45.67.89. You also use the hostname, voyager.college.edu, to connect to WebVoyage:

    1) In the /m1/shared/apache2/conf/ConfiguredVirtualHosts/xxxdb_vwebv_httpd.conf file, the server hostname should be used for ServerName in order to map to the internal IP address, instead of using the external IP address. If the external IP address is used, it can't map to the internal IP address.
    Examples:
    ServerName voyager.college.edu (Correct)
    ServerName 123.45.67.89 (Wrong)

    2) For the Virutal Host portion of the httpd.conf file, use the internal IP address, shown as below:
    NameVirtualHost 10.0.0.1
    <VirtualHost 10.0.0.1>
    ServerAdmin root@10.0.0.1
    ServerName voyager.college.edu

    </VirtualHost>

    3) All other connections to the server must use "localhost", 127.0.0.1, or the internal IP address of the server. Examples:

    /m1/voyager/xxxdb/tomcat/vwebv/context/vwebv/WEB-INF/web.xml:
    <context-param>
    <description>
    The host of the voyager XServices.
    </description>
    <param-name>XServiceHost</param-name>
    <param-value>localhost</param-value>
    </context-param>

    /m1/voyager/xxxdb/tomcat/vxws/ini/VXWS.ini:
    [xxxdbOPAC]
    # configuration for a Voyager OPAC connection
    HostName=localhost
    PortNum=7000
    ServerAppCode=OPAC

    The essential point is that every setting on the server itself should refer to the internal address that the server is actually using. The external address is bound to a network device, like a router, that forwards traffic into the internal network, where the internal address is used. The server itself is never aware of the external address.


    • Article last edited: 3/19/2015
    //Feedback