jGuru: Help: Installing and Configuring Sun's J2EE Reference Implementation

Installing and Configuring Sun's J2EE Reference Implementation

by

[Exercise | API Docs | Short Course| Exercises]

Help is available for each task.

Task 1

Check your system requirements to make sure you have an adequate hardware and software platform for installing and running J2EE RI.

System requirements are Windows NT 4.0 or Solaris 2.5.1+. Windows 2000 and Windows98 also are reported to work, but Sun does not yet officially support them. A minimum of 128kB of RAM is needed to adequately complete the exercises.

Visit Sun's web page which lists J2EE Reference Implementation Tested Configurations for more information.

Task 2

Ensure you have the Java 2 SDK version 1.2.2 or higher installed on your machine.

The J2EE RI cannot run without the full Java 2 SDK installed. The J2EE RI cannot run if the HotSpot performance engine has been installed on top of the SDK; if HotSpot has been installed, be sure to uninstall then reinstall the Java 2 SDK.

Task 3

Download the J2EE RI server and documentation from Sun's J2EE download site. The software distribution and the documentation site include installation instructions.

The Windows and Solaris distributions are each approximately 11Mb. The documentation is an additional 7Mb.

Task 4

Run the installer for both the J2EE and the documentation.

Double click on the installer that you downloaded in the previous step.

Task 5

Set the J2EE_HOME environment variable to point to the base directory where you installed the J2EE RI.

In Windows, this may be done by the command:
set J2EE_HOME=C:\j2sdkee
Make sure to point to the proper folder for your machine.

Task 6

Put J2EE_HOME/bin into your PATH environment variable.

In Windows, this may be done by the command:
set PATH=%PATH%;C:\j2sdkee\bin
Make sure to point to the proper folder for your machine.

Task 7

Start the Cloudscape database via the command-line command cloudscape -start.

cloudscape -start should produce output similar to the following:

myhost> cloudscape -start
Wed Jan 12 11:51:20 PST 2000:
     [RmiJdbc] COM.cloudscape.core.JDBCDriver 
        registered in DriverManager
Wed Jan 12 11:51:20 PST 2000:
     [RmiJdbc] Binding RmiJdbcServer...
Wed Jan 12 11:51:20 PST 2000:
     [RmiJdbc] No installation of RMI Security Manager...
Wed Jan 12 11:51:22 PST 2000:
     [RmiJdbc] RmiJdbcServer bound in rmi registry

Task 8

Start the J2EE RI via the command-line command j2ee -verbose.

Running the J2EE RI via the command-line command j2ee -verbose should produce output similar to the following:

myhost> j2ee -verbose

Naming service started: :1050
Published the configuration object ...
Binding DataSource, name = jdbc/Cloudscape,
    url = jdbc:cloudscape:rmi:CloudscapeDB;create=true
Configuring web service using "default"
Web service started: :9191
Web service started: :7000
Configuring web service using "default"
Configuring web service using 
  "file:/D:/j2sdkee1.2/public_html/WEB-INF/web.xml"
Web service started: :8000
Endpoint [SSL: 
  ServerSocket[addr=0.0.0.0/0.0.0.0,port=0,localport=7000]]
    shutdown due to exception:
    javax.net.ssl.SSLException: No available certificate corresponds
        to the SSL cipher suites which are enabled.
endpoint down: :7000
J2EE server startup complete.

Task 9

J2EE is now installed and running. Explore the J2EE Reference Implementation documentation within the documentation site to familiarize yourself more with J2EE.

There is extensive documentation on all aspects of J2EE, along with example enterprise beans API documentation for the javax.ejb packages, and other goodies.