test

LDAP Binding Component User's Guide

Runtime Configuration

The LDAP Binding Component's runtime properties can be configured from the NetBeans IDE, or from a command prompt (command line interface) during installation. The LDAP BC runtime properties apply to all instances of the binding component across the domain.

The following topics describe the runtime properties of the LDAP BC and how to access them:

Accessing the LDAP Binding Component Runtime Properties

You can view and modify the runtime properties from the Service window of the NetBeans IDE. The LDAP BC must be started before you can modify any of the properties.

ProcedureTo Access the LDAP Binding Component Runtime Properties

  1. From the Services tab of the NetBeans IDE, expand the Servers node.

  2. If the application server is not started, right-click the server name and select Start.

  3. Under the application server, expand the JBI-> Binding Components nodes, and then right-click sun-ldap-binding.

  4. Click Start.

  5. Right-click sun-ldap-binding again, and then click Properties.

    The LDAP BC Properties window appears. You can also select the binding component to display the Properties panel in the right side of the IDE.

    Edit the properties as needed. To apply any changes you make to the Application Configuration and Application Variables properties, shut down and restart the affected composite applications. Any changes in the Number of Threads property and to the Logger settings are applied dynamically without restarting the LDAP BC.

LDAP Binding Component Runtime Properties

The LDAP Binding Component runtime properties are categorized into the following types:

General Properties

The following table lists and describes each general property for the LDAP BC. These properties are for reference purpose only and cannot be modified.

Name 

Description 

Description 

The purpose of the LDAP Binding Component. 

Name 

The name of the LDAP Binding Component.  

State 

Indicates the state of the LDAP Binding Component, either Started or Stopped.  

Type 

Indicates the type of component (service-engine or binding-component). 

Identification Properties

The following table lists and describes each identification property for the LDAP BC. These properties are for reference purpose only and cannot be modified.

Name 

Description 

Version 

The LDAP Binding Component specification fully supported by this build. 

Build Number 

Date and time stamp for the current build. 

Configuration Properties

The following table lists and describes each configuration property for the LDAP BC. These properties are for reference purpose only and cannot be modified.

Name 

Description 

Number of Outbound Processor Threads 

Specifies the maximum number of threads to process outbound LDAP client invocations concurrently. The value can be any integer from 1 to 10,000.  

Number of Retries 

The number of times the LDAP BC will attempt to connect to the LDAP server. 

Time Between Retries 

The period of time in milliseconds that the LDAP BC will wait between attempts to connect to the LDAP server. 

Recovery Type 

An action to take on recovery. The available options are ERROR, DELETE, and SUSPEND. 

Allow Connection Pooling 

An indicator of whether connection pooling is enabled. Select the check box to enable connection pooling for connecting to the LDAP server. 

Connection Pool Preferred Size 

The preferred number of connections to maintain concurrently for each connection identity. 

Connection Pool Maximum Size 

The maximum number of connections that will be maintained concurrently for each connection identity. 

Maximum Idle Timeout for Pooled Connection 

The maximum period of time in milliseconds that a connection can remain idle in the pool. 

Connection Pool Protocol 

The type of protocol to use for the pooled connections. 

Choose from the following options:

  • plain ssl: Pools connections that use simple or no authentication and pools that use SSL.

  • plain: Pools connections that use simple or no authentication.

  • ssl:Pools connections that use SSL connections.

Connection Pool Authentication 

The type of authentication to use for the pooled connections.  

Choose from the following options:

  • none: No authentication is required. Use this for anonymous access.

  • simple: Authentication requires a user name and password.

  • none simple: Authentication can be simple or not required.

  • strong: A stronger authentication is required.

Allow Dynamic Endpoint 

An indicator of whether dynamic endpoints are allowed. Select the check box to allow them. 

Application Configuration 

Specifies the values for a Composite Application's endpoint connectivity parameters (normally defined in the WSDL service extensibility elements), and applies these values to a user-named endpoint ConfigExtension property. The Application Configuration property editor includes fields for all of the connectivity parameters that apply to that component's binding protocol.  

Application Variables 

Specifies a list of name and value pairs for a given type. The application variable name can be used as a token for a WSDL extensibility element attribute in a corresponding binding.  

The Application Variables configuration property offers four variable types: 

  • String: Specifies a string value, such as a path or directory

  • Number: Specifies a number value

  • Boolean: Specifies a Boolean value

  • Password: Specifies a password value

Statistics Properties

Statistics properties include several different component activities including exchanges, errors, requests, replies, and so on. It lists component statistics that are collected for actions such as completed exchanges, activated endpoints, and up time. Running statistics are automatically collected and displayed

Loggers Properties

Loggers properties include several different component activities that can be recorded by the server.log. The Logger properties specify the user-designated level of logging for an event.

Each logger can be set to record information at any of the following levels: