Index of /pub/mirrors/ftp.novell.com/forge/bns_ldapcmd

 Name                               Last modified      Size  Description
 Parent Directory                                        -   
 CHANGELOG.html                     17-Feb-2005 16:25  4.9K  
 DEPENDENCIES.html                  18-Feb-2005 15:58  1.6K  
 DOCUMENTATION.html                 24-Jan-2005 00:00  132   
 LICENSE.txt                        11-Nov-2004 00:00   11K  
 README.html                        13-Jan-2005 00:00   21K  
 SAMPLECODE.html                    24-Jan-2005 00:00  132   
 builds/                            27-Aug-2008 01:30    -   

LDAP Command Beans (Beans for Novell Services)

1.0 Introduction

The LDAP Command beans (eCommerce Beans) provide easy-to-use Java* components to integrate web applications with LDAP directories and enable authentication and read/write directory access along with features such as contextless login and password management. These components are based on the Model-View-Controller (MVC) architecture, use open protocols, and have no dependencies on native code.

Novell provides the following LDAP Command Beans:

• AuthenticateLdap
• ContextlessLoginLdap
• ListLdapEntries
• CreateLdapEntry
• ReadLdapEntry
• ReadLdapAttribute
• ModifyLdapEntry
• DeleteLdapEntry
• ChangePasswordLdapEntry
• SetPasswordLdapEntry
• GetEffectiveRightsLdapEntry
• GetEffectiveRightsLdapAttribute
• UnauthenticateLdap

• Schema Beans

  • CreateLdapSchemaAttribute
  • CreateLdapSchemaObjectClass
  • DeleteLdapSchemaAttribute
  • DeleteLdapSchemaObjectClass
  • ListLdapSchemaAttributes
  • ListLdapSchemaMatchingRules
  • ListLdapSchemaObjectClasses
  • ListLdapSchemaSyntaxDefinitions
  • ModifyLdapSchemaAttribute
  • ModifyLdapSchemaObjectClass
  • ModifyLdapSchemaObjectClass
  • ReadLdapSchemaMatchingRule
  • ReadLdapSchemaObjectClass
  • ReadLdapSchemaSyntaxDefinition

• LDAP Transaction Beans

  • BeginLDAPTransaction
  • CommitLDAPTransaction
  • AbortLDAPTransaction

• PartitionReplica Beans

  • AbortPartitionOperation
  • AddReplica
  • ChangeReplicaType
  • CreatePartition
  • GetPartitionEntryCount
  • GetReplicaInfo
  • GetReplicationFilter
  • ListReplicas
  • MergePartitions
  • ReceiveAllUpdates
  • RemoveReplica
  • SendAllUpdates
  • SetReplicationFilter
  • SyncPartition
  • TriggerBackProcess

• PersistentSearch Beans

  • LdapPersistentSearch
  • StopLdapPersistentSearch
  • PSearchEvent
  • PSearchHandler
  • PSearchListener

The Novell Developer Web site provides information about the updates to the JavaBeans. Visit this site to download new beans and view updated versions of the documentation and component features.

2.0 What's New

• The LDAP Command Beans can now perform persistent search. The PersistentSearch beans are included in the ecbldap.jar file.
• AuthenticateLdap class has been modified and methods have been added to accept password as char[] also.

3.0 Documentation

After you have installed the documentation, use the NDK Documents entry on your Start menu to quickly locate and access NDK documentation.

The documentation for the beans consists of html files and graphics files in several different directories.

To view the documentation, locate the index.html file in the [install location]\doc directory and open that file in your Web browser.

4.0 Bean Dependencies

For all beans, the following are required:

• JVM 1.1.7 or above for NetWare or Windows*/Solaris/Linux. The JVM for NetWare can be downloaded from the NDK site.The JVM for the other platforms can be downloaded from the Sun Java site.
• Requirements for PartitionReplica Command Beans:
  • LDAP Extensions and Controls for JNDI. This can be downloaded from the NDK site.

5.0 CLASSPATH Variable

Add the following libraries to your CLASSPATH:

• ecbpr.jar

Add the following LDAP Command Beans libraries to the CLASSPATH.

• ecb.jar
• ecbldap.jar

Add the LDAP extensions and controls for JNDI library - novbp.jar to the CLASSPATH

6.0 Sample Programs

