Jump to: navigation, search

IPv6 Resolution

Overview

Platform SDK provides two connection configuration options that control IPv4/IPv6 address resolution:

Option Name Java Constant Values Description
enable-ipv6 Connection.ENABLE_IPV6_KEY 0 (default)

1

This option enables and disables IPv6 support.

When set to 0, IPv6 support is disabled, even if IPv6 is supported by the platform.

ip-version Connection.IP_VERSION_KEY 4,6 (default)

6,4

Defines the order in which connection attempts will be made to IPv6 and IPv4 addresses. Option values do not contain spaces.

This option has no effect if the option enable-ipv6 is set to 0.

Note: This option only applies to clients.

Note: In Java you can use the predefined value constants: Connection.IP_VERSION_4_6 or Connection.IP_VERSION_6_4

Warning: A bug in Java 5 or Java 6 causes a problem when opening IPv6 connections on Windows (http://bugs.java.com/view_bug.do?bug_id=6230761).

To enable the use of a Netty connection with OIO transport, use one of the following methods:

The following workarounds are available:

  • update to JDK 6 update 41 or later
  • start your Java application with the follow JVM option: -Dcom.genesyslab.platform.commons.connection.impl.netty.transport=OIO
  • include the following code at the beginning of your application, before any Platform SDK classes are used:
    System.setProperty(NettyConnectionFactory.TRANSPORT_TYPE_PARAMETER, "OIO");

For additional information about working with IPv6, refer to the Networking IPv6 User Guide for JDK/JRE 5.0 (http://docs.oracle.com/javase/1.5.0/docs/guide/net/ipv6_guide/index.html).

Code Samples

[+] Genesys Server needs to open the IPv6-only port for listening


[+] Genesys Server needs to open IPv4-only port for listening


[+] Genesys Server needs to open IPv4/IPv6 dual stack port for listening


[+] Genesys application needs to open connection to IPv6 network interface of backend server


[+] Genesys application needs to open connection to IPv4 network interface of backend server


[+] Genesys application needs to open connection to IPv6 or IPv4 network interface of backend server, with explicit order of preference (try IPv4 then IPv6)

Using the Application Template Application Block

Refer to the Using the Application Template Application Block article for details about defining the IPv6 options in Configuration Manager or loading connection configuration details.

Overview

Platform SDK provides two connection configuration options that control IPv4/IPv6 address resolution:

Option Name C# Constant Values Description
enable-ipv6 CommonConnection.EnableIPv6Key 0 (default)

1

This option enables and disables IPv6 support.

When set to 0, IPv6 support is disabled, even if IPv6 is supported by the platform.

ip-version CommonConnection.IpVersionKey 4,6 (default)

6,4

Defines the order in which connection attempts will be made to IPv6 and IPv4 addresses. Option values do not contain spaces.

This option has no effect if the option enable-ipv6 is set to 0.

Note: This option only applies to clients.

Code Samples

[+] Genesys Server needs to open IPv6-only port for listening


[+] Genesys Server needs to open IPv4-only port for listening


[+] Genesys Server needs to open IPv4/IPv6 dual stack port for listening


[+] Genesys application needs to open connection to IPv6 network interface of backend server


[+] Genesys application needs to open connection to IPv4 network interface of backend server


[+] Genesys application needs to open connection to IPv6 or IPv4 network interface of backend server, with explicit order of preference (try IPv4 then IPv6)

Feedback

Comment on this article:

blog comments powered by Disqus
This page was last modified on June 20, 2017, at 22:57.