Apq
/
389-ds-base
mirror of https://github.com/389ds/389-ds-base.git


			
							123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712
							<!-- --- BEGIN COPYRIGHT BLOCK ---
 This Program is free software; you can redistribute it and/or modify it under
 the terms of the GNU General Public License as published by the Free Software
 Foundation; version 2 of the License.

 This Program is distributed in the hope that it will be useful, but WITHOUT
 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
 FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

 You should have received a copy of the GNU General Public License along with
 this Program; if not, write to the Free Software Foundation, Inc., 59 Temple
 Place, Suite 330, Boston, MA 02111-1307 USA.

 In addition, as a special exception, Red Hat, Inc. gives You the additional
 right to link the code of this Program with code not covered under the GNU
 General Public License ("Non-GPL Code") and to distribute linked combinations
 including the two, subject to the limitations in this paragraph. Non-GPL Code
 permitted under this exception must only link to the code of this Program
 through those well defined interfaces identified in the file named EXCEPTION
 found in the source code files (the "Approved Interfaces"). The files of
 Non-GPL Code may instantiate templates or use macros or inline functions from
 the Approved Interfaces without causing the resulting work to be covered by
 the GNU General Public License. Only Red Hat, Inc. may make changes or
 additions to the list of Approved Interfaces. You must obey the GNU General
 Public License in all respects for all of the Program code and other code used
 in conjunction with the Program except the Non-GPL Code covered by this
 exception. If you modify this file, you may extend this exception to your
 version of the file, but you are not obligated to do so. If you do not wish to
 provide this exception without modification, you must delete this exception
 statement from your version and license this file solely under the GPL without
 exception. 

 
 Copyright (C) 2001 Sun Microsystems, Inc. Used by permission.
 Copyright (C) 2005 Red Hat, Inc.
 All rights reserved.
  --- END COPYRIGHT BLOCK ---  -->
<HTML>
<HEAD>
<TITLE>Adding Directory Entries
</TITLE></HEAD>
<BODY>

<H1>
<A NAME="adding"></A>Adding Entries</H1>
You can add new entries to the directory
using the Directory Server interface. To add
entries, your Directory Server administrator must have granted you the right
to do so. Before you can add an entry, you must <A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/auth.htm#userauth">authenticate</A>
to the Directory Server.

<P>Using the Directory Server interface you can add:
<UL>
<LI>
<A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/add.htm#person">a person</A></LI>

<LI>
<A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/add.htm#NTperson">an NT person</A></LI>

<LI>
<A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/add.htm#group">a group</A></LI>

<LI>
<A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/add.htm#NTgroup">an NT group</A></LI>

<LI>
<A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/add.htm#ou">an organizational unit</A></LI>

<LI>
<A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/add.htm#dc">a domain</A></LI>
<LI>
<A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/add.htm#o">an organization</A></LI>
</UL>
Before you add an entry for the first time, read the <A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/add.htm#guidelines">New
Entry Guidelines</A> section for important information about the directory
tree structure and naming conventions.
<H2>
<A NAME="guidelines"></A>New Entry Guidelines</H2>
Before you begin adding entries to the directory, make sure that you understand
the following directory concepts:
<UL>
<LI>
<A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/add.htm#tree">directory tree structure</A></LI>

<LI>
<A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/add.htm#DN">distinguished name syntax</A></LI>

<LI>
<A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/add.htm#uniqueDN">unique distinguished names</A></LI>
</UL>

<H3>
<A NAME="tree"></A>Directory Tree Structure</H3>
Data in the directory is arranged in a tree hierarchy. The top of the tree
is known as the root or suffix. The root entry usually represents the
organization entry for the directory.

<BLOCKQUOTE><B>Note:</B>
<P>

Although your directory may contain more than one suffix, the directory
server interface only allows you to search for, add, and edit entries in
a single suffix. Make sure that you know which suffix your Directory Server
interface is supporting before adding new entries.
</BLOCKQUOTE>


<P>Below the root are branches of the tree, which usually represent organizational
units such as marketing or accounting. Entries for people and resources
within your organization are usually contained below these organizational
unit branches within the directory tree structure.

