GoAnywhere Director, Services and Gateway are IPv6 ready with support for dual-stack networks (running both IPv4 and IPv6). The only requirement is that the Java Runtime Environment (JRE) which the GoAnywhere product is running on supports IPv6 interoperability with the underlying operating system. This article covers the JRE requirements for an IPv6 configuration on Linux and Windows operating systems.
LINUX INSTALLATIONS
GoAnywhere is able to utilize IPv6 socket connections when running on Oracle JRE 1.6. This JRE is bundled with the standard GoAnywhere product installers for Linux, therefore no additional steps are needed to be IPv6 ready on Linux.
WINDOWS INSTALLATIONS
On Windows, issues exist in the NIO package of JRE 1.6 when attempting to utilize IPv6 socket addresses on Windows OS. While GoAnywhere is fully capable of supporting IPv6 addresses, the lack of support in the JRE will cause errors similar to the following
Better support for IPv6 addresses on Windows OS has been added in JRE 1.7. Since GoAnywhere is bundled with JRE 1.6 for Windows installations, GoAnywhere must therefore be switched to a JRE 1.7 or later to support IPv6 addresses. Follow the directions below to switch to JRE 1.7:java.net.SocketException: Address family not supported by protocol family: bind
at sun.nio.ch.Net.bind(Native Method)
at sun.nio.ch.ServerSocketChannelImpl.bind(ServerSocketChannelImpl.java:119)
at sun.nio.ch.ServerSocketAdaptor.bind(ServerSocketAdaptor.java:59)
at sun.nio.ch.ServerSocketAdaptor.bind(ServerSocketAdaptor.java:52)
GoAnywhere Director and GoAnywhere Services
The Windows service needs be adjusted to invoke the proper JVM during startup.
- In Windows Explorer, navigate to [INSTALL_DIR]\tomcat\bin where [INSTALL_DIR] is the folder where GoAnywhere is installed.
- Double click on the file [SERVICE_NAME]w.exe where [SERVICE_NAME] is the name chosen for the Windows Service during installation of GoAnywhere.
This launches the service configuration tool (see below): - Navigate to the ‘Java’ tab and click the ellipsis "…" button on the Java Virtual Machine field.
- Navigate to and select the file [JRE]\bin\server\jvm.dll
i.e. An alternate JRE path may look like C:\Program Files\Java\jre7\bin\server\jvm.dll - Click OK and restart the windows service.
GoAnywhere Gateway has a JRE configuration file that can be adjusted to alter the JRE used by the application during startup.
- In Windows Explorer, navigate to [INSTALL_DIR]\.install4j where [INSTALL_DIR] is the folder where GoAnywhere Gateway is installed.
- Open the file pref_jre.cfg with a standard text editor such as Notepad.
- Replace the existing entry with the new path to the jre. For example:
Old Entry
C:\Program Files\Linoma Software\GoAnywhere Gateway\jre
New Entry
C:\Program Files\Java\jre7 - Save the file and restart GoAnywhere Gateway.