Documentation / Administrator Docs / Developer Docs / Index
This document has the following sections:
The Java Web Server 1.0 product ships with the JRE (Java Runtime Environment) 1.1.2. You do not have to install the JDK (Java Development Kit) on your computer.
NOTE: The JavaServer 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 JavaServer1.0
, which contains the
product release. The JavaServer1.0
directory is also called the
server_root. This term is used to throughout the JavaServer
documentation.
After you have finished installing the JavaServer you can delete the tarfile,
if you wish.
Installing on Windows95 and Windows NT
.exe
file from
the JavaServer
web site. Instructions for doing this are available at the site.
.exe
file to the directory
where you want to install the JavaServer software.NOTE: The JavaServer can be installed in any directory in your system.
.exe
file to extract the JavaServer
files into it.
C:\JavaServer1.0
. The JavaServer1.0
directory is also called the server_root. This term is referred to
throughout the JavaServer documentation.
There are two ways to start the JavaServer:
% cd server_root/bin
% ./httpd
For example, to run the server as a background process (listening on the default port 8080), enter:
% cd JavaServer1.0/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 JavaServer1.0\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 JavaServer 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).
Starting Automatically on Windows NT
The Windows NT service application $HTTP_HOME/bin/httpsvc
is
generally installed during the JavaServer installation
using the InstallShield facility. Once it is installed, you can start it
automatically by rebooting your machine. Rebooting sets up your system so
that each subsequent reboot automatically starts the JavaServer.
If you do not initially set up the JavaServer as a system service using InstallShield, but later want to make it an automatic system service, follow these steps:
C> httpdsvc JavaWebServer install
Starting the JavaServer On Port 80
To use JavaServer as the default World Wide Web server for your machine,
you will need to change the port number to port 80. Please follow these steps for that.
server.properties
.
# POSIX ONLY: # If server.user is specified, the server will change UID after service startup server.user=nobody # POSIX ONLY: # If server.group is specified, the server will change GID after startup. server.group=nobody
nobody
to the user and group names you have decided upon, if any.
chown
command:
# chown -R userid server_root
chgrp
command:
# chgrp -R userid server_root
After you have started the JavaServer, you can connect to the server by
displaying the default home page.
Stopping the JavaServer
Stopping the JavaServer On a Unix Machine
To stop the JavaServer you must first locate the process number that it is
running under, and then kill the process. The JavaServer actually runs
as two processes:
/home/erik/Jeeves/Working_FCS/build/unix/bin/sparc/green_threads/java -Dserver.
To stop the JavaServer, follow these steps:
ps -eaf
kill process_number process_number
This stops the JavaServer from running on your machine. To start the JavaServer again, see Starting the JavaServer.
Stopping the JavaServer on a Windows95 Machine
To stop the JavaServer running on a Windows95 machine:
To restart the JavaServer service, follow the directions above and click on
Start.
Removing the JavaServer
Removing JavaServer From a Solaris Machine
The JavaServer does not have a de-install script to remove the JavaServer
files from your machine. To remove the JavaServer files manually
and de-install the JavaServer, type:
Removing JavaServer from a Windows Machine
C>
cd JavaServer1.0\binC> httpdsvc JavaWebServer remove
Displaying the Default Home Page
After you have started the server, you can display the default JavaServer home
page by entering the following URL:
where Server_Host_Name is the name of your machine and port is 8080 by default. (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 JavaServer Administration
To use the JavaServer Administration feature:
Administer the Web Server
.
Note: You can also connect to the Administration Tool by typing its URL.
For example, if the host name for your JavaServer is bagua
, then
you enter the URL http://bagua:9090/index.html
.
Once you have logged in, you'll want to change the password for the default "admin" account. For more information on using the JavaServer 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 Setup page.
Changing Your Admin Password and Default Port
Once you have installed the JavaServer on your system and logged in to
the Administration Tool, it is recommended that you take the following two
steps to provide additional security for your JavaServer:
server_root/realms/data/adminRealm/keyfile
admin
line there so that it reads:
admin::YWRtaW4=
The Secure Socket Layers (SSL) protocol is only implemented on the US Domestic releases of the JavaServer for the Solaris/SPARC, Windows95, and Windows NT platforms.
For other platforms, and for other countries, please download the Solaris global version of the software, which does not have SSL.
For information on setting up JavaServer to use SSL, see
Using SSL with JavaServer.
Using the Documentation
Documentation for the JavaServer (in HTML format) is installed in the
system/doc
directory. The API documentation is installed in
/system/doc/apidoc/packages.html
.
To display the documentation, enter the following URL:
You can also display the documentation by:
Any future updates to the documentation, especially the FAQ and bug information, will be posted to the JavaServer web site.