Getting Started
+Getting Started with the i-scream Central Monitoring System
-1. Installing the corba services (pre-requiste for the server)
+1. Installing the corba services (pre-requisite for the server)
The server requires a CORBA Naming Service to run. It may be that you already -have such a system running, in which case you can use this. Simply edit the +have such a system running, in which case you can use that. Simply edit the jacorb.properties file to point to your Naming service. If you don't have a -naming service running you could just setup your own manually, but if like us +naming service running you could just set up your own manually, but if like us you want the easy approach, install our corba services program.
This program runs the naming service and provides a builtin webserver to serve requests to the server application. The documentation details how to get @@ -37,9 +30,9 @@ this running. It should simply be a case of extracting
1. Installing the server
The first stage is to download and install the server application. The latest versions of all i-scream applications can be found at the following -URL;
-http://www.i-scream.org.uk/downloads
-Once downloaded the archive should be extracted to a directory of your +URL:
+http://www.i-scream.org/downloads
+Once downloaded, the archive should be extracted to a directory of your choice. The server will run on most Java enabled platforms (including Windows, Linux and FreeBSD).
The archive consists of only a few files and directories. The main file is @@ -75,15 +68,17 @@ with running the run script provided. This will boot t displaying some basic information to the console. If something goes wrong, the error message should point to the cause.
4. Setting up hosts
-Hosts can be run on either unix (tested with Solaris, FreeBSD and some -Linux distributions) or windows. Both are equally easy to setup.
-Firstly, the unix host is called "ihost". This can be downloaded from the +
Hosts can be run on either Unix (tested with Solaris, FreeBSD and some +Linux distributions) or Windows. Both are equally easy to setup.
+Firstly, the Unix host is called "ihost". This can be downloaded from the i-scream website. Once extracted it just needs to be started up. You need two -pieces of information to do this; the filtermanager (part of the server) host +pieces of information to do this: the filtermanager (part of the server) host and port number. If you haven't changed much in terms of configuration this will be the machine the server is running on, and port 4567. To start ihost you -simply type;
+simply type: +ihost.pl server.domain.com port+
ihost will then contact the server to obtain it's configuration and start sending information.
The windows host, winhost, is very similar. All you need to do is install it @@ -100,11 +95,11 @@ successfully been completed.
run. However, in the near future we hope to have an installer to make life easier. Conient is a Java application and will run on most Java enabled platforms. -After extracting the run script can be used to start Conient, or in some +
After extracting, the run script can be used to start Conient, or in some cases the JAR file can be executed manually. The GUI will then load. The configuration section requires you to enter a host and port for the server. By default this will be the machine on which the server is running -on port 4510. Conient will then connect upon request and start displaying +and port 4510. Conient will then connect upon request and start displaying information.
Assuming data is displayed you have successfully setup the i-scream central monitoring system. Well done!
@@ -118,31 +113,36 @@ also ensure the database is kept relatively clean.Full instructions are available in the DBReporter documentation.
7. Setting up the Web Interface
The Web interface allows you to view various aspects of the i-scream -central monitoring systems output. These include realtime viewing of data +central monitoring system's output. These include realtime viewing of data (much like Conient), links to the DBReporter above, and full displaying of the alerts that can be generated by the server.
The archive contains a series of PHP scripts which should be placed on -your PHP enabled webserver. The configuration files allow you to tailor +your PHP enabled web server. The configuration files allow you to tailor the setup to suit your needs.
Full instructions are available in the relevant documentation.
8. Further
You may decide to expand your setup to cover a larger network. For example, a -distributed filter arrangement could cut down on the amount of network traffic +distributed filter arrangement could cut down on the amount of traffic being sent around the network. The server itself can be distributed to suit your needs. You may wish to run the database section of the server on the same machine as the database, while running the rest on another machine.
Some discussion about this is available in the server documentation.
If you have any questions about any of the above, please don't hesitate to -contact us at dev@i-scream.org.uk. If you find we've missed something out, +contact us at dev@i-scream.org. If you find we've missed something out, again, please let us know.
-Finally, we'd like to thank you for trying an i-scream product. We realise +
Finally, we'd like to thank you for trying this i-scream product. We realise that it's still at an early stage, and we therefore appreciate you taking the time to try it out.
-The i-scream team. +
The i-scream team.
+