TROUBLESHOOTING


TCP/IP error messages -- Server only
These sections describe common error messages on a IBM® Lotus® Domino® server offering NRPC services over TCP/IP.

Error on Listen function: The requested TCP/IP port is in use on this system.
This message could indicate one of the following problems:



Insufficient TCP sockets are available. Consult your vendor's TCP/IP documentation to increase the maximum number of sockets.
You have reached a TCP/IP socket limitation. To see how many active TCP/IP sessions the server system has open, use Netatat with the -n switch (to disable reverse DNS lookups) and output the listing to a file. Import the listing to a spreadsheet and count the total number of connections. Then break the connections down by their state (Established, Time_Wait, Close_Wait, Fin_Waitn). You should be able to support more than 2,000 concurrent connections. If not, review your operating system and TCP/IP stack settings with the operating system and TCP/IP stack vendor. If you have a large number of Close_Wait sessions, you may have network-level problems. If you have a buildup of Time_Wait sessions with HTTP services, review your TCP/IP stack's settings to see if the stack offers a setting to time out Time_Wait sessions sooner.

As a temporary solution or if you can't make any alterations to the system or TCP/IP stack, you can limit the number of NRPC sessions the server will support concurrently, but there will be a performance cost for doing so. To limit the number of concurrent NRPC sessions, do one of the following:

Listener task for port <portname> is suspending for 20 seconds due to listen errors.
See the message "Error on Listen function" earlier in this topic.

The remote TCP/IP host is not running the Domino server, or the server is busy.
The server is currently not running, or the server can't accept another TCP/IP connection or Domain session. Start the server, or verify that it is running. Check the server to determine if its workload is unacceptably heavy.

The TCP/IP protocol stack reported that it ran out of memory. Consult your network documentation to increase configured memory, or reduce Notes connections by limiting clients (see SERVER_MAXSESSIONS parameter in Notes Admin Guide).
This error can occur when your server system's resources are not correctly sized for the number of inbound and outbound connections or when events push the server into resource starvation.

As a temporary solution or if you can't make any alterations to the system or TCP/IP stack, you can limit the number of NRPC sessions the server will support concurrently, but there will be a performance cost for doing so. To limit the number of concurrent NRPC sessions, do one of the following: Unable to locate the Domain server's TCP/IP host. The TCP/IP domain name server may be down.
Use the "ping' command to verify that DNS is running.

Unexpected TCP error. See the Notes log file on this system for error code.
Look in the log file to see the reported error code or codes. KnowledgeBase lists many of the error codes. If you find an error code that isn't in KnowledgeBase, report it to Lotus Support Services.

Related topics