<P>When you add an entry, make sure that an entry representing a branch
point is created before new entries are created under that branch. For
example, if you want to place entries in a Marketing subtree and in an
Accounting subtree, then create the branch point for those subtrees before
creating entries within the subtrees:

<PRE>          o=Example.com
          ou=Marketing, o=Example.com
          ...
          <I>Marketing subtree entries</I>
          ...
          ou=Accounting, o=Example.com
          ...
          <I>Accounting subtree entries</I>
</PRE>

<H3>
<A NAME="DN"></A>Distinguished Name Syntax</H3>
An entry is uniquely identified within the Directory Server through the
use of a distinguished name (DN). A DN identifies the entry by using a
series of comma-separated attributes and attribute values. The left-most
value in the DN represents the entry's name, with each subsequent
attribute representing a branch point above the entry. For example:

<PRE>uid=bjensen, ou=people, o=example.com</PRE>

This DN represents the entry named <I>bjensen</I> in the subdirectory named
<I>people</I> in the directory named <I>example.com</I>.

<P>When you add a new entry to the Directory Server, you are prompted
to enter the complete distinguished name.
<H3><A NAME="uniqueDN"></A>Unique Distinguished Names</H3>

The Directory Server interface does not allow you to create a duplicate
entry. To avoid naming duplications, use distinguished names that begin
with the person's user ID (uid) rather than the person's common name (CN).
Choose user IDs that are readable; that is,
do not use a random collection of letters and numbers for
user IDs. If your enterprise already has an email system, one possibility
would be to use the left-most value of each person's email address as that
person's user ID. For example, if a person has the email address:

<P>[email protected]

<P>then give that person's directory entry the following DN:

<P>uid=bjensen, o=example.com

<H2><A NAME="person"></A>Adding a Person</H2>

To add a new person entry, do the following:
<OL>
<LI>
Click the New Entry tab.</LI>

<LI>
Follow the steps outlined in the New Entry form. When you are done
filling in this form, click Continue. To cancel the operation click
the Back button in your browser window.</LI>

<LI>
If you have not authenticated before you attempt to add a new entry, or
if your authentication has expired, the Directory Server prompts you
to <A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/auth.htm#userauth">authenticate</A> before continuing.</LI>

<LI>
When you add a person to the directory, a form that
allows you to edit that person's data is displayed. This form is displayed in
a new web browser window. You must supply values for the required fields.
The required fields for a person are:</LI>

<UL type="disc">
<LI>
<A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#cn">Full Name</A></LI>

<LI>
<A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#surname">Last Name</A></LI>
</UL>

<LI>
You can provide values for the optional fields now, or add them later.
The optional fields for a person are:</LI>
 
<P>
<CENTER><TABLE BORDER=2 >
<TR>
<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#givenName">First Name</A> </TD>

<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#telephoneNumber">Phone</A></TD>

<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#mail">Email Address</A> </TD>
</TR>

<TR>
<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#facsimileTelephoneNumber">Fax</A> </TD>

<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#uid">User ID</A></TD>

<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#pager">Pager</A></TD>
</TR>

<TR>
<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#mobile">Mobile Phone</A> </TD>

<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#businessCategory">Business Category</A> </TD>

<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#title">Title</A></TD>
</TR>

<TR>
<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#ou">Organizational Unit</A> </TD>

<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#manager">Manager</A> </TD>

<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#roomNumber">Room Number </A></TD>
</TR>

<TR>
<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#secretary">Admin </A></TD>

<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#departmentNumber">Dept# </A></TD>

<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#employeeNumber">Emp#</A> </TD>
</TR>

<TR>
<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#carLicnese">Car License# </A></TD>

<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#postalAddress">Mailing Address </A></TD>

<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#description">Description</A> </TD>
</TR>

<TR>
<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#seeAlso">See Also </A></TD>

<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#labeledUri">URL </A></TD>

<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#userPassword">Password</A> </TD>
</TR>
</TABLE>
</CENTER>
<BLOCKQUOTE><B>Note:</B>
<P>
You cannot enter values into the Manager, Admin,
or See Also fields until you have saved the entry. Furthermore, changing uid in the New Entry screen will result in a multi-valued uid with the value selected in the first screen as the naming component.</BLOCKQUOTE>

