IBM Lotus Domino Administrator 8.0
Versions 8.0, 8.0.1, and 8.0.2

Changing a server's IP address

Before changing a server's IP address, consider the following potential problems:

Problem 1: If the server's previous IP address is stored in any Server Connection documents or Server documents, when that server's IP address is changed in DNS and on the server itself, these old Server Connection documents or Server documents will cause connection failures.

Solution: Use the DNS fully-qualified domain name, not the IP address, as the network address stored in the Server Connection documents and Server documents. You can then change the server's IP address in DNS without having to change the Server Connection documents or Server documents. Changing the network address from the IP address to the DNS name can be done at any time.

To modify the Server Connection document, open the Server Connection document. On the Basics tab, if Local Area Network is chosen in the Connection Type field, click the Advanced tab and check the entry in the Destination server address field. If the field contains the server's IP address, delete the IP address and enter the fully-qualified domain name. Remember, both the server-based Domino Directory and the client-based Address Book can have this problem.

To modify the Server document, click the Ports tab for the Net Address for TCP ports. If the field contains the IP address, change the entry to the proper fully-qualified domain name.

Problem 2: The algorithm that all IBM^® Lotus^® Notes^® clients and IBM^® Lotus^® Domino^® servers use to connect to a Domino server can cache the IP address that was used to successfully connect to a server. If this cache entry exists, when the server's IP address is changed, the old cached address may be used causing the connection to fail.

It is important to understand why this caching is performed. Notes supports a wide range of networking technologies implemented as Notes ports. If Notes attempts to connect to a server that is down, and tries every possible technology (Notes port) using every possible Name to Address resolution tool until each one fails, the connection attempt takes a long time. To prevent the long delay that would occur in reporting the error when the server goes down, Notes has implemented two server connection algorithms. One algorithm is fast, using cached addresses, and the other is slower, using the complete algorithm which bypasses the cache when it fails.

The following solutions can resolve this problem. Solutions are listed in the order in which they should be used.

Solution 1: The fast connection algorithm is only used if the client or server had successfully connected to the same server earlier in the day. If a successful connection has not yet occurred today, the slower algorithm is used and the cache is bypassed. To avoid this problem, change a server's IP address late in the evening, but before midnight. This is the easiest solution because it is transparent to the user and involves no help desk calls or any action on the user's part.

Solution 2: The cache is rewritten following successful connection to the server. The cached address is the address entered by the user, not the resolved IP address. Therefore, if users have the habit of connecting to servera/acme by entering servera.acme.com, the cached address will be servera.acme.com, not 1.2.3.4 and the problem will not occur.

Solution 3: The cache is rewritten following any successful connection to the server. If a user tries to connect to the server by its Notes name, for example, servera/acme, the stale cache entry is used. If the user tries to connect using the server's fully-qualified domain name, for example, servera.acme.com, then the cache will not be used, the new address will be fetched from DNS and the correct new address entered in the cache. To make this successful connection using the fully-qualified domain name of the server, use the File - Application - Open menu command or the File - Preferences - User Preferences - Ports - Trace menu selections.

Solution 4: The cache is stored in the following Notes fields in the Location documents for the client and in the Server document for the server:

$Saved Addresses
$SavedDate
$SavedPorts
$SavedServers
$SavedTriedDate

If these fields are deleted from the Location or Server document, for example, using a formula agent, the old IP addresses in the cache cannot be used. This method can be confusing because the Notes items are rewritten when the client or server exists from an in-memory copy. Therefore, to use this method to clear the cache for the client, create the agent in the Local Address Book, and then switch to the Island Location document and exit the client. Restart the client, and then run the agent to clear the cache for all other locations. Switch to your normal location.

Sample agent formula language code to clear the cache:

FIELD $SavedAddresses:=@DeleteField;
FIELD $SavedDate:=@DeleteField;
FIELD $SavedPorts:=@DeleteField;
FIELD $SavedTriedDate:=@DeleteField;
FIELD $SavedServers:=@DeleteField;
SELECT @All

Solution 5: Disable the use of the cached addresses by using the following NOTES.INI setting:

DONT_USE_REMEMBERED_ADDRESSES=1

If the client uses multiple or slow port technologies, we discourage the use of this technique because it can cause a long delay in reporting that a server is down.

Library | Support | Terms of use |