TCPGUI_PUBLIC_IPADDR
Platforms
Non-z/VM, 17.5 and later
Abstract
Sets the public (external) IP address for the LISTSERV web interface when running on a cloud service (e.g., Microsoft Azure) where the virtual machine's internal address is mapped to an external address.
Example
|
z/VM: |
<not available> |
|
Unix: |
TCPGUI_PUBLIC_IPADDR="aaa.bbb.ccc.ddd" |
|
Windows: |
TCPGUI_PUBLIC_IPADDR=aaa.bbb.ccc.ddd |
Details
LISTSERV 17.5 contains a new site configuration variable for LISTSERV sites running in virtual (cloud) services such as Microsoft Azure and Amazon AWS (but not limited to those services). Typically, a virtual server is assigned a non-routable internal IP address belonging to one of the three private class ranges, as opposed to a routable IP address facing the public Internet. This provides security for operations being conducted strictly within the cloud that have no reason to allow general access from the Internet.
For a virtual machine running LISTSERV, a static external IP is required in order for mail and web traffic to reach the server. In Azure (for example) this is done by obtaining Public IP Prefixes which contain a block of external IP addresses, and assigning one of the IPs in the block thus obtained to the virtual machine running LISTSERV.
This is all well and good for SMTP mail, but the LISTSERV web interface will be listening on the internal (private) address by default (the existing TCPGUI_IPADDR configuration variable MUST be set to the internal address in order for WA to talk to LISTSERV). In order to tell the web interface to listen to the external (public) IP address, the new configuration variable TCPGUI_PUBLIC_IPADDR is used. We recommend that the variable be configured manually in the site-level configuration file rather than in the web interface.
Default Value
Not set.
Wildcards
Not allowed.
See also