Setting up the Example

Before running the example, you have to launch the LDAP server. In the examples, only Oracle Directory Server Enterprise Edition is used.

To launch Oracle Directory Server Enterprise Edition, locate the installation directory where it has been installed, then execute the following commands in the command console:

cd TIBCO_ADLDAP_HOME\bin

dsadm start instance-path

Launching JMS Service

Perform this operation only when you run BWadldapExample-JMS. To start JMS Service:

Select Start > Run from Windows menu, type the services.msc in the Open input field, and click the OK button.

In the Service Manager window, right-click the TIBCO EMS Server icon in the service list, and click the Start option.

JMS Server can be automatically started when you start Windows. To do this, right click the TIBCO EMS Server icon, and click the Properties option, and select the Automatic item from the Startup drop-down list, then click the OK button.

Opening the Example

Before running the examples, you must open the sample project. The examples are located in the TIBCO_HOME\adapter\adldap\version_num\examples directory. The directory contains two .dat files and one zip archive. The .dat files include the same examples as those in the zip archive, except for their file formats.

To open the .dat file:

Start the TIBCO Designer application, and click the New Empty Project button. Click the Browse button to navigate to the destination directory you want to save the project, then enter the project name, and click the OK button.

Select Project > Import Full Project, click the Browse icon, and navigate to TIBCO_ADLDAP_HOME\examples. Select the .dat file you want to import. In this example, select BWadldapExample-RV.

Click the OK button.

In the Import-Options dialog, select the Replace Existing Global Variables With Those In Import and Overwrite On Name Conflict radio buttons.

Click the Apply button.

Select Project > Save.

You can also unzip the zip archive to open the examples. Note that when you unzip the zip archive, the names of the directories that will contain the unzipped files must be different from either of the names of the two .dat files. Once the zip archive was unzipped, open the examples as follows:

Start the TIBCO Designer application.

Click the Open Existing Project button.

Click the Browse button and navigate to the unzipped BWadldapExample-RV or BWadldapExample-JMS folder, and choose BWadldapExample-RV for this example.

Click the OK button.

Customizing the Example

Before running the Operations, ReceivePub, Search, and TestSubService processes, you need to complete the following steps (these steps are the same for each of the four processes):

In the Project panel, click the OracleDirectoryServerEnterpriseEdition item.

Click the Design-time Connection tab and specify all possible parameters according to the actual settings of your Oracle Directory Server. For details, see the Design-time Connection tab in TIBCO ActiveMatrix Adapter for LDAP Configuration and Deployment.

Click the Test Connection button to verify that the parameters you entered are correct for your setup.

To use SSL for the Design-time connection to the LDAP server, check the Use SSL checkbox, and go to the step 5. If you uncheck the Use SSL checkbox, go to the step 7.

There are three options in the Authentication Mode drop-down list, Simple, Anonymous, and External. Specify all possible values according to the option you select. See TIBCO ActiveMatrix Adapter for LDAP Configuration and Deployment for details.

Specify other available parameters, including Trusted Certificate Authorities, Client Identity, and Identity Password.

Click the Apply button.

If you do not check the Use Design-time Connection For Runtime checkbox in the Design-time Connection tab, you have to specify the parameters in the Runtime tab. For some of the parameters (such as LDAP Port, UserDN, Password, and so on if they are not greyed out), you can either specify directly the correct values of these parameters or you can use global variables to represent their real values. In this example, the global variables are used in order to demonstrate how to use them to modify the value of these parameters. To modify them, follow the instructions in steps 9 and 10.

Click the Global Variables panel, expand the ODSEE folder, and select the NonSSLPORT item. Click the Pen button

at the top of the left corner in this panel, and enter the correct values for the NonSSLPORT, UserDN, and UserPWD variables.

Figure 1 Edit Global Variables

10.

Click the OK button. Select Project > Save.

11.

Select Tools > Show Adapter Tester. Click the OracleDirectoryServerEnterpriseEdition item.

12.

Under the Run Settings tab, specify the Working Directory (if this directory does not yet exist, it will be created). Choose the adapter that you are currently using in the Adapter Executable field. In this example, TIBCO ActiveMatrix Adapter for LDAP 6.1 (adldap.exe) is used.

13.

Click the Start button. If a dialog asks you whether or not you want to save the project, click the OK button. Click the Console tab to make sure that the adapter has been successfully started. Do not close the Run Settings dialog before you finish running the examples.

Figure 2 Start Adapter Tester