
--------------------------------------------------------------------------------
LOCUS (tm) Server Version 1.2 INSTALLATION
(c) 2003 Tikal Technology, Inc.
--------------------------------------------------------------------------------

Locus Server Installation Steps:


Step 1: Installing the lserver.tar file.
---------------------------------------

Install the lserver.tar file in a directory of your choosing. The server startup
script is written to find the server in either ${HOME}/opt/locus/server,
/opt/locus/server, or /usr/local/locus/server. You can also modify the startup 
script to support any directory of your choosing. You will want to un-"tar" the 
tar file in a directory of your choosing. Un-"Tarring" the file will create a 
directory tree with the top directory being named "server". So make a directory
tree with the last directory being named "locus". Place the lserver.tar file in
that directory and un-tar the file.

The locus server directory tree appears as follows:

	+ server
		- agents (uploaded agent data files)
		- agentscripts (scripts for agent alerts, commands, messages
				and tasks )
		- bin (startup scripts)
		- cfgmgmt (configuration management files)
		- lib (jar files)
		- logs (log files)
		- serverscripts (scripts for server tasks)
		- tmp (temporary files)


Step 2: Server configuration file settings.
------------------------------------------

The "cfgmgmt" directory contains all the runtime configuration files for the 
Locus Server and Locus Agents. There is only one configuration file you need to
change after the install: the Server.conf file. This configuration file must be 
modified to provide service connection to the Locus Server and other details. 
This file is CHANGED during runtime so make a copy of the file after creating 
your initial version.

There are 3 parts to the Server.conf configuration file that must be addressed.

A. Server Base Configuration

- Server.Host=SERVER-HOST-NAME

	- Replace SERVER-HOST-NAME with the name of the host on which the
	Locus Server is installed.

- Server.IP=SERVER-IP-ADDRESS

	- Replace SERVER-IP-ADDRESS with the ip address of the host on which the
	Locus Server is installed.

- Server.Port=SERVER-SERVICE-PORT
			
	- Replace SERVER-SERVICE-PORT with the port number the Locus Server will
	provide service or listen for connections from Locus Agents or the 
	Locus Web Application.

B. Web Application Service

	The Locus Server has the ability to generate email that directly 
	references the URL of the Locus Web Application. To this end, you must
	configure the following:

- Server.Service.Http=http://YOUR-WEBAPP-SERVER:YOUR-WEBAPP-SERVER-PORT

	- Replace YOUR-WEBAPP-SERVER with the host name or ip address of the
	host machine that is running your J2EE Servlet Container server.
	- Replace YOUR-WEBAPP-SERVER-PORT with the port that your J2EE Servlet
	Container server provides service on, i.e. 8080.

- Server.Service.Prefix=/locus/servlet/Dispatch

	- This item need not change. However if you must change it, only the 
	first part, "locus", can be changed and expect the web application to 
	interface to server email.

C. Server Mail Configuration.

	The Locus Server requires configuring mail server support. This allows
	emails to be routed to the proper mail server.

- Server.Mail.MailHost=MAIL-SERVER-HOSTNAME

	- Replace MAIL-SERVER-HOSTNAME with the host name of your primary mail
	server. A secondary mail server can be used as long as it relays to your
	primary mail server.

- Server.Mail.Transport=smtp

	- This item should not change.

- Server.Mail.Recipients=BASE-EMAIL-RECIPIENTS

	- Replace BASE-EMAIL-RECIPIENTS with a comma separated list of email
	recipients for email from the Locus Server. This configuration item can
	be updated via the Locus Web Application.


Step 3: Start Locus Server.
---------------------------

Now you can start the Locus Server on the host. Using the Locus Server startup
script you can test your environment, and start, stop, and restart the server.
From the "locus/server" directory execute the following:

- "bin/server.sh env"		to display the server's environment.
- "bin/server.sh start"		to start the server
- "bin/server.sh stop"		to stop the server
- "bin/server.sh restart"	to restart the server

Issue the start command to put the server in the background. If a Locus Server is
running the agents will connect. If a Locus Server can not be found, the agents
will note a connection can not be name and continue to run.

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

