Jeeves Installation and Startup: Alpha1.2


Installation:

See the release notes for supported configurations, and make sure that you have one of them before you proceed. You may need to get a more recent version of the Java Developer's Kit, for one example.

  1. Download the Jeeves-alpha1-2.zip or Jeeves-alpha1-2+.zip file from the Jeeves 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 Jeeves-alpha1-2.zip to the directory where you want to install the Jeeves software.
  4. Then unzip Jeeves-alpha1-2.zip. This will create a directory called "JeevesA1.2", which will contain the Alpha1.2 release. The JeevesA1.2 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 the original Alpha1 release - you will need to transfer over any changes you had made to the original release 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 Jeeves-alpha1-2.zip file, if you wish.

Startup:

This alpha release supports two ways to start the Jeeves server: by hand, and (on Solaris) 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 8888:


        % cd JeevesA1.2
        % bin/httpd &

On Win32 platforms, run server root\bin\httpd.exe. For example, to run the server as a background process listening on the default port 8888, from the MS-DOS shell, type:


        C> cd JeevesA1.2
        C> bin\httpd

Automatic Startup (Solaris Only)

On Solaris systems, you have an alternative of setting up Jeeves to start whenever your machine boots. For the Alpha1.2 release, you need to set this up manually, or not use this feature.

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 rootetc/jeeves.server directory.

You will probably want to modify the server configuration file server rootadmin/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.

Accessing and Setting Up Your New Website:

After you have started the server, you may access the default home page for your new website using the following URL:
http://ServerHostName:8888/

Use the administrative tool form that page to change the default password for the "admin" account. There may be other things you wish to change in the system's administration at this time.

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!


jeeves@java.sun.com
Last modified: 08/19/96