How To Setup IPv6 6.15.4
Created: 6.0.6; Updated: 6.0.6

Table of Contents

1 Introduction

IPv6 (Internet Protocol Version 6) is the successor, respectively the replacement, of the current version Internet Protocol, IPv4. The main problem using IPv4 is the growing shortage of IPv4 Addresses caused by the growing number of machines added to the internet.

IPv6 fixes a number of problems in IPv4, such as the limited number of available IPv4 addresses. It also adds many improvements to IPv4 in areas such as routing and network autoconfiguration. IPv6 is expected to gradually replace IPv4, with the two coexisting for a number of years during a transition period.

For this reason ePages supports IPv6 in version 6.0.6 and higher.

2 Requirements

2.1 Prerequisites - Linux

  ip -6 addr show

If command returns nothing or an error occurs, ask your system administrator to add the IPv6 network interface (ip -6 addr add ...).

  PATH=$PATH:/usr/sbin:/sbin iptables -L

If not, ask your system administrator to change the firewall settings.

2.2 Prerequisites - Windows

  Control Panel -> Network Connections -> Local Area Connection -> Properties
  -> Install... -> Protocol (Add) -> Microsoft TCP/IP version 6

  Control Panel -> Windows Firewall

   Administrative Tools -> IIS Manager -> Default Web Site
   -> IP Address (All Unassigned)

3 IPv6 Activation

Activate IPv6 either in the setup process or after the setup process. Windows only supports IPv6 activation after setup, skip to the respective section.

3.1 IPv6 Activation in Setup - Linux

This section shows how to IPv6 during the setup. This works only for Linux, not for Windows. See section 'IPv6 Activation after Setup' if you want to enable IPv6 in ePages on Windows.

Enable IPv6 by customizing your install.cnf file prior the installation process. You can skip the section "Post Installation" then.

3.2 IPv6 Activation After Setup

3.2.1 Environment Variables - Windows

Set EPAGES_ENABLE_IPv6=1. The environment variable EPAGES_IPLIST must contain the IPv6 address or the hostname (whether you use IPv6 addresses or hostnames in Webinterface.conf) if EPAGES_IPBINDING is set.

3.2.2 Environment Variables - Linux

Set EPAGES_ENABLE_IPv6=1. The environment variable LOCAL_IPS must contain the IPv6 address or the hostname (whether you use IPv6 addresses or hostnames in Webinterface.conf) if IP_BINDING is set.

If EPAGES_ENABLE_IPv6 is unset or 0, application server and request router only support IPv4. In this case, if application server or request router are configured to IPv6 in WebInterface.conf, errors will occur.

3.2.3 Host Names and Addresses

If a host name is resolved to both IPv4 and IPv6, then the IPv6 address is used if EPAGES_ENABLE_IPv6=1, otherwise the IPv4 address.

In Windows, "localhost" is resolved to both and ::1. In Linux, "localhost" is resolved to and "ipv6-localhost" is resolved to ::1.

If IP binding isn't used, a server can be connected with IPv6 and IPv4 clients if the server is set to IPv6 and has an IPv4 address too.

3.2.4 WebInterface.conf

All IPv4 addresses can be replaced by IPv6 addresses or relevant host names. The hostname must be short (without ".") or the result of the command `hostname --fqdn`.

In section "URLRewrite", line ExceptionHost, an IPv6 address has to be added in squared brackets, e.g.:

  ExceptionHost=shop.domain.ex [2001:4bd8:2:2:213:d3ff:fe62:f1f0]

When using IP-Masks the part of the IP following the wildcard ("*") will be truncated and is considered as the beginning of the IP to be tested. IPv6 masks must be written in short form, i.e.:

In case of a mixed IPv4/IPv6 communication beside the IPv4 mask the IPv4 mask in IPv6 notation must also exist, e.g. ::ffff:172.20.24.*.

If you use host names in WebInterface.conf, the corresponding IP entry or IP mask must also exit.

Host masks as follows are not allowed: [*]

3.2.5 epages.conf

IPv6 addresses can be entered in addition to IPv4 addresses and domain names.

3.2.6 Sybase Configuration

The Sybase interfaces file (Linux: $SYBASE/interfaces; Windows: %SYBASE%\ini\sql.ini) may contain IPv4 addresses, IPv6 addresses or host names.

For Windows, Sybase recommends to use IPv6 addresses instead of host names, see Hostnames will be resolved to IPv4 addresses on Windows, i.e. IPv4 is used if host names are entered in "sql.ini".

If you want to support IPv4 and IPv6, you will need to have entries for both protocols, e.g.:

    master tcp ether 17100
    query tcp ether 17100
    master tcp ether 17100
    query tcp ether 17100

The "*.res" files in $Sybase/ASE-15_0 can contain IPv6 addresses.

4 Start ePages with IPv6

Windows hosts must be rebooted to take effect of the changes.

After starting ePages, check if the services run with IPv6:


  netstat -a -n | perl -ne "s/ +/ /g; /TCP.*LISTENING/ && print"


  netstat -tulpn

If the web server runs with IPv6, you can use the IPv6 address in square brackets in the URL, e.g.:


Copyright ePages GmbH 2013