Lotus Domino: Tunning English: Difference between revisions

From Wiki
No edit summary
Line 17: Line 17:




 
== '''GENERAL:''' Disabling the Collection of Statistics Platform ==
== Disabling the Collection of Statistics Platform ==


Domino statistics collection platform to display the Administrator. The collection does not consume much resources, but we're talking about tuning.
Domino statistics collection platform to display the Administrator. The collection does not consume much resources, but we're talking about tuning.
Line 32: Line 31:




== Disabling Full Text for Attachments Types ==
== '''GENERAL:''' Disabling Full Text for Attachments Types ==


Tells the indexer not to index attachments with the XXX extension
Tells the indexer not to index attachments with the XXX extension
Line 42: Line 41:
.NSF, .NTF , .SYS, .PAG, .IMG , .WAV , .GIF, .JPG, .DLL, .TAR, .EXE , .ZIP, .AU , .MPG, .MOV, .MP3 .
.NSF, .NTF , .SYS, .PAG, .IMG , .WAV , .GIF, .JPG, .DLL, .TAR, .EXE , .ZIP, .AU , .MPG, .MOV, .MP3 .


== Cache Design Elements ==
 
 
== '''HTTP:''' Cache Design Elements ==


To optimize the response time keeps Domino design elements in memory.
To optimize the response time keeps Domino design elements in memory.
Line 100: Line 101:




==== Example: ====
=== Example: ===
To find out if you need to change this parameter, run the following command
To find out if you need to change this parameter, run the following command


Line 115: Line 116:




== Cache User Info ==
== '''HTTP:''' Cache User Info ==


To optimize the response time keeps Domino design elements in memory.
To optimize the response time keeps Domino design elements in memory.
Line 180: Line 181:




 
== '''SERVER:''' NSF Buffer Pool ==
== NSF Buffer Pool ==


Buffering Database I/O
Buffering Database I/O
Line 235: Line 235:




== NSF Cache ==
== '''SERVER:''' NSF Cache ==


To minimize the time lags involved with opening and closing databases on a server, each server uses a database cache.
To minimize the time lags involved with opening and closing databases on a server, each server uses a database cache.
Line 301: Line 301:
If the Database statistics DbCache.OvercrowdingRejections is high, then you should consider tuning this parameter.
If the Database statistics DbCache.OvercrowdingRejections is high, then you should consider tuning this parameter.


