2.1. Setting Up the Java Embedded Server Software

We assume you already have the Java runtime environment and development tools installed on your computer. If not, you should install them before proceeding. If you need permission-based security,^[1] you must use Java™ 2 SDK versions 1.2 or 1.3. Otherwise, JDK™ version 1.x or its compatibles should work fine.

^[1] At the time of this writing, the Java Embedded Server software version for download does not support permissions. A version that does will be made available. We discuss permissions in Chapter 9.

Install the Java Embedded Server product on your computer. For the rest of this book, we refer to the location of installation as jes_path. You should end up with the following directory hierarchy for the distribution:

					jes_path
  |---- bin
  |---- docs
  |---- lib
  |---- bundles

The OSGi framework interfaces and classes, and their implementation, are included in jes_path/lib/framework.jar. You need it to build your own bundles as well as to run the Java Embedded Server software.

The bundles directory contains the bundles shipped with the product, including the Log and HTTP bundles. The docs directory has the documentation set. Don't worry about other directories for now.