Building Java applications to use with the CCA API
Application programmers who have Release 3.30.05 or later of the IBM 4764 Cryptographic Coprocessor installed can now build Java applications to use with the Common Cryptographic Architecture (CCA) Support Program. Users who have Release 3.30.05 installed can also fix a problem using the CNM utility with Java Platform, Standard Edition (Java SE) Version 1.6.0_13 or later. Later releases of CCA do not have this problem.
The following is for Release 3.30.05 users only.
Release 3.30.05 users who want to fix the CNM utility problem or to enable application programmers who want to build Java applications on the Microsoft Windows, Novell SUSE Linux, and Red Hat Linux operating systems, follow these steps:
1. Release 3.30.05 of the IBM 4764 Cryptographic Coprocessor is required.
2. Download the Java-for-IBM-4764-3.30.06.zip (547KB) file and extract the files. These files will be copied to their distribution locations in the following steps.
3. Make a backup copy of your CCA Support Program installation.
4. The extracted HIKM.zip file replaces the existing HIKM.zip file. Copy the extracted HIKM.zip file to its distribution location. The default distribution location of this file is shown in the following table:
| Operating system | Default distribution location |
|---|---|
| Linux | /opt/IBM/4764/cnm |
| Windows | \Program Files\IBM\4764\cnm |
5. Copy these three new files to their distribution location:
- hikmNativeInteger.html
- Java-for-IBM-4764-HOWTO.txt
- mac.java
The default distribution location of these files is shown in the following table:
| Operating system | Default distribution location |
|---|---|
| Linux | /opt/IBM/4764/samples |
| Windows | \Program Files\IBM\4764\samples |
6. Linux users only:
- a. The libHIKM.so.1.3.0 file replaces the existing libHIKM.so.1.2.0 library. Copy the new libHIKM.so.1.3.0 file to its distribution location. The default distribution location is:
/usr/lib - b. Remove the symbolic link of libHIKM.so.1 to libHIKM.so.1.2.0, and create a new symbolic link of libHIKM.so.1 to libHIKM.so.1.3.0. Use the following commands in the order shown:
rm /usr/lib/libHIKM.so.1
ln –s /usr/lib/libHIKM.so.1.3.0 /usr/lib/libHIKM.so.1 - c. Set the permissions of the copied files as shown in the following table:
| File | Permissions |
|---|---|
| /opt/IBM/4764/cnm/HIKM.zip | 440 |
| /opt/IBM/4764/samples/hikmNativeInteger.html | 666 |
| /opt/IBM/4764/samples/Java-for-IBM-4764-HOWTO.txt | 666 |
| /opt/IBM/4764/samples/mac.java | 666 |
| /usr/libHIKM.so.1.3.0 | 755 |
7. Windows users only:
The extracted hikm.dll file replaces the existing hikm.dll library. Copy the hikm.dll file to its distribution location. The default distribution location of this file is:
\Program Files\IBM\4764
Note: The libHIKM.so.1.3.0 file is for Linux users only.
8. Programmers should follow the instructions provided in the Java-for-IBM-4764-HOWTO.txt file to build Java applications to use with the CCA Support Program.