The format of the target address in the TcpIP, TcpIPv4, and TcpIPv6 schemes is as follows.
host:port-number
You can specify the host using a:
Simple host name; for example, george, server129, or localhost.
Fully qualified domain name (FQDN); for example, wilbur.example.com.
Dotted decimal IPv4 address; for example, 127.0.0.1.
Quadded hexadecimal IPv6 address enclosed in square brackets; for example, [fe80::bdf1:cbe:6902:7deb].
The TcpIPv4 scheme uses the IPv4 protocol, so quadded hexadecimal IPv6 addresses are not allowed.
The TcpIPv6 scheme uses the IPv6 protocol, so dotted decimal IPv4 addresses are not allowed.
The port-number value is a decimal integer in the range 1 through 65535.
When the host is a simple host name or an FQDN, resolution always returns TcpIPv6 addresses before TcpIPv4 addresses. When a specific protocol version is not specified, the first returned address is used.
The following examples show target addresses for the TcpIP, TcpIPv4, and TcpIPv6 schemes.
server=TcpIP://localhost:6005/48cf13df-bf6d-df11-87e2-2e5925024153
server=TcpIPv4://host.company.com:6005/48cf13df-bf6d-df11-87e2-2e5925024153?localHostname=aHostName
server=TcpIPv6://[fe81::6fe:7fff:fe87:bd20]:6005/48cf13df-bf6d-df11-87e2-2e5925024153?localPort=54321
server=TcpIP://127.0.0.1:6005/48cf13df-bf6d-df11-87e2-2e5925024153/48cf13df-bf6d-df11-87e2-2e5925024153
By default, the environment identity specified in the server command line argument of a client shortcut must match the identity of the database server, as shown in the following example.
server=TcpIp://localhost:6005/48cf13df-bf6d-df11-87e2-2e5925024153
If zeroes can be specified for the environment identity in the server command line argument of a client shortcut, as shown in the following example, set the value of the
server=TcpIp://localhost:6005/00000000-0000-0000-0000-000000000000
The AcceptZeroEnvironmentUUID parameter should not be set to true in production databases.
The following optional parameters enable you to specify the client node source address and port.
LocalInterface=host
The host value is a simple host name, a fully qualified domain name, or an appropriate IP address. You can use this to select a specific source address when the client machine has more than one network interface.
LocalPort=port-number
The port-number value is a decimal integer in the range 1 through 65535. You can use this when the default random source port number cannot be used; for example, when the client and server machines are separated by a firewall, which limits the client source port numbers.