PingDirectory

Configuring subtree views

About this task

You provide clients access to a specific portion of the DIT creating a subtree view and assigning it to a client connection policy. You can configure subtree views from the command line or using the administrative console.

When you create a subtree view, you provide the following information to configure its properties:

  • Subtree view name

  • Base DN managed by the subtree view

  • Request processor used by the subtree view to route requests. If one does not exist already, you will create a new one.

Steps

  1. Use dsconfig to configure a subtree view.

  2. In the PingDirectoryProxy server’s main menu, enter the number associated with subtree view configuration.

  3. In the Subtree View menu, enter the number corresponding to creating a new subtree view.

  4. Enter a name for the subtree view.

  5. Enter the base DN of the subtree managed by this subtree view.

    Example:

    Enter a value for the ‘base-dn’ property:dc=example,dc=com
  6. Select a request processor for this subtree view to route requests or make the appropriate selection to create a new one.

    Example:

    Select a Request Processor for the ‘request-processor’ property:
    
    1) dc_example_dc_com-req-processor
    2) Create a new Request Processor
    
    ?) help
    c) cancel
    q) quit
    
    Enter choice [c]: 1
  7. Review the properties of the subtree view. If you are satisfied, enter f to finish.

    Example:

    >>>> Configure the properties of the Subtree View
     >>>> via creating 'example.com' Subtree View
    
            Property           Value(s)
            --------------------------------------------------
        1)  description        -
        2)  base-dn            "dc=example,dc=com"
        3)  request-processor  dc_example_dc_com-req-processor
    
        ?)  help
        f)  finish - create the new Subtree View
        d)  display the equivalent dsconfig arguments to create
            this object
        b)  back
        q)  quit

    Result:

    After they have been configured, you can assign one or more subtree views to any client connection policies.