Installation Instructions

1. After downloading the zip file for this bean package, unzip it, using the jar command or any unzip utility. This automatically creates a new directory with the bean package name and extracts files into it.

2. Download and install JCE 1.2.1 framework and cryptographic service provider from http://www.java.sun.com/products/jce. The minimal installation requirements are the following:

   1. copy all the JCE 1.2.1 jar files (jce1_2_1.jar, local_policy.jar, sunjce_provider.jar, and US_export_policy.jar) to the same directory

   2. ensure that you have the security.provider.1=sun.security.provider.Sun record in your Java Security File, which is located in the <java.home>/lib/security/java.security file. Here <java-home> refers to the directory where your JRE has been installed. Add this record if it does not exist. You should also add the following record: security.provider.2=com.sun.crypto.provider.SunJCE. Note, that for Visual Age for Java the java.security file is in the X:\IBMVJava\ide\Program\lib\security\ directory where X:\IBMVJava is the directory, into which you have installed Visual Age for Java.

   See http://www.java.sun.com/products/jce/jce121_install.html for a detailed description of the JCE 1.2.1 installation process. Note that cryptographic service providers should be installed statically!

3. To use these beans in Visual Age for Java:

   1. import cryptobeans.jar in the lib directory into the repository

   2. add jce1_2_1.jar, local_policy.jar, sunjce_provider.jar, and US_export_policy.jar (all of them should be stored in the same directory) to Visual Age workspace CLASSPATH setting.

4. To use these beans in the visual builder tool other than Visual Age for Java:

   1. import cryptobeans.jar in the lib directory into your visual builder tool

   2. add jce1_2_1.jar, local_policy.jar, sunjce_provider.jar, and US_export_policy.jar to your visual builder tool CLASSPATH setting

   Please, refer to the User's Guide for your visual builder tool for instructions on how to import jar files.

5. To use these beans without a visual builder tool, add jce1_2_1.jar, sunjce_provider.jar, and cryptobeans_Runtime.jar in the lib directory to your CLASSPATH setting.

6. To run the demo application provided with this package, follow the instructions in the Readme.html file in the demo directory.

Notes:  

1. This bean package includes separate jar files for design and run-time functions. Import the design-time jar file (cryptobeans.jar) into your visual builder tool, and use the run-time jar file (cryptobeans_Runtime.jar) for optimal run-time performance.
2. You may also use JCE 1.2-compatible framework and providers. Installation instructions for the bean suite remain the same. Follow the installation instructions, supplied with your JCE framework and cryptographic service providers to install them properly.
3. If you want to use both the bean suite and JCE 1.2.1 classes directly in Visual Age for Java, you should create a separate project in the workspace and import jce1_2_1.jar into it. Do not add this project to CLASSPATH for the class that uses the bean suite!