114 lines
7.3 KiB
HTML
114 lines
7.3 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) - Add an attribute</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>
|
|
|
|
|
|
<a name="rzahyaddattr"></a>
|
|
<h3 id="rzahyaddattr">Add an attribute</h3>
|
|
<p>Use either of the following methods to create a new attribute. The Web
|
|
administration tool is the preferred method.</p>
|
|
<p><span class="bold">Web administration</span></p>
|
|
<p>If you have not done so already, expand <span class="bold">Schema
|
|
management</span> in the navigation area, then click <span class="bold">Manage attributes</span>. To create a new attribute:</p>
|
|
<ol type="1">
|
|
<li>Click <span class="bold">Add</span>.
|
|
<a name="wq315"></a>
|
|
<div class="notetitle" id="wq315">Note:</div>
|
|
<div class="notebody">You can also access this panel by expanding <span class="bold">Schema management</span> in the navigation area, then click <span class="bold">Add an attribute</span>.</div></li>
|
|
<li>Enter the <span class="bold">Attribute name</span>, for
|
|
example, <span class="bold">tempId</span>. This is a required field
|
|
and must begin with an alphabetical character.</li>
|
|
<li>Enter a <span class="bold">Description</span> of the attribute,
|
|
for example, <span class="bold">The ID number assigned to a temporary
|
|
employee</span>.</li>
|
|
<li>Enter the <span class="bold">OID</span> for the attribute. This
|
|
is a required field. See <a href="rzahyoid.htm#rzahyoid">Object identifier (OID)</a>. If you do not have an OID,
|
|
you can use the attribute name appended with -oid. For example, if the attribute
|
|
name is <span class="bold">tempID</span>, then the default OID is <span class="bold">tempID-oid</span>. You can change the value of this field.</li>
|
|
<li>Select a <span class="bold">Superior attribute</span> from
|
|
the drop-down list. The superior attribute determines the attribute from which
|
|
properties are inherited.</li>
|
|
<li>Select a <span class="bold">Syntax</span> from the drop-down list.
|
|
See <a href="rzahysyntax.htm#rzahysyntax">Attribute syntax</a> for additional information about syntax.</li>
|
|
<li>Enter an <span class="bold">Attribute length</span> that
|
|
specifies the maximum length of this attribute. The length is expressed as
|
|
the number of bytes.</li>
|
|
<li>Select the <span class="bold">Allow multiple values</span> checkbox to enable the attribute to have multiple values.</li>
|
|
<li>Select a matching rule from the each of the drop-down menus for equality,
|
|
ordering, and substring matching rules. See the <a href="rzahymatchrules.htm#rzahymatchrules">Matching rules</a> for
|
|
a complete listing of matching rules.</li>
|
|
<li>Click the <span class="bold">IBM extensions</span> tab
|
|
to specify additional extensions for the attribute, or click <span class="bold">OK</span> to add the new attribute or click <span class="bold">Cancel</span> to return to <span class="bold">Manage attributes</span> without
|
|
making any changes.</li>
|
|
<li>At the <span class="bold">IBM extensions</span> tab:
|
|
<ul>
|
|
<li>Change the <span class="bold">DB2 table name </span>. The server generates
|
|
the DB2 table name if this field is left blank. If you enter a DB2 table name,
|
|
you must also enter a DB2 column name.</li>
|
|
<li>Change the <span class="bold">DB2 column name</span>. The server generates
|
|
the DB2 column name if this field is left blank. If you enter a DB2 column
|
|
name, you must also enter a DB2 table name.</li>
|
|
<li>Set the <span class="bold">Security class</span> by selecting <span class="bold">normal</span>, <span class="bold">sensitive</span>,
|
|
or <span class="bold">critical</span> from the drop-down list.</li>
|
|
<li>Set the <span class="bold">Indexing rules</span> by selecting one or more
|
|
indexing rules. See <a href="rzahyindexrules.htm#rzahyindexrules">Indexing rules</a> for additional information
|
|
about indexing rules.
|
|
<a name="wq316"></a>
|
|
<div class="notetitle" id="wq316">Note:</div>
|
|
<div class="notebody">At a minimum, it is recommended that
|
|
you specify Equality indexing on any attributes that are to be used in search
|
|
filters.</div></li></ul></li>
|
|
<li>Click <span class="bold">OK</span> to add the new attribute
|
|
or click <span class="bold">Cancel</span> to return to <span class="bold">Manage attributes</span> without making any changes.</li></ol>
|
|
<a name="wq317"></a>
|
|
<div class="notetitle" id="wq317">Note:</div>
|
|
<div class="notebody">If you clicked OK on the General
|
|
tab without adding any extensions, you can add extensions by the editing the
|
|
new attribute.</div>
|
|
<p><span class="bold">Command line</span></p>
|
|
<p>The following example adds an attribute type definition for an attribute
|
|
called "myAttribute", with Directory String syntax (see <a href="rzahysyntax.htm#rzahysyntax">Attribute syntax</a>)
|
|
and Case Ignore Equality matching (see <a href="rzahymatchrules.htm#rzahymatchrules">Matching rules</a>). The
|
|
IBM-specific part of the definition says that the attribute data is stored
|
|
in a column named "myAttrColumn" in a table called "myAttrTable". If these
|
|
names were not specified, both the column and table name would have defaulted
|
|
to "myAttribute". The attribute is assigned to the "normal" access class,
|
|
and values have a maximum length of 200 bytes.</p>
|
|
<pre class="xmp">ldapmodify -D <<span class="italic">admindn</span>> -w <<span class="italic">adminpw</span>> -i myschema.ldif
|
|
</pre><p class="indatacontent">where the <span class="bold">myschema.ldif</span> file contains:</p>
|
|
<pre class="xmp">dn: cn=schema
|
|
changetype: modify
|
|
add: attributetypes
|
|
attributetypes: ( myAttribute-oid NAME ( 'myAttribute' )
|
|
DESC 'An attribute I defined for my LDAP application'
|
|
EQUALITY 2.5.13.2 SYNTAX 1.3.6.1.4.1.1466.115.121.1.15
|
|
USAGE userApplications )
|
|
-
|
|
add: ibmattributetypes
|
|
ibmattributetypes: ( myAttribute-oid DBNAME ( 'myAttrTable' 'myAttrColumn' )
|
|
ACCESS-CLASS normal LENGTH 200 )</pre><p class="indatacontent">See <a href="rzahyldapadd.htm#rzahyldapadd">ldapmodify and ldapadd</a> for
|
|
more information about this command.</p>
|
|
<a id="Bot_Of_Page" name="Bot_Of_Page"></a>
|
|
</body>
|
|
</html>
|