<LI>
To cancel the entry creation, close the web browser window containing
the form. When you are done filling in the form, click the Save New
Person button at the top of the form.</LI>

<LI>
After saving the entry, you can <A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/mod.htm#addmanager">add values
to the Manager and Admin fields</A> or <A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/mod.htm#addowner">add
a See Also value</A>.</LI>
</OL>

<H2>
<A NAME="NTperson"></A>Adding an NT Person</H2>
When creating an NT-person entry, make sure that the subtree
in which you place the entry is the same subtree that the synchronization service
uses to synchronize entries. If you place an NT-person entry into another
location, it is not synchronized with the Windows network.

<P>To add a new NT-person entry, do the following:
<OL>
<LI>
Click the New Entry tab.</LI>

<LI>
Follow the steps outlined in the New Entry form. When you are done
filling in this form, click Continue. To cancel the operation click
the Back button in your browser window.</LI>

<LI>
If you have not authenticated before you attempt to add a new entry, or
if your authentication has expired, the Directory Server prompts you
to <A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/auth.htm#userauth">authenticate</A> before continuing.</LI>

<LI>
When you add an NT-person to the directory, a form that allows you to
edit that person's data is displayed. This form is displayed
in a new web browser window. You must supply values for the required fields.
The required fields for an NT-person are:</LI>

<UL type="disc">
<LI>
<A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#commonName">Full Name</A></LI>

<LI>
<A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#surname">Last Name</A></LI>

<LI>
<A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#ntUserDomainId">NT Domain Name</A></LI>

<LI>
<A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#uid">NT User ID</A></LI>
</UL>

<LI>
You can provide values for the optional fields now, or add them later.
The optional fields for a person are:</LI>

<P>
<CENTER><TABLE BORDER=2>
<TR>
<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#givenName">First Name</A> </TD>

<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#telephoneNumber">Phone </A></TD>

<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#mail">Email Address</A> </TD>
</TR>

<TR>
<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#fax">Fax </A></TD>

<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#userPassword">Directory Server Password</A> </TD>

<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#pager">Pager</A> </TD>
</TR>

<TR>
<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#mobile">Mobile Phone</A> </TD>

<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#businessCategory">Business Category</A> </TD>

<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#title">Title</A> </TD>
</TR>

<TR>
<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#organizationalUnitName">Organizational Unit</A> </TD>

<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#manager">Manager</A> </TD>

<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#roomNumber">Room Number</A> </TD>
</TR>

<TR>
<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#secretary">Admin </A></TD>

<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#departmentNumber">Dept#</A> </TD>

<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#employeeNumber">Emp#</A> </TD>
</TR>

<TR>
<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#carLicnese">Car License#</A> </TD>

<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#postalAddress">Mailing Address</A> </TD>

<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#description">Description</A> </TD>
</TR>

<TR>
<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#seeAlso">See Also</A> </TD>

<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#labeledURI">URL</A> </TD>

<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#userid">User Id</A></TD>
</TR>
</TABLE></CENTER>
<BLOCKQUOTE><B>Note:</B>
<P>
You cannot enter values into the Manager, Admin,
or See Also fields until you have saved the entry.
</BLOCKQUOTE>

<LI>
You can also change the value for the following two options:</LI>

<UL type="disc">
<LI>
<A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#NTUserDelete">Delete NT Account if Person deleted</A></LI>

<LI>
<A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#NTUserCreateNewAccount">Create New NT Account</A></LI>
</UL>
The default value is shown. If you do not change the value,
the default value is used.
<LI>
When you are done filling in the form, click the Save New NT Person
button at the top of the form. To cancel the entry creation,
close the web browser window containing the form.</LI>

<LI>
After saving the entry, you can <A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/mod.htm#addmanager">add values
to the Manager and Admin fields</A> or <A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/mod.htm#addowner">add
a "See Also" value</A>.</LI>
</OL>

<H2>
<A NAME="group"></A>Adding a Group</H2>
To add a new group entry, do the following:
<OL>
<LI>
Click the New Entry tab.</LI>

<LI>
Follow the steps outlined in the New Entry form. When you are done
filling in this form, click Continue. To cancel the operation click
the Back button in your browser window.</LI>

