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
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
NOTE: The Java Server can be installed in any directory in your system.
% uncompress tarfile
The tar file is now ready to be installed.
% tar xvf tarfile
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
.exe
file from
the Java Server
web site. Instructions for doing this are available at the site.
.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.
.exe
file to extract the Java Server
files into it.
Setup.exe
.
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.
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
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
.
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
.
The Beta release supports two ways to start the Java Server:
% cd server_root/bin
% ./httpd
For example, to run the server as a background process (listening on the default port 8080), enter:
% cd JavaServerBeta/bin
% ./httpd &
C> cd server_root\bin
C> .\httpd
For example, to run the server (listening on the default port 8080), from the MS-DOS shell, enter:
C>
cd "Program Files\JavaServerBeta\bin"C> .\httpd
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.
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:
server.user=daemon
server.group=daemon
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:
chown -R userid server_root
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:
Removing Java Server from a Windows NT 3.5.1 Machine
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:
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:
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:
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: