Home
Tuning
Use this information to improve HCL Domino® server, Domino Web server, and messaging performance through the use of resource balancing and activity trends, Server.Load commands, advanced database properties, cluster statistics, and the Server Health Monitor.
The Server.Load tool
Server.Load is a capacity-planning tool that you use to run tests, also called "scripts" and "workloads," against a targeted Domino® server to measure server capacity and response metrics.
Server.Load agents
Server.Load includes a set of agents in the file NAMAGENT.NSF, which is initially installed in the data directory on the Domino® Administrator client. The first agent in this list -- Create NotesBench Mail Person Documents -- is used to set up Person documents for the workloads and set the HTTP password. The rest of the agents are used to repair and change the workload setup.

Tuning
Use this information to improve HCL Domino® server, Domino Web server, and messaging performance through the use of resource balancing and activity trends, Server.Load commands, advanced database properties, cluster statistics, and the Server Health Monitor.
- Resource balancing and activity trends
  Domino® server resource utilization can be separated into two types, system activity and user activity. System activity, which includes the level of processor, disk, memory, and network consumption that Domino generates to keep the server running, is a fixed amount of activity, as long as systems are healthy and performing smoothly. Domino servers typically use a modest percentage of their resources to run. The remaining server capacity is used to support user activity, which varies with the usefulness of the data on the server.
- The Server.Load tool
  Server.Load is a capacity-planning tool that you use to run tests, also called "scripts" and "workloads," against a targeted Domino® server to measure server capacity and response metrics.
  - Server.Load agents
    Server.Load includes a set of agents in the file NAMAGENT.NSF, which is initially installed in the data directory on the Domino® Administrator client. The first agent in this list -- Create NotesBench Mail Person Documents -- is used to set up Person documents for the workloads and set the HTTP password. The rest of the agents are used to repair and change the workload setup.
  - Server.Load metrics and messaging statistics
    As you run a test, you can view various script metrics and server statistic metrics and optionally store the test output in a separate file. Server statistic metrics are generated by the Domino® server. Script metrics correspond to Server.Load command names and display the performance of particular commands. For example, if you select the Add metric, the Metrics window displays the results of the Add command.
  - Setting up clients and servers for Server.Load
    To use Server.Load, install the Domino® server on the server under test (SUT) and install the Domino Administration client and the Server Load Utility on each client.
  - Built-in and custom Server.Load scripts
    Server.Load includes a set of built-in scripts. You can also create a custom script from scratch.
  - Running the built-in Server.Load workloads
    Server.Load contains numerous built-in workloads and initialization workloads.
  - Server.Load commands
    Server.Load scripts consist of statements in a simple command language, the Server.Load specification language.
  - Server.Load scripts
    You can use any of the sample Server.Load scripts as they are or you can use them as a basis for creating customized scripts.
  - How Server.Load determines the range of mail addresses it uses when sending messages
    Server.Load uses the logic described in this topic when determining the range of mailing address to be used.
- Tuning Domain Indexer performance
  Each time the Domain Indexer task runs, it looks in the Domain Catalog for new databases that have the Include in multi database indexing property enabled. It then looks for documents and files in existing databases and file systems that are new or changed since the last time it ran, and adds them to the Domain Index.
- Improving Domino® server performance
  Read the following topics for help on improving basic Domino® server performance and capacity, as well as the performance of these features: Agent Manager, databases and the Domino directory, the directory catalog, LDAP searches, mail, Web server, and UNIX™ server.
- Improving Web server performance
  After you set up the Domino® Web server and make sure that it runs properly, check the server's performance and response time.
- Improving mail performance
  Domino® includes features that improve efficiency in specific environments, but these features may not be switched on by default.
- Setting advanced database properties
  Advanced database properties include performance optimization and compression features, as well as ways to manage usability features such as unread marks and soft deletions.
- Understanding cluster statistics
  Three categories of Domino® cluster statistics help you analyze clusters
- Improving the performance of the Server Health Monitor
  If the Domino® Administration client workstation performs at 100 percent CPU utilization for a long period of time, the Server Health Monitor discards server statistic data to keep up with the workload.

Server.Load agents

Server.Load includes a set of agents in the file NAMAGENT.NSF, which is initially installed in the data directory on the Domino® Administrator client. The first agent in this list -- Create NotesBench Mail Person Documents -- is used to set up Person documents for the workloads and set the HTTP password. The rest of the agents are used to repair and change the workload setup.

To use the agents, you must use Domino® Designer to add them to the Domino® Directory on the SUT.

Create NotesBench Mail Person Documents
Refresh All Documents
Set HTTPPassword to "NotesBench"
Set Message Storage Format = MIME
Set Message Storage Format = No Preference
Set Message Storage Format = Notes®
Update ACL of MailDBs to include Owner (mail1, mail2, ...)

Agent to set up a workload: Create NotesBench Mail Person Documents

This agent prompts you for information required to create the necessary number of Person documents for a workload.

Table 1. Prompts and defaults values
Prompt	Default
Starting value to create mail users	1.00
Number of users to create	1000.00
Number of Mailn.NSF files to create	1000.00
Starting Mailn.NSF file	1.00
Location for mail databases	mail\
Mail domain	Default is read from the server's mail domain
Mail server directory is on	Name of the server that stores the Domino® Directory
Message storage format	2 (MIME)
Mail system	1 (NOTES)
Internet host name	Host name of the server that stores the Domino® Directory

Agents to repair and change a workload setup

After you use the Create NotesBench Mail Person Documents agent, you may need to use the Refresh All Documents agent to refresh the view in the Domino® Directory.

If you have trouble connecting with HTTP-based workloads and the Person documents do not display any encrypted passwords, use the Set HTTPPassword to "NotesBench" agent to reset the password in all Person documents.

When you change to a different workload, you must remake all of the mail files, but you can use one of these agents to change the mail type in the Person documents without having to recreate all of the Person documents:

Set Message Storage Format = MIME
Set Message Storage Format = No Preference
Set Message Storage Format = Notes®
Update ACL of MailDBs to include Owner (mail1, mail2, ...) -- Use this agent for a workload that has authentication on.