<LI>
If you have not authenticated before you attempt to add a new entry, or
if your authentication has expired, the Directory Server prompts you
to <A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/auth.htm#userauth">authenticate</A> before continuing.</LI>

<LI>
When you add a group to the directory, a form that
allows you to edit that group's data is displayed. This form is displayed in
a new web browser window. You must supply a value for the required field 
<A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#cn">Name</A>.</LI>

<LI>
You can provide a value for the optional <A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#description">Description</A>
field now, or add it later.</LI>

<BLOCKQUOTE><B>Note:</B>
<P>
You cannot enter values into the Owner, Group Members,
or See Also fields until you have saved the entry.</BLOCKQUOTE>

<LI>
When you are done filling in the form, click the Save New Group button
at the top of the form.</LI>

<BR>To cancel the entry creation, close the web browser window containing
the form.
<LI>
After you have saved the entry, you can <A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/mod.htm#addowner">add
values for the Owner, Group Member, and See Also fields</A>.</LI>
</OL>

<H2>
<A NAME="NTgroup"></A>Adding an NT Group</H2>
To add a new NT group entry, do the following:
<OL>
<LI>
Click the New Entry tab.</LI>

<LI>
Follow the steps outlined in the New Entry form. When you are done
filling in this form, click Continue. To cancel the operation click
the Back button in your browser window.</LI>

<LI>
If you have not authenticated before you attempt to add a new entry, or
if your authentication has expired, the Directory Server prompts you
to <A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/auth.htm#userauth">authenticate</A> before continuing.</LI>

<LI>
When you add an NT-group to the directory, a form
that allows you to edit that group's data is displayed. This form is contained
in a new web browser window. You must supply a value for the required fields.
The required fields for an NT-group are:</LI>

<UL type="disc">
<LI>
<A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#cn">Name</A></LI>

<LI>
<A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#ntGroupId">NT Group Name</A></LI>

<LI>
<A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#ntGroupType">NT Group Type</A></LI>

<LI>
<A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#ntGroupDomainId">NT Group Domain</A></LI>
</UL>

<LI>
You can provide values for the optional fields now, or add them later.
The optional fields for an NT group are:</LI>
<P>
<CENTER><TABLE BORDER=2>
<TR>
<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#description">Description</A> </TD>

<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#owner">Owner</A> </TD>

<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#l">Locale</A></TD>
</TR>

<TR>
<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#uniqueMember">NT Group Members</A> </TD>

<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#seeAlso">See Also</A></TD>

<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#ou">Organizational Unit</A></TD>
</TR>
</TABLE>
</CENTER>
<P>
<BLOCKQUOTE><B>Note:</B>
<P>
You cannot enter values into the Owner, NT Group Members,
or See Also fields until you have saved the entry.</BLOCKQUOTE>

<LI>
You may also change the value for the <A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#NTGroupDelete">Delete NT Group if Group Deleted</A> option.</LI>

<LI>
When you are done filling in the form, click the Save New Group button
at the top of the form.</LI>

<BR>To cancel the entry creation, close the web browser window containing
the form.
<LI>
After you save the entry, you can <A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/mod.htm#addowner">add values
for the NT Group Members, Owner, and See Also fields</A>.</LI>
</OL>

<H2>
<A NAME="ou"></A>Adding an Organizational Unit</H2>
To add a new organizational unit entry, do the following:
<OL>
<LI>
Click the New Entry tab.</LI>

<LI>
Follow the steps outlined in the New Entry form. When you are done
filling in this form, click Continue. To cancel the operation click
the "Back" button in your browser window.</LI>

<LI>
If you have not authenticated before you attempt to add a new entry, or
if your authentication has expired, the Directory Server prompts you
to <A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/auth.htm#userauth">authenticate</A> before continuing.</LI>

<LI>
When you add an organizational unit to the directory, a form that
allows you to edit that organization's data is displayed. This
form is displayed in a new web browser window. You must supply
a value for the required field, <A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#ou">Unit Name</A>.</LI>

<LI>
You can provide values for the optional fields now, or add them later.
The optional fields for an organizational unit are:</LI>
<P>
<CENTER><TABLE BORDER=2 >
<TR>
<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#description">Description</A> </TD>

<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#telephoneNumber">Phone</A> </TD>

