JNDI Unpacking Instructions

Print-friendly Version

JNDI UNPACKING INSTRUCTIONS

Unpacking

--> After downloading a ZIP file, you need to unpack its contents by following these steps:

1. Find a location (file directory) to place the contents of the ZIP file.

2. Unzip the ZIP file.
   If you are on a UNIX system, you can use the UNIX version of unzip.

   % unzip jndi1_2-bin.zip
   

   If you are on a PC system, you can use the unzipping tool of your choice. Unzipping tools for PC systems include WinZip, InfoZip and pcunzip.

   If you don't have access to an unzipping utility, you can use the jar command, included in the "bin" directory of the Java 2 SDK or JDK, as long as it is reachable from your executable path.

   % jar xvf jndi1_2-bin.zip 
   

   Some versions of jar have a bug that results in an java.io.IOException. To workaround the problem, run the jar command twice.

   Some files, such as "COPYRIGHT" and "lib/providerutil.jar", occur in more than one ZIP file. These files are interchangeable; it doesn't matter from which ZIP file you get a copy.

3. Examine the contents.
   Unpacking the ZIP file creates a "readme" file, and "doc" and "lib" directories. The "readme" file has a prefix of "README" and can be viewed by using any text editor or viewer. The file describes the contents of the ZIP file and provides pointers to documentation about the release. There is typically a file with the suffix "-ext.html" located in the "doc" or "doc/providers" directory. This file contains details about the release and can be viewed by using any HTML viewer, such as a Web browser.

4. Follow the instructions.
   The release's documentation has instructions for installing the binaries. A good resource for information on installing and using extensions on the Java 2 platform is the Java Tutorial.