Installation of the distributed system "Integrated Server Monitoring" (Linux 64 bit)
           ------------------------------------------------------------------------------------

The central component of the system is designed for 64-bit Linux. It requires approximately 200 MB of space
for operation in the file system, because the memory is allocated for data storage at the beginning. For
the operation of the Management Station and the agents (client) root privileges are not (!) necessary.
An exception is the background process for receiving SNMP traps over port 162 udp/tcp.

On the central Management Station X11 (xlib) must be installed for the graphical user interface.
The server must be network-capable. For the web interface, a web server (Apache) is required.

Installation:
-------------

To install the system the tar file "system.tar.gz" is required. It contains a directory structure with program
files, shared libraries and configuration files.

1) Copy the tar file into a directory of your choice (e.g. /opt). The file system for the installation
   must be mounted locally 
2) Change to the directory and execute the command: tar xvzpf system.tar.gz
3) Change to the subdirectory "monitor": cd ./monitor
4) Set the DISPLAY variable for the X11 output: export DISPLAY=....:0.0
5) Run the command "start.bash", started with the different background processes, including the graphical
   user interface
6) Setting environment variables for the calling shell, which are contained in the
   file "Environment": . ./Environment

The Management Station requires the environment variable "OMDIR", which points at the subdirectory "database".

After calling "start.bash" a widget will appear with a request to set up an administrator for the system.
With the pull-down menu called "Operators" on the left top you can now set up an administrator name and
password, and then other operators and/or administrators.

Important: The web interface (html/browserhtml), you can use only with name and password.

Programs for the Management Station:

1) "browserctl" in the subdirectory "browserctl": background process must always be called first
   at system boot or reboot, and be active.
2) "browser" in the subdirectory "browser": Event Browser to visualize the messages and setting of
   the system to a stylesheet in the same directory, the file is required "monitorkeys.sig"
3) "browser html" in the subdirectory "html": CGI program for the Web server in the same directory
   the configuration file "browserhtml.conf" in which the environment variable "OMBDIR" is set
   to point to 9)
4) "monlistener" in the subdirectory "monlistener": background process to receive messages from
   the agents over tcp, requires the file "monitorkeys.sig"
5) "lifechecker" in the subdirectory "life checker": background process to manage the Heartbeats,
   root privileges are required only for Icmp-Ping
6) "portchecker" in the subdirectory "portchecker": background process for the realization of
   active surveillance.
7) "snmptraplistener" in the subdirectory "snmptraps": background process to receive
   snmp traps (version v1, v2c, v3) over port 162, requires root privileges if port < 1024
8) Shared libraries in the subdirectory "sharedlibs". The environment variable "LD_LIBRARY_PATH" must be set
9) In the subdirectory "database" that contains the data for the monitoring system. There are binaries,
   and they are not editable.
10) User manual in the subdirectory "doc"

For encryption, the agent programs need the file "monitorkeys.sig" that are either in the same directory as
the executable programs or in the home directory of the user under which the programs run or in /etc. The file
is created or changed at the beginning of the operations and maintained in the following. On the opposite side the
same file with the same signature must be present.

Agents (client programs) Linux 64 Bit:

1) "basemonagent" in the subdirectory "agents/linux64": Agent for standard monitoring with an exemplary
   configuration file
2) "logmonagent": Agent limited to the monitoring of log files 
3) "scriptmonagent": Agent for the evaluation of scripts or commands 
4) "asyncmonagent": Extension of 2) and 3) with individual polling intervals and heartbeat
5) "secmonagent": Agent for security; reports changes to the file system (e.g. unwanted installations by "rootkits")
6) "rsendmsg": Program to directly send a message to the Management Station 
7) "remoteconfd": Background process of the client that enables centralized editing of configuration files
   from the management station

Agents (client programs) MacOS X 64 Bit in "agents/macosx64": as Linux

Agents for Windows 32 Bit (also for 64 Bit, WOW64):

1) "winmonagent.exe" in the subdirectory "agents/windows32: Agent for standard monitoring with an
   exemplary configuration file
2) "logmonagent.exe": Agent limited to the monitoring of log files 
3) "scriptmonagent.exe": Agent for the evaluation of scripts or commands
4) "asyncmonagent.exe": Extension of 2) and 3) with individual polling intervals and heartbeat
5) "remoteconfd.exe": background process of the client that allows you to edit configuration files
   from the management station
6) "rsendmsg.exe": Program to directly send a message to the Management Station 

The background processes can be terminated with the normal SIGTERM signal: kill <pid>, there is no need
for extra stop routines, but probably start routines to automatically start when you reboot. All programs
have the option "-h", an online help

Disclaimer: The author can take over no liability for the free programs.