
--------------------------------------------------------------------------------
LOCUS (tm) 
(c) 2003 Tikal Technology, Inc.
--------------------------------------------------------------------------------

First of all, thank you for taking the time to download our software. We hope
you will find the Locus software to be useful in your work and for your work
environment.

The Locus Software was designed to support system administration. It is easily
extensible and relatively easy to install, support, administer, and use.

However, the Locus Software is more than just a system administration tool. 
Locus is a framework. A framework for system monitoring and application 
monitoring. The Locus agent software can be added to any application which can 
then interact with the Locus Server and Web Application. Thus providing 
Operations with a tool to support the corporation.

The Locus Software is web-based. This gives the user base the ability to access
Locus from any workstation if needed. Software does not have to be installed on
every user's workstation.

--------------------------------------------------------------------------------

To ease the installation and evaluation of the Locus Software please follow the 
steps outlined below:

1. Choose a non-critical computer which can support J2EE applications. This will
	require a version of Java 1.3 or higher and J2EE 1.3.1 to be installed.
2. Also install a standard Java Server/ JavaServer Pages application. Let us
	suggest Apache Tomcat 4.1 or higher.
3. Install in the /opt filesystem. If you wish to install in a different location
	please modify the instructions below accordingly.
4. Create a directory named /opt/locus.
5. Create a directory named /opt/locus/software and move this file along with the
	distribution tar file to the software directory.
6. Un-tar the distribution tar file. This will produce 3 more files. The
	server tar file, agent tar file, and webapp WAR file.
7. Create a directory named /opt/locus/server. Move the server tar file into the 
	server directory. Un-tar the server tar file and proceed to read the
	README and INSTALL files. Follow the directions accordingly.
8. Create a locus directory in your Java Server webapps directory. Move the webapp 
	WAR file into the locus director you just created. Un-WAR the file using 
	the jar command... jar xvf locus.war. Read the README and INSTALL files.
	Follow the directions accordingly.
9. Create a directory named /opt/locus agent. Move the agent tar file into the
	agent directory. Un-tar the server tar file and proceed to read the 
	README and INSTALL files. Follow the directions accordingly.

At this point all software is in the proper location. If you followed the server
	and agent instructions, you will have a functioning server and agent.
Point your web browser at the Java Server URL to access Locus. The URL will look
	something like http://YOUR-WEB-MACHINE:8080/locus/servlet/Dispatch

* The most critical items to configure correctly are the port assignments.
* Please double-check the ports for the server and agent. And ensure the webapp
* has the proper port assignment to connect to the server.

If you have any problems are suggestions concerning this installation please
email us at the address below.

Thank you again for evaluating Locus (tm).
Tikal Technology.

--------------------------------------------------------------------------------
Visit Tikal Technology on the web at http://www.tikaltech.com/locus
Contact us at support@tikaltech.com
--------------------------------------------------------------------------------
LOCUS (tm) J2EE Web Application Version 1.2 INSTALLATION
(c) 2003 Tikal Technology, Inc.
--------------------------------------------------------------------------------
