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