Examples of using NOTES.INI variables with IPv6
These examples show how to set NOTES.INI variables to support various platforms and configurations when using IPv6.
In these examples, support for NRPC and SMTP is configured. The other Internet servers are configured similarly to SMTP.
Example 1-- No IPv6 support
No change is required. IPv6 is off by default.
Example 2 -- UNIX™ platform supporting all valid IPv4 and IPv6 addresses
TCP_EnableIPv6=1
Example 2 assumes that no ports are bound to any addresses. By default, on UNIX™, the single unbound listening socket is IPv6. The IPv6 socket can receive connections from any IPv4 or IPv6 address.
Example 3 -- Microsoft™ Windows™ platform supporting all valid IPv4 and IPv6 addresses
TCP_EnableIPv6=1
TCPIP=TCP, 0, 15, 0
TCPIP6=TCP, 0, 15, 0
PORTS=TCPIP,TCPIP6
TCPIP_TCPIPADDRESS=0,9.33.162.84:1352
TCPIP6_TCPIPADDRESS=0,[fe80::209:6bff:fecd:5b93]:1352
SMTPNotesPort=TCPIP,TCPIP6
Example 3 assumes that no ports are bound to any addresses. On Microsoft™ Windows™, by default, the TCPIP6 port is an IPv6 socket because IPv6 is enabled. The TCPIP port is an IPv4 socket, because its bound address has the IPv4 format. Both listen to all addresses because the bound address is 0. The SMTPNotesPort variable is required to force the SMTP listener to listen on two sockets -- one for IPv4 and one for IPv6.
Example 4 -- UNIX™ (but not Linux™ 2.4) partitioned servers
Each server listens to its assigned IPv4 and IPv6 addresses only.
For each server:
TCP_EnableIPv6=1
TCPIP=TCP, 0, 15, 0
TCPIP6=TCP,
0, 15, 0
PORTS=TCPIP,TCPIP6
TCPIP_TCPIPADDRESS=0,9.33.162.84:1352
TCPIP6_TCPIPADDRESS=0,[fe80::209:6bff:fecd:5b93]:1352
SMTPNotesPort=TCPIP,TCPIP6
Example 5 -- Microsoft™ Windows™ (and Linux™ 2.4) partitioned servers
Each server listens to its assigned IPv4 and IPv6 addresses only.
For each server:
TCP_EnableIPv6=1
TCPIP=TCP, 0, 15, 0
TCPIP6=TCP, 0, 15, 0
PORTS=TCPIP,TCPIP6
TCPIP_TCPIPADDRESS=0,9.33.162.84:1352
TCPIP6_TCPIPADDRESS=0,[fe80::209:6bff:fecd:5b93%4]:1352
SMTPNotesPort=TCPIP,TCPIP6
The difference here is that Microsoft™ Windows™ and Linux™ 2.4 require the use of the zone in the address even for addresses bound to listeners if the address is a link local address. The same effect can also be achieved as shown in Example 5A.
Example 5A -- Microsoft™ Windows™ and Linux™ 2.4 partitioned servers
Each server listens to its assigned IPv4 and IPv6 addresses only.
For each server:
TCP_EnableIPv6=1
TCP_DefaultZone=4
TCPIP=TCP, 0, 15, 0
TCPIP6=TCP, 0, 15, 0
PORTS=TCPIP,TCPIP6
TCPIP_TCPIPADDRESS=0,9.33.162.84:1352
TCPIP6_TCPIPADDRESS=0,[fe80::209:6bff:fecd:5b93]:1352
SMTPNotesPort=TCPIP,TCPIP6
Example 6 -- Any client wants to make outbound IPv4 connections
No change required.
Example 6A -- A UNIX™ client (not Linux™ 2.4) wants to make an outbound IPv6 connection
TCP_EnableIPv6=1
Connect to an IPv6 address, or to a DNS or hosts file resident name that resolves to an IPv6 address.
Example 7 -- Microsoft™ Windows/Linux 2.4 client wants to make outbound connection via IPv6
TCP_EnableIPv6=1
Connect to an IPv6 address, or to a DNS or hosts file resident name that resolves to an IPv6 address. If the address is a link local address, it must include the zone, such as fe80::209:6bff:fecd:5b93%4, or the local NOTES.INI file must contain a default zone, or the zone must be included in the local bound address. Such addresses must NEVER be stored in DNS, in Server documents, or Connection documents. If an IPv6-capable computer running Windows™ XP enables IPv6 and it is DHCP, it will automatically have its QUAD A record stored in DNS and it is stored without a zone, because the zone is a local construct. Therefore, the ONLY way to use such a DNS entry is to have a default zone in NOTES.INI.
Example 7A -- Microsoft™ Windows™ / Linux™ 2.4 client wants to make outbound connection via IPv6
TCP_EnableIPv6=1
TCP_DefaultZone=4
Connect to an IPv6 address, or to a DNS or hosts file resident name that resolves to an IPv6 address. If the address is a link local address, it need not include the zone, such as fe80::209:6bff:fecd:5b93 because the zone is defaulted by the NOTES.INI variable.
Example 7B -- Microsoft™ Windows™ / Linux™ 2.4 client wants to make outbound connection via IPv6
TCP_EnableIPV6=1
TCPIP=TCP, 0, 15, 0
PORTS=TCPIP
TCPIP_TCPIPADDRESS=0,[fe80::209:6bff:fecd:5b93%4]:1352
Connect to an IPv6 address, or to a DNS or hosts file resident name that resolves to an IPv6 address. If the address is a link local address, it need not include the zone, such as fe80::209:6bff:fecd:5b93 because it is defaulted by the bound address's zone.
Enabling Internet protocols on both TCP/IP and TCP/IPV6 ports
Add the following settings to the file, NOTES.INI:
ldapnotesport=tcpip,tcpipv6
imapnotesport=tcpip,tcpipv6
smtpnotesport=tcpip,tcpipv6
pop3notesport=tcpip,tcpipv6