Jeeves Alpha 2 Installation and Startup


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.

Unix Installation

  1. Download the Jeeves Alpha2 zip file from the Jeeves web site. Instructions for downloading the unix version of the zip file are available at the web site.
  2. Be sure you have an unzip utility that works on your platform and supports long filenames. (There's one available free of charge at http://quest.jpl.nasa.gov/Info-Zip/Info-Zip.html). Check to make sure unzip is in your path.
  3. Move the Jeeves Alpha2 zip file to the directory where you want to install the Jeeves software.
  4. Enter:
    unzip zip file name
    This will create a directory called "JeevesA2", which will contain the Alpha2 release. The JeevesA2 directory is the server root directory, which is referred to in the documentation and the rest of this document. Note that this directory is different than directories created by earlier Jeeves releases. You must apply any changes you had made in previous Jeeves releases to this one, either by using the administration tool, or by using a diff utility on the files in the admin directory, and making the same changes in the new server directory.

You may now delete the zip file, if you wish.

Windows 95 and Windows NT Installation

  1. Download the Jeeves Alpha2 zip file from the Jeeves web site. Instructions for downloading the zip file are available at the web site.
  2. Double-click the self-extracting zip file to create the JeevesTemp directory and place all files into it.
  3. Double-click Setup.exe.
  4. Follow the instructions in the Setup program to install Jeeves in a directory location on your hard disk.
    By default, Setup installs Jeeves in C:\Program Files\JeevesA2. The JeevesA2 directory is the server root directory, which is referred to in the documentation and the rest of this document. Note that this directory is different than directories created by earlier Jeeves releases. You must apply any changes you had made in previous Jeeves releases to this one, either by using the administration tool, or by using a diff utility on the files in the admin directory, and making the same changes in the new server directory.
  5. (Windows NT only) To install Jeeves as a Windows NT system service, see Installing Jeeves as a Windows NT System Service.

You may now delete the temporary directory, if you wish.

Macintosh Installation

You must have the following software already installed:

To install Jeeves:

  1. Download the Solaris global version of the Jeeves Alpha2 zip file from the Jeeves web site. Instructions for downloading the zip file are available at the web site.
  2. Double-click the zip file to create a JeevesA2 folder that contains the Alpha2 release files.
  3. Delete the zip file, if you wish.
  4. In the JeevesA2 folder you created, find and open the lib folder.
  5. Within the lib folder, double-click on plus.zip to unzip it. If prompted for a program to use to view plus.zip, select StuffIt Expander. This creates a folder named "plus Folder".
  6. Open the folder "plus Folder". There will be two more folders inside it, named java and sun. Copy these two folders to the folder "System Folder/Java/Classes", so that they now reside there. This step is necessary for Metrowerks Codewarrior to recognize these classes.

Configuring Java

On Unix systems, set 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.

Starting the Jeeves Server

This alpha release supports two ways to start the Jeeves server: manually, and (on Solaris and Windows NT) automatically.

Manual Startup

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:

  1. Run "Metrowerks Java" (available in the Helper Apps folder in the CodeWarrior Gold 10 release).
  2. Run new javai (shortcut is Command-N).
  3. At the prompt, enter:
    -Dserver.root=/XXX/JeevesA2 -working /XXX/JeevesA2
    -classpath "lib/classes.zip;servlets" sun.server.http.HttpServer

Notes for using CodeWarrior javai:

Automatic Startup on Solaris Systems

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.

Installing Jeeves as a Windows NT System Service

To set up Jeeves to start as a Windows NT system service:

  1. Type the following commands from the MS-DOS shell:
    
            C> cd JeevesA2\bin
            C> ntservice -install
    
  2. Add the following line to the httpd.properties file, which is located in the JeevesA2\admin directory:
    
    	ntservice=true
    

Removing Jeeves as a System Service

To remove Jeeves as a system service:

  1. Type the following commands from the MS-DOS shell:
    
            C> cd JeevesA2\bin
            C> ntservice -remove
    
  2. Remove the following line in the httpd.properties file, which is located in the JeevesA2\admin directory:
    
    	ntservice=true
    
    or edit this line to be 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:

http://ServerHostName:8080/

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.

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.

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!

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.

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

Locating the Documentation

HTML documentation is in the doc/ directory. The API documentation is in doc/documentation/apidoc/packages.html.

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.


jeeves@java.sun.com
Last modified: 11/11/96