TUNING


The Sametime workloads
The Domino® Administrator client contains three IBM® Sametime® workloads.

About this task


The information in this topic applies to all three Sametime workloads. Review this section and complete the necessary steps prior to running any of the three Sametime workloads.

Sametime Workload Setup

Procedure

1. Install the Domino Administrator client. Select the Server.Load option from the Client Install Options list.

2. Install Server.Load or NotesBench into the Notes® client program directory as needed.

3. Add the required NOTES.INI settings to the test driver's NOTES.INI file and replace the values in the table with the values for your test setup.

NOTES.INI variables required by all Sametime workloads

About this task

In the examples, RND(XdY) indicates that a random number is generated by rolling a "Y" sided die "X" times. For example, RND(5d10) indicates that five 10-sided dice are rolled and the results are summarized to form a random number.

Table 1. NOTES.INI variables
NOTES.INI variables required by all Sametime workloadsDescription
NB_EnableSTAwareness=1Enables Sametime Awareness
JavaMaxHeapSize=700MJNI/java maximum heap size
JavaUserClasses=CstClientTest.jar;stjavatk.jar, ibmjceprovider.jarRequired jar files
ST.server=<servername> Sametime server name
ST.user=<username prefix>Prefix for users; for example, "mail"
ST.password=<user password>Password used to authenticate a user
ST.login.type=[MUX|JAVA]MUX simulates a mux, JAVA simulates a direct client connection
ST.logout.pause.wait=RND(100d6)Time to wait before logging in again
ST.bl.size.quan=RND(4d100)The number of users to add to each buddy list
ST.bl.beginuser.number= 1Starting user number for buddy list operations
ST.bl.enduser.number=1000Ending user number for buddy list operations
ST.test.maxusers=10000Maximum number of users in the test
ST.debug.filename=c:\\results\\debugout.txtThe name of the file to which errors are written, requires STdebug > 0
STDebugOn=<value>Specify one of these debug settings:
  • STDebugOn=0 -- Debug information is not sent to the console.
  • STDebugOn= <a positive number> -- Debug information is sent to the console.
NB_Include_ST_Stats=1Enables per-minute statistics to be sent to the console window. To capture the stats, set DEBUG_OUTFILE=<filename>

Table 2. Variables required for Sametime 7.0 and 7.5 Instant Messaging workloads
NOTES.INI variables for the Sametime 7.0 and 7.5 Instant Messaging workloadsDescription
ST.converse.pause.wait=RND(10d6)Think time between exchanged messages
ST.converse.nummessages.quan=RND(1d10)Number of messages per chat
ST.converse.messagelength.quan=RND(8d128)Size in bytes of each message sent
ContextIteration1=3Run a command every third iteration (once every 45 minutes)
ContextIteration2=24Run a command every twenty-fourth iteration (once every 6 hours)
ContextIteration3=12Run a command every twelfth iteration (once every 3 hours)

Table 3. Variables required for the Sametime 7.5 Instant Messaging workload
NOTES.INI variables for the Sametime 7.5 Instant Messaging workloadDescription
NB_ENABLELOCATIONWATCH=1Choose one:
  • 1 -- To enable buddy list watching for the location
  • 0 -- To disable buddy list watching for the location
ContextIteration4=12Run a command every twelfth iteration (once every 3 hours)
ST.converse.htmltext.percent=90Percent of all rich text messages sent with STchat that should be HTML
ST.converse.img.percent=10Percent of all rich text messages sent with STchat that should be images
ST.converse.img.filename=c:\\lotus\\notes\\data\\image.gifThe image file that users should send. The maximum image size is 100K.
NB_DISABLEFILETRANS=1

Note: In tests, file transfers have been shown to be resource-heavy operations. To save resources, IBM recommends setting NB_DISABLEFILETRANS=1. If file transfers are required, set NB_DISABLEFILETRANS=0.

To run the workload with File Transfer enabled, set this variable to 0.
NB_STFTransSizeInBytes=1000000Size (in bytes) of the file to transfer. Server policies can restrict this on the server side
NB_STFTransFileTypeBinary=1Set to 1 for binary format, otherwise it is set to text
ST.ft.send.file=<filepath/nameSpecify a particular file for file transfer
ContextIteration5=24Associated with File Transfer in the workload. In this example, the 24 indicates that file transfer will occur once every 24th iteration.
ST.ft.receive.location=<path>Where to place the received file on file transfer. Currently the file is deleted after it is received, but a valid location is necessary

Related tasks
Sametime 7.0 Initialization workload
Sametime 7.0 Instant Messaging Workload
Sametime 7.5 Instant Messaging workload