|
Home
Installation
Indexing
Configuration
Purchasing
|
|
This page is for information purposes only.
It is not a recommendation to use this Java servlet engine or application server.
Please consult the supplier's documentation for full installation information
and details of how to deploy and configure servlets such as Spy-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.
|
|
Sun ONE Application Server 7
The Sun ONE Application Server 7 has a built-in Java servlet engine.
It is available for several platforms from
www.sun.com/software/products.
It supports the servlet specification JSDK 2.3.
You might also wish to consider the
Sun ONE Web Server 6 (iPlanet).
The Sun ONE Application Server has an "Admin Console" browser interface which makes it easy to deploy Spy-Server.
Indexing emails
The default security settings prevent Spy-Server from setting various properties
that are required for sending emails.
The server administrator can alter a server's JVM config/server.policy file
to enable read and write access to system properties, thereby enabling Spy-Server indexing emails.
In the section of this file described as "Basic set of required permissions granted to all remaining code"
change the line containing java.util.PropertyPermission to include write permission, ie:
permission java.util.PropertyPermission "*", "read,write";
If you cannot or do not wish to alter this file then Spy-Server cannot send emails.
Spy-Server Deployment, Configuration and Usage Instructions
These instructions are for Sun ONE Application Server 7.0.
Installing Spy-Server
Installing the Spy-Server web application SpySrv50.war is usually called
deployment.
- Start the Application Server
- Start the "Admin Console" and login.
- Open up the server tree using the handle icons and click on Web Apps in the Applications menu.
- Click on the "Deploy..." button
- Browse to select SpySrv50.war and click OK
- Check the form settings; leave the "Web Application Name" and "Context Root" at
SpySrv50 for now.
Click OK
Spy-Server URLs
The following URLs should now be available
(assuming that you set the Application Name to SpySrv50):
Check the work directory location
Before you start testing Spy-Server, it is important to check that the
Spy-Server work directory is in a suitable 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.
Spy-Server makes a directory called SpyData when it starts.
If this is not suitable then you need to change the work
init parameter.
For Sun ONE Application Server, the SpyData directory will usually be visible
to browsers if you leave it in its default location. So it is recommended that you change the
work directory as follows:
Changing init parameters
- In the Spy-Server installation directory, open the file
WEB-INF/web.xml for editing.
- Find the init parameter name (eg "work") in param-name tags and enter your chosen
value in between the following <param-value> and </param-value> tags.
Save the file.
- Restart the main server as follows:
In the Sun ONE Application Server Admin Console,
click on "Stop" and then "Start".
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/SpySrv50/search.
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
Follow the general Getting Started instructions
to index your own site to build a search database and start searching.
Test Word highlighting
See the Word highlighting instructions
for details of how to set this up for HTML pages shown in Internet Explorer 4+.
|
