Installation and Startup (Beta)


Documentation / Before Installing Java Server / Installing on Unix / Installing on Windows / Configuring Java / Starting Java Server / Removing Java Server / Displaying Default Home Page / Using Server Administration / Using SSL / Using Documentation

Before Installing Java Server

To properly run the Java Server, you must first install the Java Development Kit (JDK) 1.1. If you have not yet installed JDK 1.1, see The Java Development Kit home page for more information.

For more information about the Beta release of Java Server, see Release Notes and Frequently Asked Questions.

Installing on Unix

  1. Download the Java Server Beta compressed tar file from the Java Server web site. Instructions for doing this are available at the site.

  2. Move the compressed tar file to the directory where you want to install the Java Server software.

    NOTE: The Java Server can be installed in any directory in your system.

  3. Uncompress the tar file and remove the .Z extension. Enter:

    The tar file is now ready to be installed.

  4. Install the contents of the tar file. Enter:

    This creates a directory called JavaServerBeta, which contains the Beta release. The JavaServerBeta directory is also called the server_root. This term is used to throughout the Java Server documentation.

    NOTE: If you have previously installed a version of Java Server (for example, Alpha3), the Beta version does not overwrite it. If you have previously changed or customized this early version and want those changes to carry over to Beta, you must reapply them manually. They will not be picked up when you install the Beta version.

After you have finished installing the Java Server you can delete the tarfile, if you wish.

Installing on Windows95 and Windows NT

  1. Download the Java Server Beta self-extracting .exe file from the Java Server web site. Instructions for doing this are available at the site.

  2. Move the self-extracting .exe file to the directory where you want to install the Java Server software.

    NOTE: The Java Server can be installed in any directory in your system.

  3. Double-click on the .exe file to extract the Java Server files into it.

  4. Double-click on Setup.exe.

  5. Follow the instructions in the Setup program to install Java Server in a directory location on your hard disk. By default, Setup installs Java Server in C:\Program Files\JavaServerBeta. The JavaServerBeta directory is also called the server_root. This term is referred to throughout the Java Server documentation.

    NOTE: If you have previously installed a version of Java Server (for example, Alpha3), the Beta version does not overwrite it. If you have previously changed or customized this early version and want those changes to carry over to Beta, you must reapply them manually. They will not be picked up when you install the Beta version.

After you have finished installing the Java Server you can delete the temporary directory, if you wish.

Configuring Java

On Unix systems

  1. Set JAVA_HOME in your environment, pointing to an installed JDK 1.1 release. Make sure java/bin is in your path. For example:
    	% setenv JAVA_HOME /usr/local/java

On Windows 95 and Windows NT platforms

  1. Set the JAVA_HOME environment variable if you want to change the default location where Java is installed. Otherwise, the Java Server installation assumes that Java is installed in C:\>java.

  2. Set the JAVA_EXE environment variable to change the default location of the Java runtime executable. Otherwise, the Java Server installation assumes that the Java runtime executable is JAVA_HOME\bin\java.exe.

Starting the Java Server

The Beta release supports two ways to start the Java Server:

Starting Manually on Unix

  1. Enter:

    For example, to run the server as a background process (listening on the default port 8080), enter:

  2. Connect to the server by displaying the default home page.

Starting Manually on Windows 95 and Windows NT

  1. Enter:

    For example, to run the server (listening on the default port 8080), from the MS-DOS shell, enter:

    Note: The source file for httpd.exe is called httpd.c, and is located in the bin directory. If you want, you can edit httpd.c and then recompile it.

  2. Connect to the server by displaying the default home page.

Starting Automatically on Solaris

On Solaris systems, you can set up Java Server to start whenever your machine boots.

The server_root/etc/java-server.startup shell script is a standard /etc/init.d style script. Read it for installation directions. This requires setting two environment variables (pointing to the Java runtime environment and the server_root/etc/java-server.startup directory).

If you wish to use Java Server as the default server for your machine, you will need to change the port number served to port 80. This may be done via the normal Admin interface. You will probably also want to modify the server configuration file server_root/admin/properties/process/javawebserver/process.properties so that it has lines such as:

These two lines specify the user and group ID under which the server should operate; choose these identities carefully. You may prefer to set up a user account specifically to host this web server. Once you have chosen the user, be sure that the server's files are owned by the user you selected. One way to do this is to (as root) issue the command:

where userid is the user you are running as, and server_root is the directory that you installed the server in.

After you have logged in to your machine and started the Java Server automatically, you connect to the server by displaying the default home page.

Note: Due to the streamlined single-process nature of the Java Server, a large number of file descriptors can be in use at any one time. On some systems under high load, the default value your system supplies may not be enough. If your system begins to run out of file descriptors, you may see failed class loads messages, refused sockets, and other errors related to not being able to open files. To increase the number of file descriptors available to your process, please consult the system management guide for your platform.

Removing the Java Server

Removing Java Server From a Solaris Machine

The Beta Java Server does not have a de-install script to remove the Java Server files from your machine. To remove the Java Server files manually and de-install the Java Server, type:

  1. % cd server_root

  2. % rm -r *

Removing Java Server from a Windows NT 3.5.1 Machine

  1. Double-click the uninstall icon from the Java Server program folder.

Note: For Windows NT 4.0 and Windows95 - For Beta, you must remove the Java Server by hand.

Displaying the Default Home Page

After you have started the server, you can display the default Java Server home page by entering the following URL:

http://Server_Host_Name:8080/

where Server_Host_Name is the name of your machine. (For example, if your machine is named galaxy, http://galaxy:8080).

On Windows 95 and Windows NT platforms, the Server_Host_Name is the name assigned to your computer, as specified in the Network control panel. To find this name:

  1. Open the Network control panel

  2. Click on Identification. Use the name supplied in the "Computer name" field for the Server_Host_Name.

To set up your own web site, use your normal web authoring tools to change the default home page. Then tell your clients about your site!

Using Java Server Administration

To use the Java Server Administration feature:

  1. From the default home page, click on Start the Administration Applet.

  2. Login using the default user name admin and the default password admin

Once you have logged in, you'll want to change the password for the default "admin" account. For more information on using the Java Server Administration, see the Administration Contents page.

NOTE: Most server properties can be changed without needing to restart the server. However, if you change the default port, you must restart the server. To change the default port number, use the Basic Configuration page.

Setting up Java Server to Use SSL

The Secure Socket Layers (SSL) protocol is only implemented on Solaris, Windows95, and Windows NT platforms. For other platforms, please download the Solaris global version of the software, which does not have SSL.

For information on setting up Java Server to use SSL, see the Release Notes.

Using the Documentation

Documentation for the Beta Java Server (in HTML format) is installed in the system/doc directory. The API documentation is installed in doc/documentation/apidoc/packages.html.

To display the documentation, enter the following URL:

You can also display the documentation by:

  • Clicking "Help" from any of the Server Administrator screens.

  • Visiting the Java Server web site at http://www.javasoft.com. Any future updates to the documentation, especially the FAQ and bug information, will be posted to the Java Server web site.
    Top
    java-server-feedback@java.sun.com