To Create a Credentials File Using the RCF Utility

1. The file to be used for the RCF utility are located at the following locations:

   netbeans_home\usrdir\modules\ext\ldapadapter\stcldap13.jar

   or

   <netbeans_home>\usrdir\modules\ext\ldapadapter\ stcldap14.jar

2. Copy and paste one of the above files to a folder and run the utility from this folder as follows:

   netbeans_home\jdk\bin\java -cp ./stcldap13.jar com.stc.connector.ldapadapter.utils.RCFUtil

   The following menu displays:

   C:\temp>java -cp ./stcldap13.jar com.stc.connector.ldapadapter.utils.RCFUtil

   Please specify the operation.

   ---+ RCFUtil +---

   Interactive command line utility for creating and managing file(s) containing credentials information to follow LDAP referrals. File(s) generated can be used by the Java LDAP Adapter for following referrals that required credentials different from those used to create the connection to the initial LDAP server.

   Usage : java com.stc.connector.ldapadapter.utils.RCFUtilOPTIONS -- <filename>

   OPTIONS:

   --create Create a new referral credentials file. --add Add an entry to the referral credentials file. --list Print a list of entries in the referral credentials file. --remove Remove an entry from the referral credentials file. --modify Modify an entry in the referral credentials file. --decrypt When displaying credentials, decrypt the credentials. --username <username> Specify the username; if not specified, it’ll be prompted. --password <password> Specify the password; if not specified, it’ll be prompted. --help Print this usage.

   filename:

   The full path to the referral credentials file.

3. To create a new referral file called samplercf.txt, enter the following parameters on the command line:

   netbeans_home\jdk\bin\java -cp ./stcldap13.jar com.stc.connector.ldapadapter.utils.RCFUtil --create -- samplercf.txt

   This action requests a user name and password. Enter the user name and password. This user name and password is for protecting the file itself, because the file contains sensitive credential information about other LDAP servers. For example:

   C:\temp>c:\JavaCAPS6\netbeans\jdk\bin\java -cp .\stcldap13.jar com.stc.connector.ldapadapter.utils.RCFUtil --create -- samplercf.txt Creating file samplercf.txt... Enter username >> test Enter password >> test File created!

   A message "File created!" appears. The file name here is samplercf.txt. The extension does not matter.