Configuring attribute cache

Configuring attribute cache

Use this information to set the attribute cache settings. Settings for the attribute cache are configured in both Web administration tool and the iSeries™ Navigator.
To manually adjust the attribute cache settings in the Web administration tool, follow these steps:

Expand the Server administration category in the navigation area of the Web administration tool, and then select the Attribute cache tab in the right pane.
To change server configuration settings using the tasks in the Server administration category of the Web Administration tool, authenticate to the server as an i5/OS^® user profile that has *ALLOBJ and IOSYSCFG special authorities. This can be done by authenticating as a projected user with the password for that profile. To bind as a projected user from the Web administration tool, enter a username of the form os400-profile=MYUSERNAME,cn=accounts,os400-sys=MYSYSTEM.COM, where MYUSERNAME and the MYSYSTEM.COM strings are replaced with your user profile name and the configured system projection suffix, respectively.

Change the amount of memory in kilobytes available to the directory cache. The default is 16 384 kilobytes (16 MB).

Change the amount of memory in kilobytes available to the change log cache. The default is 16 384 kilobytes (16 MB).
This selection is disabled if change log has not been configured. Attribute caching for change log should be set to 0 and no attributes should be configured unless you do frequent searches within the change log and the performance of these searches is critical.

Select the attribute that you want to cache from the Available attributes menu. Only those attributes that can be cached are displayed in this menu; for example, sn.
An attribute remains in the list of available attributes until it has been placed in both the cn=directory and the cn=changelog containers.

Click either Add to cn=directory or Add to cn=changelog. The attribute is displayed in the appropriate list box. You can list the same attribute in both containers.
Add to cn=changelog is disabled if change log has not been configured. Attribute caching for change log should be set to 0 and no attributes should be configured unless you do frequent searches within the change log and the performance of these searches is critical.

Repeat this process for each attribute you want to add to the attribute cache.

When you are finished, click OK.

To enable automatic attribute caching in iSeries Navigator, take these steps:

In iSeries Navigator, expand Network.

Expand Servers.

Click TCP/IP.

Right-click IBM Directory Server and select Properties.

Click the Performance tab.

Select Enable automatic attribute caching for either Database or Change log, or both. Automatic attribute caching for change log should not be enabled unless you do frequent searches within the change log and the performance of these searches is critical.

Specify the Start time (in the server's local time) and Interval for each type of caching you choose to enable. For example, if you enable database caching and set the start time for 6.00 a.m. and the interval to be six hours, the cache will be automatically adjusted at 6 a.m., noon, 6 p.m., and midnight regardless of when the server was started or when the auto adjusting was configured.

Automatic attribute caching will cache attributes up to the maximum amount of memory for caching as specified in the Web administration tool as described above.

Table 1. Interaction of attribute cache settings
Activity What occurs

Server startup If automatic attribute caching is currently enabled and automatic caching was enabled when the server was last stopped, the same attributes that were cached when the server stopped will be created when the server is restarted. If additional memory is still available for attribute caching, the attributes that were manually configured will be cached as well. If automatic attribute caching is currently enabled and was not enabled when the server was last stopped, the attributes that are manually configured for caching will be cached. In either case, the server will then automatically adjust the attribute caches based on the specified start time and time interval. If automatic caching is not enabled, the manually adjusted cache settings will take effect.
Enable automatic attribute caching after server startup Automatic attribute caching will occur as described for server startup. Any manually configured attribute caches that do not fit within the amount of memory configured for attribute caching will be deleted.
Disable automatic attribute caching after server startup Only attributes that were manually configured will be cached.
Modify manually cached attributes while automatic caching is enabled after server startup Nothing will happen. The manual configuration will go into effect when automatic caching is disabled.
Modify amount of memory available for caching after server startup If automatic caching is enabled, the server will immediately re-cache based on the new size. If automatic caching is disabled, the server will cache the manually configured attributes up to the new size.
Modify start time or interval after server startup If automatic caching is enabled, the new settings will take effect at the start time or interval specified. If automatic caching is disabled, the settings are stored and go into effect when automatic caching is enabled.

Parent topic:
Performance tasks

Activity	What occurs
Server startup	If automatic attribute caching is currently enabled and automatic caching was enabled when the server was last stopped, the same attributes that were cached when the server stopped will be created when the server is restarted. If additional memory is still available for attribute caching, the attributes that were manually configured will be cached as well. If automatic attribute caching is currently enabled and was not enabled when the server was last stopped, the attributes that are manually configured for caching will be cached. In either case, the server will then automatically adjust the attribute caches based on the specified start time and time interval. If automatic caching is not enabled, the manually adjusted cache settings will take effect.
Enable automatic attribute caching after server startup	Automatic attribute caching will occur as described for server startup. Any manually configured attribute caches that do not fit within the amount of memory configured for attribute caching will be deleted.
Disable automatic attribute caching after server startup	Only attributes that were manually configured will be cached.
Modify manually cached attributes while automatic caching is enabled after server startup	Nothing will happen. The manual configuration will go into effect when automatic caching is disabled.
Modify amount of memory available for caching after server startup	If automatic caching is enabled, the server will immediately re-cache based on the new size. If automatic caching is disabled, the server will cache the manually configured attributes up to the new size.
Modify start time or interval after server startup	If automatic caching is enabled, the new settings will take effect at the start time or interval specified. If automatic caching is disabled, the settings are stored and go into effect when automatic caching is enabled.