ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzahy_5.4.0.1/rzahycreateunique.htm

74 lines
4.8 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) - Create a unique attributes list</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="rzahycreateunique"></a>
<h3 id="rzahycreateunique">Create a unique attributes list</h3>
<ol type="1">
<li>Expand the <span class="bold">Server administration </span>category
in the navigation area. Click <span class="bold">Manage unique attributes</span>.</li>
<li>Select the attribute that you want to add as a unique attribute from the <span class="bold">Available attributes</span> menu. The available attributes
listed are those that can be designated as unique; for example, sn.</li>
<li>Click either <span class="bold">Add to cn=localhost</span> or <span class="bold">Add to cn=IBMpolicies</span>. The difference between these
two containers is that cn=IBMpolicies entries are replicated and cn=localhost
entries are not. The attribute is displayed in the appropriate list box. You
can list the same attribute in both containers.
<a name="wq191"></a>
<div class="notetitle" id="wq191">Note:</div>
<div class="notebody">If an entry
is created under both cn=localhost and cn=IBMpolicies, the resultant union
of these two entries is the unique attributes list. For example, if the attributes
cn and employeeNumber are designated as unique in cn=localhost and the attributes
cn and telephoneNumber are designated as unique in cn=IBMploicies, the server
treats the attributes cn, employeeNumber, and telephoneNumber as unique attributes.</div></li>
<li>Repeat this process for each attribute you want to add as a unique attribute.</li>
<li>Click <span class="bold">OK</span> to save your changes.</li></ol>
<p>When adding or modifying a unique attribute entry, if establishing a unique
constraint for any of the listed unique attribute types results in errors,
the entry is not added or created in the directory. The problem must be resolved
and the command to add or modify must be reissued before the entry can be
created or modified. For example, while adding a unique attribute entry to
the directory, if establishing a unique constraint on a table for one of the
listed unique attribute types failed (that is, because of having duplicate
values in the database), a unique attribute entry is not added to the directory.
An error is issued.</p>
<p>When an application tries to add an entry to the directory with a value
for the attribute that duplicates an existing directory entry, an error with
result code 20 (LDAP: error code 20 - Attribute or Value Exists) from the
LDAP server is issued.</p>
<p>When the server starts, it checks the list of unique attributes and determines
if the DB2 constraints exist for each of them. If the constraint does not
exist for an attribute because it was removed by the bulkload utility or because
it was removed manually by the user, it is removed from the unique attributes
list and an error message is logged in the error log, ibmslapd.log. For example,
if the attribute cn is designated as unique in cn=uniqueattributes,cn=localhost
and there is no DB2 constraint for it the following message is logged:</p>
<p></p>
<pre class="xmp">Values for the attribute CN are not unique.
The attribute CN was removed from the unique attribute
entry: CN=UNIQUEATTRIBUTES,CN=LOCALHOST</pre><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>