Spy-Server Installation Guide for BEA WebLogic Server

Introduction Spy-Server is a Java servlet.  It is a program that must be run by a Java servlet engine on a web server, with its output viewed in a browser. Java application servers usually have built-in support for Java servlets. Alternatively, a Java servlet engine can be installed and connected up to an existing server. Please refer to these pages for more information: Servers page for details of application servers and servlet engines. Installation guide for application servers and servlet engines. Deployment overview for Spy-Server. Please consult our Getting Started Guide for an overview of how to obtain Spy-Server, set up your server, install and configure Spy-Server.  Get the Spy-Server software from the Download page.

Page contents WebLogic introduction Setting up... Install Spy-Server Spy-Server URLs Work directory Run test searches Index your own site Word highlighting Configuration Init parameters Log files Uninstalling Spy-Server

BEA WebLogic Server

BEA WebLogic Server is a Java application server that includes a servlet engine. It is available for several platforms from http://www.bea.com/products/weblogic/server/. It supports the servlet specification JSDK 2.3.

WebLogic Server includes a servlet web server so it does not need to be connected to a web server when testing.

WebLogic Server has an "Admin Console" browser interface which makes it fairly easy to deploy Spy-Server.

Spy-Server Deployment and Configuration Instructions

Installing Spy-Server

1. If necessary, use the WebLogic Server Domain Configuration Wizard to make a new domain connected to a server port.

2. Start the WebLogic Server Admin Console, eg: http://localhost:7001/console.

3. In the navigation panel on the left, open the domain and Deployments folders and click on "Web Applications".

4. Click on "Configure a new Web Application..."

5. Assuming that the Spy-Server Web Application (SpySrv50.war) is not listed at the bottom, click on "upload it through your browser". Browse to find the file SpySrv50.war on your local hard disk and then click on Upload.

6. Click on "[select]" to the left of SpySrv50.war.

7. Select one of the "Available Servers" and click on the right arrow icon to move the server into the "Target Servers" box.
   Enter any name for the application, eg Searcher.
   Click on the "Configure and Deploy" button.

8. Wait until the screen updates to show the Deployed status as "true" and the "Deployment Activity" status as completed.

Spy-Server URLs

The following URLs should now be available, (assuming that WebLogic Server is running locally at port 7001):

Spy-Server welcome page	http://localhost:7001/SpySrv50
Spy-Server documentation	http://localhost:7001/SpySrv50/doc/
Spy-Server search page	http://localhost:7001/SpySrv50/search
Spy-Server configuration screen	http://localhost:7001/SpySrv50/search?config=now

Check the work directory location

Spy-Server uses a work directory to store all its configuration information and search database files. It is important that this directory is secure from unwanted direct access, while still being available to Spy-Server. It is also a good idea to make sure that this directory is not wiped accidentally, eg if you update the Spy-Server runtime to a newer version. Finally, it is also a good idea to backup the contents of the Spy-Server work directory regularly.

Changing init parameters
Click on "Edit Web Application Deployment Descriptors..." to alter the work init parameter.

Test Search

Check that you can search the Spy-Server documentation correctly, as follows:

Browse to the Spy-Server localised search page, eg http://localhost:7001/SpySrv50/search. Check that the "Spy-Server Search" image is shown correctly; if not check the first IMG link in the template file SpyHead.htt .

Enter some search text, eg engine and click on "Search".

The first 10 hits are displayed. Click on a hit and check that the result page is displayed correctly in the browser.

If the hit page is not shown correctly, then you probably need to alter the Additional Base URL setting in the configuration screen Searching section.

Index your own site

Test Word highlighting

Additional Tomcat Instructions

Log files

For example, for user project "phdcc" on server "shiela", this is the log file...
   ../user_projects/phdcc/shiela/shiela.log

Uninstalling Spy-Server