IBM Support

Description of "Server_MaxSessions=" and "Server_Session_Timeout=" Parameters

Technote (FAQ)


Question

What are the following two parameters and how do they work together on a Domino server?

Server_MaxSessions=
Server_Session_Timeout=


Answer

Below is a description of each of the parameters.

Server_MaxSessions=

This is a NOTES.INI parameter that defines the number of user sessions a Domino server can accommodate. When a new user attempts to logon, if the current number of sessions is greater than the value of SERVER_MAXSESSIONS= (in the NOTES.INI), the Domino server closes the least-recently-used session. In order for a session to be considered for closing, it must have been inactive for at least one minute.

    For example, if this parameter is set to 100, and the 101st person tries to access the Domino server, the Domino server drops the least-used session from the server in favor of this new session.

    Important Note: Reducing the Server_MaxSessions to a specific number will not prevent the server from allowing more than that number of concurrent active users on the server, but will drop the sessions soon after they become inactive. This frees up resources. Conversely, Domino will not close any session that has been idle for less than a one minute regardless of the demand on the server.

    Please be aware that setting the Server_MaxSessions parameter will never prevent a user from opening a session on the Domino server. There is presently no way to prevent a user from opening a new session on a Domino server. If there are too many concurrent sessions (active sessions) on the Domino server, errors may occur.


    Server_Session_Timeout=

    This is a NOTES.INI parameter that will cause the Domino server to terminate a session that has been idle for the specified amount of time. A session is considered idle if no activity from the client is detected. Dropping unused sessions saves resources. Setting the "Server_Session_Timeout=" parameter will save resources as long as the server is not extremely busy most of the time.

    30-45 minutes is the minimum recommended setting for this parameter. Setting a lower time may cause the server to have to re-open database server sessions too often. This can negatively affect the server's performance as it must re-evaluate the database server sessions as users or other servers recommence their use of the server. The best setting for this parameter will depend on the server load, how many concurrent users there are on the server, etc.


    MinNewMailPoll=

    In Release 5.x, this parameter may also be used with the MinNewMailPoll= parameter. MinNewMailPoll= determines how frequently a Notes client can poll the server for new mail. If any given Notes client (under File, Preferences, User Preferences, Mail and News panel) is set to poll the server for new mail at an interval that is LESS THAN the Server_Session_Timeout= value, then it is possible that the session for that client to remain open indefinitely. To avoid this scenario when implementing this parameter, its value must be higher than that of the Server_Session_Timeout= parameter.

    In Release 6.x the newmail task is an independent task of the Notes Client. It opens and closes a separate session with the Domino server. Therefore, MinNewMailPoll= does not impact the session the Notes Client GUI opened on the Domino server.

    Related information

    What Do the Values in the Server.Users.* Statistic Mean
    A simplified Chinese translation is available

    Historical Number

    139427

    Product Alias/Synonym

    Lotus Notes Client

    Document information

    More support for: IBM Domino

    Software version: 6.0, 6.5, 7.0, 8.0, 8.5, 9.0

    Operating system(s): AIX, IBM i, Linux, Solaris, Windows, z/OS

    Reference #: 1089879

    Modified date: 22 July 2015