Setting the maximum number of users on a server

You can balance the workload in a cluster by using the Server_MaxUsers setting. This setting specifies the maximum number of active users allowed on a server at one time. When the server reaches this limit, the server rejects any additional requests until the number of active users becomes less than the Server_MaxUsers limit.

About this task

When Domino® rejects an access request because of a MAXUSERS state, the Cluster Manager attempts to redirect the request to another cluster server that contains the appropriate replica. If no other server is available, Domino® rejects the access request and displays an explanatory message.

Note: The Server_MaxUsers setting does not affect replication. Replication occurs even when a server is in a MAXUSERS state.

From the Domino® Administrator

Procedure

  1. Click the Configuration tab.
  2. In the Task pane, expand Server, and then click Configurations.
  3. Do one of the following:
    • If a Configuration Settings document already exists for the server you want, select that document, and then click Edit Configuration .
    • If a Configuration Settings document does not already exist for the server you want, click Add Configuration, and add the name of the server in the Group or Server name field on the Basics tab.
  4. Click the NOTES.INI Settings tab.
  5. Click Set/Modify Parameters.
  6. In the Item field, select or enter SERVER_MAXUSERS.
  7. In the Value field, enter the maximum number of users you want to access the server at the same time.
  8. Click Add, and then click OK.
  9. Click Save & Close.

From the Web Administrator

Procedure

  1. Click the Configuration tab.
  2. In the Task pane, expand Server, and then click Configurations.
  3. Do one of the following:
    • If a Configuration Settings document already exists for the server you want, open that document, and then click Edit Server Configuration.
    • If a Configuration Settings document does not already exist for the server you want, click Add Configuration, and add the name of the server in the Group or Server name field on the Basics tab.
  4. Click the NOTES.INI Settings tab.
  5. Click Set/Modify Parameters.
  6. In the Available Parameters box, click SERVER_MAXUSERS, and then click Add.
  7. In the Value field, enter the maximum number of users you want to access the server at the same time, and then click OK.
  8. Click Save & Close.

Results

To see how often requests are redirected, check the log file for workload balancing events or check the Cluster Manager statistics.

Note: You can use the Server_MaxUsers setting with any Domino® server. However, only the servers in a cluster redirect access requests to another server when a server is in a MAXUSERS state. Servers that are not in a cluster reject the access requests.