<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#businessCategory">Business Category</A> </TD>
</TR>

<TR>
<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#fax">Fax</A> </TD>

<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#localityName">Location</A> </TD>

<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#postalAddress">Mailing Address</A> </TD>
</TR>

<TR>
<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#seeAlso">See Also</A> </TD>

<TD> </TD>

<TD> </TD>
</TR>
</TABLE></CENTER>
<P>
<LI>
When you are done filling in the form, click the Save New Org. Unit
button at the top of the form. To cancel the entry creation, close
the web browser window containing the form.</LI>
</OL>

<H2><A NAME="dc"></A>Adding a Domain Component</H2>

To add a new domain entry, do the following:
<OL>
<LI>
Click the New Entry tab.</LI>

<LI>
Follow the steps outlined in the New Entry form. When you are done
filling in this form, click Continue. To cancel the operation click
the Back button in your browser window.</LI>

<LI>
If you have not authenticated before you attempt to add a new entry, or
if your authentication has expired, the Directory Server prompts you
to <A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/auth.htm#userauth">authenticate</A> before continuing.</LI>

<LI>
You must supply a value for the required field, <A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#dc">dc</A>.</LI>

<LI>
You can provide values for the optional fields now, or add them later.
The optional fields for a domain are:</LI>
<P>
<CENTER><TABLE BORDER=2>
<TR>
<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#description">Description</A></TD>
<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#telephoneNumber">Phone</A></TD>
<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#businessCategory">Business Category</A></TD></TR>
<TR>
<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#fax">Fax</A></TD>
<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#localityName">Location</A></TD>
<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#postalAddress">Mailing Address</A></TD></TR>

<TR>
<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#seeAlso">See Also</A></TD>
<TD>&nbsp;</TD>
<TD>&nbsp;</TD></TR>
</TABLE>
</CENTER>
<P>
<LI>
When you are done filling in the form, click the Save New dc button
at the top of the form. To cancel the entry creation, close the
web browser window containing the form.</LI>
</OL>

<H2><A NAME="o"></A>Adding an Organization</H2>

To add a new organization entry, do the following:
<OL>
<LI>
Click the New Entry tab.</LI>

<LI>
Follow the steps outlined in the New Entry form. When you are done
filling in this form, click Continue. To cancel the operation click
the Back button in your browser window.</LI>

<LI>
If you have not authenticated before you attempt to add a new entry, or
if your authentication has expired, the Directory Server prompts you
to <A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/auth.htm#userauth">authenticate</A> before continuing.</LI>

<LI>
Adding an organization is supported only when you initially populate your
directory tree. The organization you add must match the organization
you specified in the Database Subtree field when you installed your
Directory Server. For example, if you specified a value of:</LI>

<PRE>o=Example.com</PRE>

to the Database Subtree field, then you must specify a value of:

<PRE>o=Example.com</PRE>

when you add the organization. The Directory Server checks the add operation to ensure that the directory entry can
exist with the database subtree. Any value other than:

<PRE>o=Example.com</PRE>

clearly cannot reside under:

<PRE>o=Example.com</PRE>

As a result, the Directory Server rejects the operation.
<LI>
You must supply a value for the required field, <A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#organizationName">Organization Name</A>.</LI>

<LI>
You can provide values for the optional fields now, or add them later.
The optional fields for an organization are:</LI>
<P>
<CENTER><TABLE BORDER=2>
<TR>
<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#description">Description</A> </TD>

<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#telephoneNumber">Phone</A> </TD>

<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#businessCategory">Business Category</A> </TD>
</TR>

<TR>
<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#fax">Fax</A> </TD>

<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#localityName">Location</A> </TD>

<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#postalAddress">Mailing Address</A> </TD>
</TR>

<TR>
<TD><A href="/clients/dsgw/bin/lang?<!-- GCONTEXT -->&file=.MANUAL/attribut.htm#seeAlso">See Also</A> </TD>

<TD> </TD>

<TD> </TD>
</TR>
</TABLE>
</CENTER>
<P>
<LI>
When you are done filling in the form, click the Save New Org. button
at the top of the form. To cancel the entry creation, close the
web browser window containing the form.</LI>
</OL>

</BODY>
</HTML>