Configure the Web clients for IPv6

Application Server

The steps that you use to configure IPv6 depends on the Application server that you are using. Choose the appropriate instructions for your environment.

Tomcat 8.x

The default installation of Tomcat does not support listening on the IPv6 protocol. Therefore, you must download latest APR library (tcnative-1.dll) and add an address parameter for the connector in the server.xml file. To do this, follow these steps:

1. Download latest APR library as appropriate for your architecture.

   Architecture	Download location:
   x86	http://archive.apache.org/dist/tomcat/tomcat-connectors/native/1.1.20/binaries/win32/tcnative-1.dll
   x64	http://archive.apache.org/dist/tomcat/tomcat-connectors/native/1.1.20/binaries/win64/x64/tcnative-1.dll
   IA64	http://archive.apache.org/dist/tomcat/tomcat-connectors/native/1.1.20/binaries/win64/ia64/tcnative-1.dll

2. Replace the default APR library with the one you downloaded.

   $Tomcat_Installation$\bin\tcnative-1.dll

3. Add an address parameter for the connector in the server.xml file as follows:

   <Connector address="[::]" port="8081" protocol="HTTP/1.1" maxThreads="400"
              connectionTimeout="20000"
              redirectPort="8443" />

4. Add an address parameter for the AJP connector in the server.xml file as follows:

   <Connector address="[::]" port="8008" protocol="AJP/1.3" redirectPort="8443" />

   Note Modify the server.xml file for each for Tomcat instance. To revert to IPv4, remove address parameter in the server.xml file.

5. Set serverHost parameter of the WEB-INF\web.xml to a valid IPv6 address:

   <param-name>serverHost</param-name>
   <param-value>2620:0:a17:e006:d024:1d09:c2f9:f03f</param-value>

   Note You do not need to use enclose the IPv6 address in the brackets ([]).

6. Access the Service Manager Web tier by using a correct URL as shown in the following example:

   http://[2620:0:a17:e006:4a8:91c1:c9cb:93dd]:8080/webtier-9.xx/index.do

WebSphere 8.5

To configure WebSphere for IPv6, follow these steps:

1. Set the serverHost parameter of the WEB-INF\web.xml file to a valid IPv6 address:

   <param-name>serverHost</param-name>
   <param-value>2620:0:a17:e006:d024:1d09:c2f9:f03f</param-value>

   Note You do not need to use enclose the IPv6 address in the brackets ([]).

2. Access the Service Manager Web tier by using a correct URL as shown in the following example:

   http://[2620:0:a17:e006:4a8:91c1:c9cb:93dd]:8080/webtier-9.xx/index.do

Web Server

The steps that you use to configure IPv6 depends on the Web server that you are using. Choose the appropriate instructions for your environment.

Apache 2.2 or 2.4

To configure Apache to use IPv6, you must download,modify, and recompile Apache.  To do this, refer to these example steps:

1. Download and install Perl from the following web site:

   http://www.activestate.com/activeperl/downloads

2. Download and install awk95.exe to some directory, for example, C:\Windows.  Rename the file to awk.exe.

3. Compile zlib. To do this, follow these steps:

   1. Download the source code for zlib from the following web site:

      http://www.zlib.net/

   2. Unzip the file to C:\ipv6\zlib.

   3. Run the following command to compile zlib:

      C:\ipv6\zlib\nmake -f win32\Makefile.msc

   4. If you receive an nmake fatal error code 0xc0000135, run the following command:

      C:\ipv6\zlib\vcvars32

4. Compile OpenSSL. To do this, follow these steps:

   1. Download the source code for OpenSSL from the following web site:

      http://www.openssl.org/

   2. Unzip the file to C:\ipv6\openssl.

   3. Run the following command to compile openssl:

      C:\ipv6\openssl\perl Configure VC-WIN32
      C:\ipv6\openssl\ms\do_ms
      C:\ipv6\openssl\nmake -f ms\ntdll.mak

5. Compile and modify Apache . To do this, follow these steps:

   1. Download the source code for Apache from the following web site:

      http://httpd.apache.org/download.cgi

   2. Unzip the file to C:\ipv6\httpd.

   3. Edit the httpd\srclib\apr\include\apr.hw file, and change the line #define APR_HAVE_IPV6 0 to #define APR_HAVE_IPV6 1.

      Copy the zlib and openssl folders from the previous steps to httpd\srclib.

   4. Run the following command to compile Apache:

      C:\ipv6\httpd\nmake /F Makefile.win INSTDIR="C:\Apache" installr

      Note You may encounter issues if you try to compile Apache. Specifically, you may receive the following errors:

      C:\Program Files\Microsoft SDKs\Windows\v6.0A\include\ws2def.h(91) : warning C4005: 'AF_IPX' : macro redefinition
              C:\Program Files\Microsoft SDKs\Windows\v6.0A\include\winsock.h(460) : see previous definition of 'AF_IPX'
      C:\Program Files\Microsoft SDKs\Windows\v6.0A\include\ws2def.h(127) : warning C4005: 'AF_MAX' : macro redefinition
              C:\Program Files\Microsoft SDKs\Windows\v6.0A\include\winsock.h(479) : see previous definition of 'AF_MAX'
      C:\Program Files\Microsoft SDKs\Windows\v6.0A\include\ws2def.h(163) : warning C4005: 'SO_DONTLINGER' : macro redefinition
              C:\Program Files\Microsoft SDKs\Windows\v6.0A\include\winsock.h(402) : see previous definition of 'SO_DONTLINGER'
      C:\Program Files\Microsoft SDKs\Windows\v6.0A\include\ws2def.h(206) : error C2011: 'sockaddr' : 'struct' type redefinition
              C:\Program Files\Microsoft SDKs\Windows\v6.0A\include\winsock.h(485) : see declaration of 'sockaddr'
      C:\Program Files\Microsoft SDKs\Windows\v6.0A\include\ws2def.h(384) : error C2059: syntax error : 'constant'

      These issue are caused by an improper include order between windows.h and the winsock2.h files in the apr library. To resolve this, make sure that winsock2.h is included before windows.h.

IIS 8.0 or 8.5

IPv6 is not supported for an IIS connector with Tomcat (mod_jk).