8.4. Managing Custom Schema in the Console

The Directory Server Console shows all attributes in the schema, and custom attributes can be created, edited, and deleted from the schema.

8.4.1. Viewing Attributes and Object Classes

All of the information about the attributes and object classes which are currently loaded in the server instance are visible with the other server configuration.
  1. In the Directory Server Console, select the Configuration tab.
  2. In the left navigation tree, select the Schema folder.
  3. There are three tabs which display the schema elements loaded in Directory Server: Object Class, Attributes, and Matching Rules.
The Attributes tab is broken into two sections for default and custom attributes. Both sections show the attribute name, OID, syntax, and whether the attribute is multi-valued.
The Object Classes tab shows the list of object classes on the left. When an object class is highlighted, its OID and superior object class are listed in the fields at the top and its required and allowed attributes are listed in the boxes on the right.

8.4.2. Creating Attributes

Note

After adding new attributes to the schema, create a new object class to contain them, as described in Section 8.4.3, “Creating Object Classes”.
  1. 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.
  4. Fill in the information for the new attribute.
    • The attribute name; this must be unique.
    • The OID; this is not required, but for compatibility and server performance, assigning a unique numeric OID is strongly recommended.
    • The syntax; this is the allowed format for the attributes values.
    • Whether the attribute is multi-valued; by default, all attributes can be used more than once in an entry, but deselecting the check box means the attribute can be used only once.
  5. Click OK.

8.4.3. Creating Object Classes

A new object class must be created with a unique name, a parent object, and required and optional attributes. To create an object class:
  1. In the Directory Server Console, select the Configuration tab.
  2. In the navigation tree, select the Schema folder, and then select the Object Classes tab in the right pane.
  3. Click the Create button in the Object Classes tab.
  4. Fill in the information about the new object class.
    • The name; this must be unique.
    • The OID; this is not required, but for compatibility and server performance, assigning a unique numeric OID is strongly recommended.
    • The superior object class for the entry. The default is top; selecting another object class means that the new object class inherits all of the required and allowed attributes from the parent, in addition to its own defined attributes.
    • Required and allowed attributes. Select the attributes on the left and used the Add buttons by the Available Attributes and Required Attributes boxes to add the attributes as appropriate.

    Note

    Attributes that are inherited from the parent object classes cannot be removed, regardless of whether they are allowed or required.
  5. Click OK to save the new object class.

8.4.4. Editing Custom Schema Elements

Only user-created attributes or object classes can be edited; standard schema elements cannot be edited.
  1. In the Directory Server Console, select the Configuration tab.
  2. In the left navigation tree, select the Schema folder.
  3. Open the Object Classes or Attributes tab.
  4. Select the schema element to edit from the list. Only custom (user-defined) schema can be edited in the Directory Server Console.
  5. Click the Edit button at the bottom of the window.
  6. Edit any of the schema information.

8.4.5. Deleting Schema

Only user-created attributes or object classes can be deleted; standard schema elements cannot be deleted.
  1. In the Directory Server Console, select the Configuration tab.
  2. In the left navigation tree, select the Schema folder.
  3. Open the Object Classes or Attributes tab.
  4. Select the schema element to delete from the list. Only custom (user-defined) schema can be deleted in the Directory Server Console.
  5. Click the Delete button at the bottom of the window.
  6. Confirm the deletion.

Warning

The server immediately deletes the schema element. There is no undo.