156 lines
8.9 KiB
HTML
156 lines
8.9 KiB
HTML
<?xml version="1.0" encoding="utf-8"?>
|
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
|
|
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
<html xmlns="http://www.w3.org/1999/xhtml" lang="en-US" xml:lang="en-us">
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
|
<meta name="dc.language" scheme="rfc1766" content="en-us" />
|
|
<!-- All rights reserved. Licensed Materials Property of IBM -->
|
|
<!-- US Government Users Restricted Rights -->
|
|
<!-- Use, duplication or disclosure restricted by -->
|
|
<!-- GSA ADP Schedule Contract with IBM Corp. -->
|
|
<meta name="dc.date" scheme="iso8601" content="2005-09-06" />
|
|
<meta name="copyright" content="(C) Copyright IBM Corporation 1998, 2006" />
|
|
<meta name="security" content="public" />
|
|
<meta name="Robots" content="index,follow"/>
|
|
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
|
|
<title>Directory Server (LDAP) - Configure attribute cache</title>
|
|
<link rel="stylesheet" type="text/css" href="ibmidwb.css" />
|
|
<link rel="stylesheet" type="text/css" href="ic.css" />
|
|
</head>
|
|
<body>
|
|
<a id="Top_Of_Page" name="Top_Of_Page"></a><!-- Java sync-link -->
|
|
<script language = "Javascript" src = "../rzahg/synch.js" type="text/javascript"></script>
|
|
|
|
<img src="delta.gif" alt="Start of change" /><img src="delta.gif" alt="Start of change" />
|
|
<a name="rzahyconfattcache"></a>
|
|
<h3 id="rzahyconfattcache">Configure attribute cache</h3>
|
|
<p>Settings for the attribute cache are configured in both Web administration
|
|
tool and the iSeries Navigator.</p>
|
|
<p>To manually adjust the attribute cache settings in the Web administration
|
|
tool, follow these steps.</p>
|
|
<ol type="1">
|
|
<li>Expand the <span class="bold">Server administration</span> category
|
|
in the navigation area of the Web administration tool, and then select the <span class="bold">Attribute cache</span> tab in the right pane.
|
|
<a name="wq202"></a>
|
|
<div class="notetitle" id="wq202">Note:</div>
|
|
<div class="notebody">To change server configuration settings using the tasks in the Server administration
|
|
category of the Web Administration tool, you must 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 <tt class="xph">os400-profile=MYUSERNAME,cn=accounts,os400-sys=MYSYSTEM.COM</tt>, where MYUSERNAME and the MYSYSTEM.COM strings are replaced with your
|
|
user profile name and the configured system projection suffix, respectively.</div></li>
|
|
<li>Change the amount of memory in kilobytes available to the directory cache.
|
|
The default is 16 384 kilobytes (16 MB).</li>
|
|
<li>Change the amount of memory in kilobytes available to the change log cache.
|
|
The default is 16 384 kilobytes (16 MB).
|
|
<a name="wq203"></a>
|
|
<div class="notetitle" id="wq203">Note:</div>
|
|
<div class="notebody">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.</div></li>
|
|
<li>Select the attribute that you want to cache from the <span class="bold">Available attributes</span> menu. Only those attributes that can be cached are
|
|
displayed in this menu; for example, sn.
|
|
<a name="wq204"></a>
|
|
<div class="notetitle" id="wq204">Note:</div>
|
|
<div class="notebody">An attribute remains
|
|
in the list of available attributes until it has been placed in both the cn=directory
|
|
and the cn=changelog containers.</div></li>
|
|
<li>Click either <span class="bold">Add to cn=directory</span> or <span class="bold">Add to cn=changelog</span>. The attribute is displayed
|
|
in the appropriate list box. You can list the same attribute in both containers.
|
|
<a name="wq205"></a>
|
|
<div class="notetitle" id="wq205">Note:</div>
|
|
<div class="notebody"><span class="bold">Add to cn=changelog</span> 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.</div></li>
|
|
<li>Repeat this process for each attribute you want to add to the attribute
|
|
cache.</li>
|
|
<li>When you are finished, click <span class="bold">OK</span>.</li></ol>
|
|
<p>To enable automatic attribute caching in iSeries Navigator, take these
|
|
steps:</p>
|
|
<ol type="1">
|
|
<li>In iSeries Navigator, expand <span class="bold">Network</span>.</li>
|
|
<li>Expand <span class="bold">Servers</span>.</li>
|
|
<li>Click <span class="bold">TCP/IP</span>.</li>
|
|
<li> Right-click <span class="bold">IBM Directory Server</span> and select <span class="bold">Properties</span>.</li>
|
|
<li>Click the <span class="bold">Performance</span> tab.</li>
|
|
<li>Select <span class="bold">Enable automatic attribute caching</span> for
|
|
either <span class="bold">Database</span> or <span class="bold">Change log</span>, 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.</li>
|
|
<li>Specify the <span class="bold">Start time</span> (in the server's
|
|
local time) and <span class="bold">Interval</span> 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.</li></ol>
|
|
<a name="wq207"></a>
|
|
<div class="notetitle" id="wq207">Note:</div>
|
|
<div class="notebody">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.</div>
|
|
<a name="wq208"></a>
|
|
<table id="wq208" width="100%" summary="" border="1" frame="border" rules="all">
|
|
<caption>Table 4. Interaction of attribute cache settings</caption>
|
|
<thead valign="bottom">
|
|
<tr>
|
|
<th id="wq209" width="40%" align="left" valign="top">Activity</th>
|
|
<th id="wq210" width="59%" align="left" valign="top">What occurs</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody valign="top">
|
|
<tr>
|
|
<td headers="wq209">Server startup</td>
|
|
<td headers="wq210">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.</td>
|
|
</tr>
|
|
<tr>
|
|
<td headers="wq209">Enable automatic attribute caching after server startup</td>
|
|
<td headers="wq210">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.</td>
|
|
</tr>
|
|
<tr>
|
|
<td headers="wq209">Disable automatic attribute caching after server startup</td>
|
|
<td headers="wq210">Only attributes that were manually configured will be
|
|
cached.</td>
|
|
</tr>
|
|
<tr>
|
|
<td headers="wq209">Modify manually cached attributes while automatic caching
|
|
is enabled after server startup</td>
|
|
<td headers="wq210">Nothing will happen. The manual configuration will go
|
|
into effect when automatic caching is disabled.</td>
|
|
</tr>
|
|
<tr>
|
|
<td headers="wq209">Modify amount of memory available for caching after
|
|
server startup</td>
|
|
<td headers="wq210">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.</td>
|
|
</tr>
|
|
<tr>
|
|
<td headers="wq209">Modify start time or interval after server startup</td>
|
|
<td headers="wq210">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.</td>
|
|
</tr>
|
|
</tbody>
|
|
</table><img src="deltaend.gif" alt="End of change" /><img src="deltaend.gif" alt="End of change" />
|
|
<a id="Bot_Of_Page" name="Bot_Of_Page"></a>
|
|
</body>
|
|
</html>
|