README File for Intel Common Security Services Manager Java* Adapter December 1996 Export Controlled Contents 1. Introduction 2. System Recommendations 2.1. Hardware Recommendations 2.2. Software Recommendations 3. Installation 3.1. Intel Common Security Services Manager Java* Adapter 3.2. Demo Applet 3.3. Demo Applet Source Code 4. Uninstallation 5. Additional Information 5.1. Installing ODBC* Drivers 5.2. Installing Intel Common Security Services Manager with Intel Add-ins 5.3. Installing Intel Cryptographic Services Module 6. Known Bugs 7. Troubleshooting 8. Software License Agreement 1. Introduction NOTICE: THIS SOFTWARE CONTAINS INTEL INTELLECTUAL PROPERTY AND MAY BE SUBJECT TO US EXPORT CONTROL LAWS. BE SURE TO REVIEW SECTION 8 OF THESE NOTES CAREFULLY FOR LICENSING AND OTHER INFORMATION PRIOR TO INSTALLATION. This document contains the release notes for the Intel Common Security Services Manager Java* Adapter (CSSM-J), Release 1.0, for use with the Intel Common Security Services Manager(CSSM) with Intel Add-ins, Release 1.0, and the Intel Cryptographic Service Module (CSM), Release 1.0. This release includes the CSSM-J library and class files, as well as a demonstration applet, with all of the source code files used to generate it. 2. System Recommendations 2.1. Hardware Recommendations 200 K free disk space Intel Pentium™ processor 2.2. Software Recommendations Windows NT 4.0 operating system ODBC driver pack (version 3.40.27.28 or better) Netscape Navigator* 3.01 browser Intel CSSM with Intel Add-ins, Release 1.0 Intel CSM, Release 1.0 3. Installation The installation program installs one library file, 13 Java* class files, and two supporting documentation files. In addition, a sample applet with source code is installed. During the installation process, the installer is prompted for a destination directory. This directory will be referred to as . 3.1. Intel Common Security Services Manager Java Adapter The Intel Common Security Services Manager Java Adapter installation is comprised of one library, 13 class files, and one supporting document. The library file is installed to the Java\bin subdirectory of the directory where the installer's Netscape Navigator executable file is located. The following files are installed to Netscape\Program\Java\bin: cssmjava.dll Java adapter library for Netscape Navigator 3.01 The class files are installed to \Java\classes\Intel\CSSM. The following files are installed to \Java\classes\Intel\CSSM: Certificate.class CLRegistry.class Constant.class CRL.class Crypto.class CSPRegistry.class CSSMException.class DataStore.class DLRegistry.class Key.class SecurityContext.class TPRegistry.class TrustPolicy.class To ensure proper operation of the CSSM-J, the \Java\classes directory will be added to the CLASSPATH environment variable. If this directory already exists in the CLASSPATH variable, the CLASSPATH variable will remain unchanged. Note: Uninstallation of CSSM-J and the demo applet will not undue any changes made to the CLASSPATH variable. The installation notes document for this release is installed to . The following file is installed to : readmejv.wri This document 3.2. Demo Applet The demo applet files are installed to \Java\Samples. The following files are installed to \Java\Samples: DataStoreTest.class HarnessConsole.class Log.class TestHarness.class demoapp.html To ensure that the applet will be able to launch from the \Java\Samples directory, the CLASSPATH environment variable is changed to include the current working directory. If the current working directory is already in the CLASSPATH variable, the CLASSPATH variable will not be changed. Note: Uninstallation of CSSM-J and the demo applet will not undue any changes made to the CLASSPATH variable. In addition, a README file which documents the building and running of the demo appletis installed to \Java\Samples. 3.3. Demo Applet Source Code The source code files are installed to \Java\Samples\src. The following files are installed to \Java\Samples\src: DataStoreTest.java HarnessConsole.java Log.java TestHarness.java demoappl.mak demoapp.html 4. Uninstallation This installation can be removed by clicking the Uninstall CSSM Java Adapter 1.0 icon, found in the Intel CDSA 1.0 program group from the Start button. 5. Additional Information 5.1. Installing ODBC Drivers This release requires the ODBC driver for MS Access* 7.0 (odbcjt.dll), version 3.40.27.28 or greater. If a message was issued during installation concerning the ODBC drivers, a compatible version of this ODBC driver will need to be installed. These drivers can be downloaded from: http://developer.intel.com/ial/security/download 5.2. Installing Intel CSSM with Intel Add-ins, Release 1.0 This release requires the Intel Common Security Services Manager with Intel Add-ins, Release 1.0, in order to install and operate properly. Intel CSSM with Intel Add-ins 1.0 can be downloaded from: http://developer.intel.com/ial/security/download 5.3. Installing Intel CSM, Release 1.0 This release requires the Intel Cryptographic Services Module, Release 1.0, in order to operate properly. Intel CSM 1.0 can be downloaded from: http://developer.intel.com/ial/security/download 6. Known Bugs The Intel CSSM Java Adapter has no known bugs. For a listing of known bugs in the Intel CSSM and Intel Add-ins, please refer to the release notes included with the Intel CSSM with Intel Add-ins Release 1.0 installation. To get technical support and/or report bugs, call 1-800-628-8686, or send email to IAL_Support@intel.com. 7. Troubleshooting To get technical support and/or report bugs, call 1-800-628-8686, or send email to IAL_Support@intel.com. The sample applet comes up blank. Check that the CLASSPATH environment variable includes both the \classes directory and the current working directory. The sample applet says it failed to load IntelDL. Check that MFC 4.2 (mfc42.dll) is installed (should be in window's system directory). This library is required for use of the Intel Data Storage Module (DSM). If installing MFC 4.2 does not fix the problem, reinstall the Intel CSSM with Intel Add-ins, Release 1.0. The sample applet says it failed to load IntelCL. CSSM registry information has been corrupted or the files are not properly installed. Reinstall the Intel CSSM with Intel Add-ins, Release 1.0. 8. Software License Agreement NOTE: This is "beta" software which is in preliminary release form and may not be fully functional. This software will expire on April 30, 1997, and will thereafter become inoperable. LICENSE: Intel grants you a non-exclusive, non-transferable, royalty-free, copyright license subject to the terms of this Agreement. You may copy the software and materials associated with this agreement ("Materials") onto a single computer for your personal noncommercial use. You may not make other copies or sell or transfer any part of the Materials to any other party. You will not reverse engineer, decompile, modify, or disassemble the Materials. Your license expires upon the software expiration date of April 30, 1997. OWNERSHIP AND COPYRIGHT OF MATERIALS: Title to the Materials and all copies thereof remains with Intel or its suppliers. The Materials are copyrighted and are protected by United States laws and international treaty provisions. You will not remove the copyright notice from the Materials. You agree to prevent any unauthorized copying of the Materials. Except as expressly provided herein, Intel does not grant any express or implied right to you under Intel patents, copyrights, trademarks, or trade secret information. LIMITATION OF LIABILITY: THE MATERIALS ARE PROVIDED "AS IS" WITHOUT ANY EXPRESS OR IMPLIED WARRANTY OF ANY KIND INCLUDING WARRANTIES OF MERCHANTABILITY, NONINFRINGEMENT OF THIRD-PARTY INTELLECTUAL PROPERTY, OR FITNESS FOR ANY PARTICULAR PURPOSE. IN NO EVENT SHALL INTEL OR ITS SUPPLIERS BE LIABLE FOR ANY DAMAGES WHATSOEVER (INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF PROFITS, BUSINESS INTERRUPTION, LOSS OF INFORMATION) ARISING OUT OF THE USE OF OR INABILITY TO USE THE MATERIALS, EVEN IF INTEL HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. BECAUSE SOME JURISDICTIONS PROHIBIT THE EXCLUSION OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES, THE ABOVE LIMITATION MAY NOT APPLY TO YOU. U.S. GOVERNMENT RESTRICTED RIGHTS: The Materials and documentation are provided with "RESTRICTED RIGHTS." Use, duplication, or disclosure by the Government is subject to restrictions as set forth in FAR52.227-14 and DFAR252.227-7013 et seq. or its successor. Use of the Materials by the Government constitutes acknowledgment of Intel's proprietary rights in them. TERMINATION OF THIS LICENSE: Intel may terminate this license at any time if you are in breach of the terms of this Agreement. Upon termination, you will immediately destroy the Materials. ENTIRE AGREEMENT: This Agreement constitutes the entire agreement between the parties and supersedes any prior or contemporaneous oral or written agreements. APPLICABLE LAWS: Any claim arising under or relating to this Agreement shall be governed by the laws of the State of Delaware, without regard to conflict of laws principles. You may not export the Materials in violation of applicable export laws and regulations. Copyright © 1996, 1997 Intel Corporation. All rights reserved. *Other product and corporate names may be trademarks of other companies and are used only for explanation and to the owner's benefit, without intent to infringe.