Sample programs are provided to demonstrate the usage of the Beans. They are bundled with the software package. The samples can also be downloaded from the NDK site. By default, the samples are copied to c:\novell\ndk\samples\ecb_samples directory. The PartitionReplica Command Beans samples are copied to c:\novell\ndk\samples\beans\bns_prcmd_sample directory.

6.1 Running the Sample Programs on a NetWare 6.0 Server

1. Copy the samples from the installation directory to tomcat_home\webapps\example\jsp directory on the NetWare server.

   NOTE:  Tomcat_home is the directory where Apache Tomcat is installed.

2. Copy the jar files ecb.jar, and ecbldap.jar listed in the section 5.0 CLASSPATH Variable to tomcat_home\webapps\bns_ldapcmd_sample\WEB-INF\lib directory.

3. Restart the Tomcat server.

4. To run the sample from the Web browser, use the following URL:

   http://server_name:8080/bns_ldapcmd_sample.

6.2 Running Sample Programs for PartitionReplica Command Beans on NetWare 6.0 Server

1. Copy the bns_prcmd_sample directory from the installed location to tomcat_home\webapps directory on the NetWare server.

   NOTE:  tomcat_home is the directory in which Apache Tomcat is installed.

2. Copy the jar files ecb.jar, ecbldap.jar, ecbpr.jar, and novbp.jar listed in the section 5.0 CLASSPATH Variable tomcat_home\webapps\bns_prcmd_sample\WEB-INF\lib directory.

3. Restart Tomcat server to save the settings.

4. To run the sample from the Web browser, use the following URL:

   http://server_name:8080/bns_prcmd_sample

6.3 Running Sample Programs for Ldap Command Beans on a NetWare 6.5 Server

1. (Conditional). If NetWare 6.5 server is installed with Apache/Tomcat pattern selected, the LDAp Command beans samples are configured at install time and can be accessed through server welcome page or by using the following URL:

   http://server_name/ecb

2. (Conditional). If NetWare server is not installed with Apache/Tomcat pattern selected, these samples are not configured at install time. The samples can be configured using one of the following steps.

   1. Perform a post-install for Beans for Novell Services.

   2. Add the following Include statement at the end of Apache conf file, httpd.conf found in apache_home\conf directory:

      Include sys:/tomcat/4/conf/beans-Apache.conf

      NOTE:  Apache_home is the directory where Apache is installed.

3. Restart Tomcat and Apache.

4. To run the sample from the Web browser, use the following URL:

   http://server_name/ecb

6.4 Running Sample Programs for PartitionReplica Command Beans on a NetWare 6.5 Server

1. Copy the bns_prcmd_sample directory from the installation directory to tomcat_home\webapps directory on the NetWare server.

   NOTE:  Tomcat_home is the directory where Apache Tomcat is installed.

2. Copy the jar files ecb.jar, ecbldap.jar, ecbpr.jar, and novbp.jar listed in the section 5.0 CLASSPATH Variable to tomcat_home\webapps\bns_prcmd_sample\WEB-INF\lib directory.

3. Create a configuration file similar to beans-apache.conf provided under tomcat_home\conf directory and replace all occurrences of /ecb by /bns_prcmd_sample.

4. Add an Include statement for your new configuration file at the end of Apache conf file, httpd.conf found in apache_home\conf directory, e.g.Include sys:/tomcat/4/conf/beans-Apache.conf. This step makes Apache aware of this application.

   NOTE:  Apache_home is the directory where Apache is installed.

5. Restart Tomcat and Apache.

6. To run the sample from the Web browser, use the following URL:

   http://server_name/bns_prcmd_sample.

7.0 Legal Notices

Novell, Inc. makes no representations or warranties with respect to the contents or use of this documentation, and specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose. Further, Novell, Inc. reserves the right to revise this publication and to make changes to its content, at any time, without obligation to notify any person or entity of such revisions or changes.

Further, Novell, Inc. makes no representations or warranties with respect to any software, and specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose. Further, Novell, Inc. reserves the right to make changes to any and all parts of Novell software, at any time, without any obligation to notify any person or entity of such changes.

You may not export or re-export this product in violation of any applicable laws or regulations including, without limitation, U.S. export regulations or the laws of the country in which you reside.

Copyright © 2003-2004 Novell, Inc. All rights reserved. No part of this publication may be reproduced, photocopied, stored on a retrieval system, or transmitted without the express written consent of the publisher.

Novell is a registered trademark of Novell, Inc. in the United States and other countries.

All third-party products are the property of their respective owners.