See the Release Notes for information about the software environment you need to run Jeeves. For example, you may need to get a more recent version of the Java Developer's Kit or a web browser that supports Java.
You may now delete the zip file, if you wish.
You may now delete the temporary directory, if you wish.
To install Jeeves:
JAVA_HOME
in your environment, pointing to an
installed JDK
1.0.2 release. Make sure java/bin
is in your path. For example:
% setenv JAVA_HOME /usr/local/java
Set the CLASSPATH variable to reference the JDK 1.0.2 class library. For
example:
% setenv CLASSPATH .:/usr/local/java/lib/classes.zip
On Windows 95 and Windows NT platforms, set the JAVA_HOME environment variable if you want to change the default location where Java is installed. Otherwise, the Jeeves installation assumes that Java is installed in C:\Java. Set the JAVA_EXE environment variable to change the default location of the Java runtime executable. Otherwise, the Jeeves installation assumes that the Java runtime executable is JAVA_HOME\bin\java.exe.
This alpha release supports two ways to start the Jeeves server: manually, and (on Solaris and Windows NT) automatically.
On Unix systems, run server root/bin/httpd. For example, to run the server as a background process listening on the default port 8080:
% cd JeevesA2
% bin/httpd &
On Windows 95 and Windows NT platforms, run server root\bin\httpd.exe. For example, to run the server as a background process listening on the default port 8080, from the MS-DOS shell, type:
C> cd JeevesA2\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 recompile it.
On Macintosh platforms:
-Dserver.root=/XXX/JeevesA2 -working /XXX/JeevesA2
-classpath "lib/classes.zip;servlets"
sun.server.http.HttpServer
Notes for using CodeWarrior javai:
-D
option needs to be specified as the first option.
-working
specifies the working directory of the application.
-classpath
option uses semicolon as path separator in place
of documented colon.
On Solaris systems, you can set up Jeeves to start whenever your machine boots.
The server root/etc/jeeves.server 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/jeeves.server directory).
You will probably want to modify the server configuration file server root/admin/httpd.properties so that it has lines such as:
server.port=80
server.user=daemon
server.group=daemon
The first of those lines says that this server should be the system's
default web server. The next two 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.
On Windows 95 and Windows NT platforms, the ServerHostName is the
name assigned to your computer, as specified in the Network control panel. Open
the Network control panel, and click Identification. Use the name supplied in
the "Computer name" field for the ServerHostName.
On Macintosh platforms, the ServerHostName is the name of the
Macintosh host that's running the server.
The default port number can be changed using the Basic Configuration page. You
must restart the server if you change the port number. Other server properties
can be changed dynamically, without requiring server restart.
Use your normal web authoring tools to change the default
home page and set up your web site as you wish. Then tell
your clients about your site!
For information on setting up Jeeves to use SSL, see the Release Notes.
The documentation can be accessed remotely at:
http://ServerHostName:8080/doc/
Documentation is also available at the Jeeves
web site. Any future
updates to the documentation, especially the FAQ and bug information, will be
posted to the Jeeves web site.
Installing Jeeves as a Windows NT System Service
To set up Jeeves to start as a Windows NT system service:
C> cd JeevesA2\bin
C> ntservice -install
ntservice=true
Removing Jeeves as a System Service
To remove Jeeves as a system service:
C> cd JeevesA2\bin
C> ntservice -remove
or edit this line to be
ntservice=true
ntservice=false
.
Accessing and Setting Up Your New Web Site
After you have started the server, you may
access the default home page for your new website
by entering the following URL in your browser:Accessing the Server
From the default home page, click Server Administration, and log in using the
default user name "admin" and the default password "admin". You can then go to
the Users page to change the password for the default "admin" account.
Setting up Jeeves to Use SSL
Note: SSL is only implemented on Solaris, Windows 95, and WindowsNT
platforms. For other platforms, please download the Solaris global version
of the software.
Locating the Documentation
HTML documentation is in the doc/ directory. The API documentation is in
doc/documentation/apidoc/packages.html.
jeeves@java.sun.com
Last modified: 11/11/96