Use this information to improve IBM® 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.
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 scripts consist of statements in a simple command language, the Server.Load specification language.
Closes a view opened by the OpenColl command.
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.
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.
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.
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.
Server.Load includes a set of built-in scripts. You can also create a custom script from scratch.
Server.Load contains numerous built-in workloads and initialization workloads.
Use with the @If command in a Server.Load script.
Used in a Server.Load script to execute [Commands] if [Value] is non-zero. @If is used to execute multiple commands or to use an @Else condition.
Use in a Server.Load script to create new documents in a database according to the value of a.
Use in a Server.Load script to mark the beginning of a script's critical region.
Use in a Server.Load script to mark the start of the loop and the point to which the Rewind statement returns control. A script can have one loop.
Use in a Server.Load script to mark the start of the loop and the point to which the Rewind2 statement returns control.
Use in a Server.Load script to allow the user to set program control after an error.
Use in a Server.Load script to schedule an appointment or invitation.
Use in a Server.Load script to set the current database for the test.
Use in Server.Load to check for new mail on the specified mail database.
Use in a Server.Load script to close the current view. The view is opened with the Open command.
Given a collection, searches for all notes within a set time range of one week prior to the current time, and three weeks after.
Adds a color profile to the mail database.
Clears out (removes) the color profile items and notes.
Use in a Server.Load script to allow you to issue remote server console commands, similar to the Domino® server console in the Domino Administrator console.
Closes the open database.
Use in a Server.Load script to delete a database (locally or on a server). If the database is on a server, you must have delete database access.
Requests a list of all notes modified or added since the last call.
Use in a Server.Load script to delete randomly selected notes from the current database.
Deletes a number of notes from a view. The view must have been previously opened with OpenColl.
Use in a Server.Load script to drop all network connections on the specified port.
Use in a Server.Load script to indicate a critical region that can be executed by only one simulated user (thread).
Retrieve a number of documents from the view to populate the internal list of Note IDs. The view must have been previously opened with OpenColl.
Used in a Server.Load script to simulate a user pressing PgUp and PgDn or pressing Up and Down arrows to traverse a view.
Used in a Server.Load script to set a time delay after a nonfatal error occurs.
Used in a Server.Load script to enable you to search index entries by key.
Used in a Server.Load script to enable you to search index entries by name.
Finds a design note and saves the NotesID.
Find a folder's Note ID for use in the next command. Remains cached until a new folder is found.
Used in a Server.Load script to fetch the ID table of all Note IDs from the database.
Requests any folder changes from the server. Nothing is done with the results.
Get collation for the most recently opened collection.
Used in a Server.Load script to display help text.
Used in a Server.Load script to purge deleted IMAP messages and check for new messages.
Used in a Server.Load script to close the currently selected IMAP mailbox.
Used in a Server.Load script to get (UID Fetch) body for specified entry.
Used in a Server.Load script to get (UID Fetch) Body for specified entry.
Used in a Server.Load script to get (Fetch) last page of entries (UID, flags, envelope) for use with ImailFetchEntry.
Used in a Server.Load script to check for new IMAP messages.
Used in a Server.Load script to displays all available IMAP (IMail*) commands with Help text.
Used in a Server.Load script to list IMAP mailboxes.
Used in a Server.Load script to log in to a server running IMAP.
Used in a Server.Load script to log out of a server running IMAP.
Used in a Server.Load script to open (select) an IMAP mailbox (the Inbox folder of the mail file).
Used in a Server.Load script to add a message to the specified mailbox.
Used in a Server.Load script to set current message as seen.
Used in a Server.Load script to update the currently open collection.
Used in a Server.Load script to perform LDAP lookup for specified user name.
Searches the calendar view for the last entry that was created.
Used in a Server.Load script to search the Domino® Directory (NAMES.NSF) for names you specify.
Add a mail rule that blocks a user from sending to the database.
Removes all the mail rules in the database.
Moves notes from a view to a folder.
Used in a Server.Load script to retrieve POP3 mail messages for a fixed user in the Domino® Directory (NAMES.NSF).
Used in a Server.Load script to update a number of random documents of a particular type in the Domino® Directory (NAMES.NSF) database.
Used in a Server.Load script to read number of documents as listed in index.
Read a number of documents in the index. Reply to all recipients in a number of messages. Do this every NB_ReplyNthIteration iteration.
Used in a Server.Load script to poll for new mail.
Poll for new mail, refresh the view if there is new mail.
Used in a Server.Load script to create empty database target as replica of source.
Used in a Server.Load script to add a document with the specified [Subject], [Body], [Attachment], [MsgCount], [NamedField], and [FolderID].
Used in a Server.Load script to open a view collection.
Opens the last calendar note created.
Opens a view for use by Server.Load commands.
Used in a Server.Load script to wait for a specified number of milliseconds before performing the next command in the script.
Used in a Server.Load script to ensure that there are (NumMailNotesPerUser) documents in the current database.
Closes an opened profile, that is, a profile opened with the ProfileOpen command.
Opens a given profile note.
Can add four types of fields to a profile note.
Updates the currently opened profile note.
Used in a Server.Load script to terminate the open program.
Used in a Server.Load script to open and close a specified number of documents.
Used in a Server.Load script to replicate with server.
Used in a Server.Load script to retrieve POP3 mail messages for a user.
Used in a Server.Load script to restart the script file, if one is given, up to a maximum of n iterations, if n is specified.
Used in a Server.Load script to restart the loop, up to a maximum of n iterations, if n is specified.
Finds invitations for response from the Inbox.
Use in a Server.Load script to send a response (acceptance) to an invitation (if one exists).
Use in a Server.Load script to create and send a mail message.
Used in a Server.Load script to create and send a mail message.
Used in a Server.Load script to create and send an SMTP mail message.
Used in a Server.Load script to close all open sessions.
Used in a Server.Load script to create sessions on the specified server, monitor the time it takes to open num_sessions, and return that val
In the most recent collection, set an ordinal position.
Used in a Server.Load script to set the context iteration status.
Used in a Server.Load script to set the Owner and BusyName fields for the current database.
Sets the database replica ID based on the date and time provided or, if the date and time are not provided, it uses the current date and time to set the replica ID.
Used in a Server.Load script to select 'a' random documents from the list of Note IDs returned from GetAll.
Adds a user randomly chosen from the list of users defined for the test. If the user is already in the buddy list, it will find another until it has one that is not in the buddy list.
Deletes all current buddies in the current user's buddy list and adds a range of users.
Sends a chat message.
Attempts to transfer a file to a random user.
Sets Location settings.
Adds everyone in the current user's buddy list to a watch list for their locations.
Use in a Server.Load script to log a user in to a IBM® Sametime® server.
Logs an IBM® Sametime® user out of the server, pauses, then logs back in.
Queries the current user's policy.
Sets the status of the current user.
Logs an IBM® Sametime® user out of the server and closes the connection.
Randomly selects a user in the current user's buddy list and requests the user's business card.
Used in a Server.Load script to set the database unread list for the current collection to contain (a) random documents.
Used in a Server.Load script to update random documents in a database, based on the value of 'a'.
Used in a Server.Load script to retrieve information from a specified URL.
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.
Server.Load uses the logic described in this topic when determining the range of mailing address to be used.
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.
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, Windows NT™ server, and UNIX™ server.
After you set up the Domino® Web server and make sure that it runs properly, check the server's performance and response time.
Domino® includes features that improve efficiency in specific environments, but these features may not be switched on by default.
Advanced database properties include performance optimization and compression features, as well as ways to manage usability features such as unread marks and soft deletions.
Three categories of Domino® cluster statistics help you analyze clusters
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.
Closecoll <collection name>