9.2. Managing Attributes

9.2. Managing Attributes

The Directory Server Console shows all attributes in the schema, and you can create, edit, and delete attribute extensions to the schema. The following sections describe how to manage attributes:

For information on managing object classes, see Section 9.3, “Managing Object Classes”.

9.2.1. Viewing Attributes

To view information about all attributes that currently exist in the directory schema, do the following:

  1. In the Directory Server Console, select the Configuration tab.

  2. In the left navigation tree, select the Schema folder, and then select the Attributes tab in the right pane.

    This tab contains information about all the standard (read-only) and user-defined attributes in the schema.

The fields and lists in the Attributes tab are described in Table 9.1, “Attributes Tab Reference”.

Field Description
Name The name of the attribute.
OID The object identifier of the attribute. An OID is a string, usually of dotted decimal numbers, that uniquely identifies an object, such as an object class or an attribute. If an OID is not specified, the Directory Server automatically uses attribute_name-oid. For example, if the attribute birthdate is created without supplying an OID, the Directory Server automatically uses birthdate-oid as the OID.

CAUTION

Using an alphanumeric OID such as birthdate-oid is deprecated and strongly discouraged because it will lead to interoperability problems. Red Hat strongly encourages that you request your own OID prefix from IANA (Internet Assigned Number Authority). For more information about OIDs or to request a prefix, email IANA at mailto:iana@iana.org, or visit the IANA website at http://www.iana.org/.

Syntax Sets the syntax for the attribute values. The attribute syntax can be, for example, any of the following:
Case Ignore String — Values for this attribute are not case-sensitive.
Case Exact String — Values for this attribute are case-sensitive.
Distinguished Name — Values for this attribute are DNs.
Binary — Values for this attribute are binary.
Telephone Number — Values for this attribute are in telephone number format.
Integer — Values for this attribute are numbers.
There are many more syntaxes available for attributes.
Multi If the attribute is multi-valued, an X appears in this column; otherwise, this field is blank. If this is not checked, the Directory Server only allows a single value for this attribute.
Table 9.1. Attributes Tab Reference

9.2.2. Creating Attributes

The Directory Server Console can create new attributes.

NOTE

After adding new attributes to the schema, create a new object class to contain them, as described in Section 9.3.2, “Creating Object Classes”.

To create a new attribute, do the following:

  1. In the Directory Server Console, select the Configuration tab.

  2. In the left navigation tree, select the Schema folder, and then select the Attributes tab in the right pane.

  3. Click Create.

    The Create Attribute dialog box opens.

  4. Enter a unique name for the attribute in the Attribute Name text box.

  5. Enter an object identifier for the attribute in the Attribute OID (Optional) text box.

    OIDs are described in Table 9.1, “Attributes Tab Reference”.

  6. Select a syntax that describes the data to be held by the attribute from the Syntax drop-down menu.

    Available syntaxes are described in Table 9.1, “Attributes Tab Reference”.

  7. To make the attribute multi-valued, select the Multi-Valued checkbox.

    Multi-valued means that the Directory Server allows more than one instance of the attribute per entry.

  8. Click OK.

9.2.3. Editing Attributes

Only user-created attributes can be edited. You cannot edit standard attributes. To edit an attribute, do the following:

  1. In the Directory Server Console, select the Configuration tab.

  2. In the left navigation tree, select the Schema folder, and then select the Attributes tab in the right pane.

  3. Select the attribute to edit in the User Defined Attributes table, and click Edit.

    The Edit Attribute dialog box opens.

    1. To change the attribute's name, enter a new one in the Attribute Name text box.

    2. To change the attribute's object identifier, enter a new one in the Attribute OID (Optional) text box. OIDs are described in Table 9.1, “Attributes Tab Reference”.

    3. To change the syntax that describes the data to be held by the attribute, choose a new one from the Syntax drop-down menu. Available syntaxes are described in Table 9.1, “Attributes Tab Reference”.

    4. To make the attribute multi-valued, select the Multi-Valued checkbox. Multi-valued means that the Directory Server allows more than one instance of the attribute per entry.

  4. Click OK.

9.2.4. Deleting Attributes

Only user-defined attributes can be deleted. You cannot delete standard attributes. To delete an attribute, do the following:

  1. Display the Attributes tab.

    This procedure is explained in Section 9.2.4, “Deleting Attributes”.

  2. In the User Defined Attributes table, select the attribute, and click Delete.

  3. If prompted, confirm the delete.

WARNING

The server immediately deletes the attribute. There is no undo.


Note: This documentation is provided {and copyrighted} by Red Hat®, Inc. and is released via the Open Publication License. The copyright holder has added the further requirement that Distribution of substantively modified versions of this document is prohibited without the explicit permission of the copyright holder. The CentOS project redistributes these original works (in their unmodified form) as a reference for CentOS-5 because CentOS-5 is built from publicly available, open source SRPMS. The documentation is unmodified to be compliant with upstream distribution policy. Neither CentOS-5 nor the CentOS Project are in any way affiliated with or sponsored by Red Hat®, Inc.