== '''SERVER:''' Increase Name Lookup Cache  ==
{| border="1"
|
'''Tune'''
|
*  NLCACHE_SIZE
To implement, set the notes.ini parameter NLCACHE_SIZE equal to the number of bytes you want the maximum cache size to be.
|-
|
'''Statistics'''
|
* Database.NAMELookupCachePool.Used
* Database.NAMELookupCachePool.Peak
* Database.NAMELookupCacheMisses
* Database.NAMELookupCacheHits
* Database.NAMELookupCacheMaxSize
|-
|
'''Interpretation'''
|
* Database.NAMELookupCachePool.Used is close to the Database.NAMELookupCachePool.Peak value   
* Database.NAMELookupCacheMisses remains above Database.NAMELookupCacheHits for hours
* Database.NAMELookupCacheMaxSize with Database.NAMELookupCachePool.Peak and Database.NAMELookupCachePool.Used
Neither value should have reached Database.NAMELookupCacheMaxSize. If the numbers are close, increase the cache size
|-
|
'''Example'''
|
NA
|-
|
'''Reference'''
|
[http://www.ibm.com/developerworks/lotus/library/ls-D6_Dir/index.html Domino 6 directory performance improvements]


|}


== Cluster Replicator  ==
 
 
== '''CLUSTER:''' Cluster Replicator  ==


To prevent the replicas of the cluster de-synchronized, increasing the amount of tasks '''clrepl''' through the Notes.ini variable
To prevent the replicas of the cluster de-synchronized, increasing the amount of tasks '''clrepl''' through the Notes.ini variable
Line 354: Line 406:




== Concurrent Tasks  ==
== '''SERVER:''' Concurrent Tasks  ==


PUT INFO HERE  
PUT INFO HERE  
Line 396: Line 448:




== Platform Paging File  ==
== '''PLATAFORM:''' Platform Paging File  ==




Line 432: Line 484:




== Platform Disk  ==
== '''PLATAFORM:''' Platform Disk  ==


{| border="1"
{| border="1"
Line 468: Line 520:




== RouterDbCacheSize  ==
== '''ROUTER:''' How many Mailboxes? ==




Represents the number of entries allocated for the router database cache. If not used, the default is based on NSFBufferPoolSize (three per MB), i.e. three times bigger than NSFBufferPoolSize, and the maximum is capped to 20000 entries at startup, but reallocation may occur and the number of 20000 entries could exceed it. In brief: it represents a cache of opened mail database handles.
How many Mailboxes is necessary for my Domino Server
 
{| border="1"
{| border="1"
|
|
Line 477: Line 530:
|
|


RouterDbCacheSize
Configuration Document
|-
|-


Line 484: Line 537:
'''Statistics'''
'''Statistics'''
|
|
*Mail.DBCacheAged =                  ; the number of entries that had aged and been deleted
*Mail.Mailbox.AccessConflicts =                  ; the number of entries that had aged and been deleted
 
*Mail.DBCacheEntries =            ; the current number of cache entries
 
*Mail.DBCacheForcedOut =          ; the number of cached entries forced out due to lack of available cache
 
*Mail.DBCacheHighWaterMark =      ; the highest number of entries that had been cached
 
*Mail.DBCacheHits =        ; the number of times a requested db handle was already in cache
 
*Mail.DBCacheMaxEntries =        ; the maximum number of entries (RouterDbCacheSize)
 
*Mail.DBCacheReads =        ; the number of times cache was read


|-
|-
Line 505: Line 546:
|
|


 
* Good = 0 Waiting


|-
|-
Line 514: Line 555:
|}
|}


 
== '''ROUTER:''' RouterDbCacheSize ==
== Increase Name Lookup Cache ==




Represents the number of entries allocated for the router database cache. If not used, the default is based on NSFBufferPoolSize (three per MB), i.e. three times bigger than NSFBufferPoolSize, and the maximum is capped to 20000 entries at startup, but reallocation may occur and the number of 20000 entries could exceed it. In brief: it represents a cache of opened mail database handles.
{| border="1"
{| border="1"
|
|
'''Tune'''
'''Tune'''
|
|
*  NLCACHE_SIZE


To implement, set the notes.ini parameter NLCACHE_SIZE equal to the number of bytes you want the maximum cache size to be.
RouterDbCacheSize
|-
|-


|
|
'''Statistics'''
'''Statistics'''
|
|
* Database.NAMELookupCachePool.Used
*Mail.DBCacheAged =                  ; the number of entries that had aged and been deleted
 
*Mail.DBCacheEntries =            ; the current number of cache entries
 
*Mail.DBCacheForcedOut =          ; the number of cached entries forced out due to lack of available cache


* Database.NAMELookupCachePool.Peak
*Mail.DBCacheHighWaterMark =      ; the highest number of entries that had been cached


* Database.NAMELookupCacheMisses
*Mail.DBCacheHits =        ; the number of times a requested db handle was already in cache


* Database.NAMELookupCacheHits
*Mail.DBCacheMaxEntries =        ; the maximum number of entries (RouterDbCacheSize)


* Database.NAMELookupCacheMaxSize
*Mail.DBCacheReads =        ; the number of times cache was read


|-
|-
|
|
'''Interpretation'''
'''Interpretation'''
|
|


* Database.NAMELookupCachePool.Used is close to the Database.NAMELookupCachePool.Peak value   


* Database.NAMELookupCacheMisses remains above Database.NAMELookupCacheHits for hours
* Database.NAMELookupCacheMaxSize with Database.NAMELookupCachePool.Peak and Database.NAMELookupCachePool.Used
Neither value should have reached Database.NAMELookupCacheMaxSize. If the numbers are close, increase the cache size


|-
|-
|
|
'''Example'''
'''Reference'''
|
|
NA
NA
|-
|
'''Reference'''
|
[http://www.ibm.com/developerworks/lotus/library/ls-D6_Dir/index.html Domino 6 directory performance improvements]
|}
|}

Revision as of 22:56, 31 May 2012

Tunning

This wiki will be creating a series of articles outlining best practices for Lotus Domino environment.

I ask you to always return to this article will be updating as usual.

Steps

  1. Have an implementation plan
  2. Know your infrastructure
  3. Divide the compounds
    1. Platform
    2. Notes Mail Statistics
    3. Network report
    4. Server Load Statistics
  4. Have a baseline reference


GENERAL: Disabling the Collection of Statistics Platform

Domino statistics collection platform to display the Administrator. The collection does not consume much resources, but we're talking about tuning.

To disable the collection utize the following parameter in NOTES.INI. 

Platform_Statistics_Disabled = 1

Reasons:

  • You do not want to collect statistics
  • On partitioned servers (DPAR), each server collects the same statistics. You can enable only in one partition and disable the others.


GENERAL: Disabling Full Text for Attachments Types

Tells the indexer not to index attachments with the XXX extension 


FT_Index_Ignore_Attachment_Types=*.nsf,*.ntf,*.tif,*.sys,*.pag,*.img,*.wav,*.gif,*.jpg,*.dll,*.tar,*.exe,*.zip,*.au,*.mpg,*.mov,*.mp3,*.cca,*.dbd,*.p7m,*.p7s,*.wpl,*.bmp

Since version 5.0.5, Domino disable by default to following Attachment types: .NSF, .NTF , .SYS, .PAG, .IMG , .WAV , .GIF, .JPG, .DLL, .TAR, .EXE , .ZIP, .AU , .MPG, .MOV, .MP3 .


HTTP: Cache Design Elements

To optimize the response time keeps Domino design elements in memory.

Tune

To change the parameters of Web Cache, Open the server document and go

Internet Protocols → Domino Web Engine → Memory Caches.

and change the field value

Field

Description

Maximum cached designs

Enter the number of database design elements to cache for users. The default is 128. When a user opens a database, Domino maps each design element name to an identification number. This mapping procedure takes time. Use this field to Specify how many elements you want to store in memory so the next time the user accesses That element, it is Immediately available.


Statistics

  • Domino.Cache.Design.Count
  • Domino.Cache.Design.DisplaceRate
  • Domino.Cache.Design.HitRate
  • Domino.Cache.Design.MaxSize

Interpretation

  • Good = HitRate >= 97%
  • Good = DisplaceRate = 0

Reference

http://www-01.ibm.com/support/docview.wss?rs=899&uid=swg21286171


Example:

To find out if you need to change this parameter, run the following command 

 > Show stat domino.cache.design .*
 Domino.Cache.Design.Count = 128
 Domino.Cache.Design.DisplaceRate = 18.0328294698918
 Domino.Cache.Design.HitRate = 81.960226776015
 Domino.Cache.Design.MaxSize = 128

Observing these numbers we can deduce that the value of elements (Count) has reached the maximum (MaxSize), so elements in this cache are discarded ( DisplaceRate).

The optimal value for theHitrate is near 100%, andDisplaceRate is 0%. Increasing the value of the fieldMaximum cached designs improves response-time.


HTTP: Cache User Info

To optimize the response time keeps Domino design elements in memory.

Tune

To change the parameters of Web Cache, Open the server document and go

Internet Protocols → Domino Web Engine → Memory Caches.

and change the field value

Field

Description

Maximum cached users

Enter the number of users to cache. The default is 64. After a user successfully authenticates with a server, Domino stores in memory the user's name, password, and the list of groups to which the user belongs. Use this field to increase the number of users for whom Domino stores this information.


Statistics

  • Domino.Cache.User Cache.Count
  • Domino.Cache.User Cache.DisplaceRate
  • Domino.Cache.User Cache.HitRate
  • Domino.Cache.User Cache.MaxSize

Interpretation

  • Good = HitRate >= 97%
  • Good = DisplaceRate = 0

Reference

Example

To find out if you need to change this parameter, run the following command 

 > Show stat domino.cache.user*
Domino.Cache.User Cache.Count = 68
Domino.Cache.User Cache.DisplaceRate = 0
Domino.Cache.User Cache.HitRate = 73.258795221749
Domino.Cache.User Cache.MaxSize = 64


Observing these numbers we can deduce that the value of elements (Count) has reached the maximum (MaxSize), so elements in this cache are discarded ( DisplaceRate).

The optimal value for theHitrate is near 100%, andDisplaceRate is 0%. Increasing the value of the fieldMaximum cached designs improves response-time.


SERVER: NSF Buffer Pool

Buffering Database I/O


Tune

NSF_Buffer_Pool_Size_MB=n

  • Version 8.5 64 bits = Default value 1024
  • Version 8 64 bits = Default value 1024
  • Version 8 32 bits = Default value 512

Statistics

  • Database.Database.BufferPool.Maximum.Megabytes
  • Database.Database.BufferPool.PerCentReadsInBuffer

Interpretation

  • 89% < Bad
  • 90% = OK
  • 91% < Good < 97%
  • 98% <= Excellent

Reference

Recommendations for setting NSF_BUFFER_POOL_SIZE_MB

New default limit on UBM size in Domino 8

Example:

To find out if you need to change this parameter, run the following command 

 > Show stat Database.Database.BufferPool.*
 Database.Database.BufferPool.Maximum.Megabytes = 1024
 Database.Database.BufferPool.MM.Reads = 24
 Database.Database.BufferPool.MM.Writes = 7
 Database.Database.BufferPool.Peak.Megabytes = 1023
 Database.Database.BufferPool.PerCentReadsInBuffer = 98.21

If the Database statistics Database.Database.BufferPool.PerCentReadsInBuffer is lower than 97%,then you should consider tuning this parameter.



SERVER: NSF Cache

To minimize the time lags involved with opening and closing databases on a server, each server uses a database cache.

The Notes.ini NSF_DbCache_Maxentries control how many databases can reside in the cache at a maximum.

This NSF database cache is limited to:

  • 10000 entries = Domino 5.x and 6.x.
  • 20000 entries = Domino 7.x and higher


Tune

NSF_DbCache_Maxentries=X

Statistics

  • Database.Database.BufferPool.PerCentReadsInBuffer
  • Database.DbCache.HighWaterMark
  • Database.DbCache.CurrentEntries
  • Database.DbCache.MaxEntries
  • Database.DbCache.OvercrowdingRejections

Interpretation

  • Good = HighWaterMark < MaxEntries
  • Good = 0 OvercrowdingRejections

Reference

http://www-01.ibm.com/support/docview.wss?uid=swg21279893

Example:

To find out if you need to change this parameter, run the following command 

 > Show stat Database.Database.BufferPool.*
 Database.Database.BufferPool.Maximum.Megabytes = 1024
 Database.Database.BufferPool.MM.Reads = 24
 Database.Database.BufferPool.MM.Writes = 7
 Database.Database.BufferPool.Peak.Megabytes = 1023
 Database.Database.BufferPool.PerCentReadsInBuffer = 98.21

If the Database statistics Database.Database.BufferPool.PerCentReadsInBuffer is lower than 97%,then you should consider tuning this parameter. 

 > Show statDatabase.DbCache.*
 Database.DbCache.HighWaterMark = 2227
 ...
 Database.DbCache.MaxEntries = 3072
 ...
 Database.DbCache.OvercrowdingRejections = 0
 Database.DbCache.Size = 10003

If the Database statistics DbCache.OvercrowdingRejections is high, then you should consider tuning this parameter.

SERVER: Increase Name Lookup Cache

Tune

  • NLCACHE_SIZE

To implement, set the notes.ini parameter NLCACHE_SIZE equal to the number of bytes you want the maximum cache size to be.

Statistics

  • Database.NAMELookupCachePool.Used
  • Database.NAMELookupCachePool.Peak
  • Database.NAMELookupCacheMisses
  • Database.NAMELookupCacheHits
  • Database.NAMELookupCacheMaxSize

Interpretation

  • Database.NAMELookupCachePool.Used is close to the Database.NAMELookupCachePool.Peak value
  • Database.NAMELookupCacheMisses remains above Database.NAMELookupCacheHits for hours
  • Database.NAMELookupCacheMaxSize with Database.NAMELookupCachePool.Peak and Database.NAMELookupCachePool.Used

Neither value should have reached Database.NAMELookupCacheMaxSize. If the numbers are close, increase the cache size

Example

NA

Reference

Domino 6 directory performance improvements


CLUSTER: Cluster Replicator

To prevent the replicas of the cluster de-synchronized, increasing the amount of tasks clrepl through the Notes.ini variable

Tune

CLUSTER_REPLICATORS=X

Statistics

  • Replica.Cluster.SecondsOnQueue
  • Replica.Cluster.WorkQueueDepth
  • Replica.Cluster.Failed

Interpretation

  • Perfect < 10 < SecondsOnQueue > 15 > Bad
  • Perfect < 10 < WorkQueueDepth > 15 > Bad

Reference

NA

Example

Para saber se é necessário alterar este parâmetro, execute o seguinte comando 

> show stat replica.cluster.*
 ...
 Replica.Cluster.SCR.QueueDepth.Avg = 0 
 Replica.Cluster.SCR.QueueDepth.Max = 155 
 ...
 Replica.Cluster.SecondsOnQueue = 2 
 Replica.Cluster.SecondsOnQueue.Avg = 18 
 Replica.Cluster.SecondsOnQueue.Max = 2558 
 ...
 Replica.Cluster.WorkQueueDepth = 0 
 Replica.Cluster.WorkQueueDepth.Avg = 13 
 Replica.Cluster.WorkQueueDepth.Max = 698


SERVER: Concurrent Tasks

PUT INFO HERE

Tune

  • Server_Pool_Tasks = n
  • Server_Max_Concurrent_Trans = m

Statistics

  • Server.ConcurrentTasks
  • Server.ConcurrentTasks.Waiting

Interpretation

  • Good = 0 Waiting

Example

NA

Reference

http://www-01.ibm.com/support/docview.wss?uid=swg21207456


PLATAFORM: Platform Paging File

Tune

  • OS Level

Statistics

  • Platform.PagingFile.Total.PctUtil

Interpretation

  • OK < 0% < PctUtil.Avg > 10% > BAD

Example

NA

Reference

NA


PLATAFORM: Platform Disk

Tune

By several parameters (bufferpool, cache, namelookup ...

Statistics

  • Platform.LogicalDisk.1.AvgQueueLen
  • Platform.LogicalDisk.1.PctUtil

Platform.LogicalDisk.1.AssignedName=C points to the disk

Interpretation

  • Good < 2% < AvgQueueLen > 5% > BAD
  • Good = PctUtil < 80%

Reference

NA


ROUTER: How many Mailboxes?

How many Mailboxes is necessary for my Domino Server

Tune

Configuration Document

Statistics

  • Mail.Mailbox.AccessConflicts =  ; the number of entries that had aged and been deleted

Interpretation

  • Good = 0 Waiting

Reference

NA

ROUTER: RouterDbCacheSize

Represents the number of entries allocated for the router database cache. If not used, the default is based on NSFBufferPoolSize (three per MB), i.e. three times bigger than NSFBufferPoolSize, and the maximum is capped to 20000 entries at startup, but reallocation may occur and the number of 20000 entries could exceed it. In brief: it represents a cache of opened mail database handles.

Tune

RouterDbCacheSize

Statistics

  • Mail.DBCacheAged =  ; the number of entries that had aged and been deleted
  • Mail.DBCacheEntries =  ; the current number of cache entries
  • Mail.DBCacheForcedOut =  ; the number of cached entries forced out due to lack of available cache
  • Mail.DBCacheHighWaterMark =  ; the highest number of entries that had been cached
  • Mail.DBCacheHits =  ; the number of times a requested db handle was already in cache
  • Mail.DBCacheMaxEntries =  ; the maximum number of entries (RouterDbCacheSize)
  • Mail.DBCacheReads =  ; the number of times cache was read

Interpretation


Reference

NA

Retrieved from "https://ebasso.net/wiki/index.php?title=Lotus_Domino:_Tunning_English&oldid=1374"