| 1 |
|
<!--#include virtual="/doctype.inc" --> |
| 2 |
< |
|
| 3 |
< |
<head> |
| 4 |
< |
<title>Getting Started with the i-scream Central Monitoring System</title> |
| 2 |
> |
<head> |
| 3 |
> |
<title> |
| 4 |
> |
Getting Started with the i-scream Central Monitoring System |
| 5 |
> |
</title> |
| 6 |
|
<!--#include virtual="/style.inc" --> |
| 7 |
< |
</head> |
| 8 |
< |
|
| 9 |
< |
<body> |
| 10 |
< |
|
| 10 |
< |
<div id="container"> |
| 11 |
< |
|
| 12 |
< |
<div id="main"> |
| 13 |
< |
|
| 7 |
> |
</head> |
| 8 |
> |
<body> |
| 9 |
> |
<div id="container"> |
| 10 |
> |
<div id="main"> |
| 11 |
|
<!--#include virtual="/header.inc" --> |
| 12 |
< |
|
| 13 |
< |
<div id="contents"> |
| 14 |
< |
<h1 class="top">Getting Started</h1> |
| 15 |
< |
|
| 16 |
< |
<h2>Getting Started with the i-scream Central Monitoring System</h2> |
| 17 |
< |
|
| 18 |
< |
<h3>1. Installing the corba services (pre-requisite for the server)</h3> |
| 19 |
< |
<p>The server requires a CORBA Naming Service to run. It may be that you already |
| 20 |
< |
have such a system running, in which case you can use that. Simply edit the |
| 21 |
< |
jacorb.properties file to point to your Naming service. If you don't have a |
| 22 |
< |
naming service running you could just set up your own manually, but if like us |
| 23 |
< |
you want the easy approach, install our corba services program.</p> |
| 24 |
< |
<p>This program runs the naming service and provides a builtin webserver to |
| 25 |
< |
serve requests to the server application. The documentation details how to get |
| 26 |
< |
this running. It should simply be a case of extracting and running.</p> |
| 27 |
< |
<h3>1. Installing the server</h3> |
| 28 |
< |
<p>The first stage is to download and install the server application. The |
| 29 |
< |
latest versions of all i-scream applications can be found at the following |
| 30 |
< |
URL:</p> |
| 31 |
< |
<p><a href="http://www.i-scream.org/downloads">http://www.i-scream.org/downloads</a></p> |
| 32 |
< |
<p>Once downloaded, the archive should be extracted to a directory of your |
| 33 |
< |
choice. The server will run on most Java enabled platforms (including |
| 34 |
< |
Windows, Linux and FreeBSD).</p> |
| 35 |
< |
<p>The archive consists of only a few files and directories. The main file is |
| 36 |
< |
the iscream-server.jar archive which contains all the binary code for the |
| 37 |
< |
server. The lib directory contains other JAR archives which the server |
| 38 |
< |
requires to run. The etc directory contains (or will contain) |
| 39 |
< |
configuration for most of the i-scream central monitoring system. The next |
| 40 |
< |
step is to configure the server to suit your requirements.</p> |
| 41 |
< |
<h3>2. Configuring the server</h3> |
| 42 |
< |
<p>The configuration is split into two main files. The first, |
| 43 |
< |
default.properties can be considered a bootstrap configuration. This means |
| 44 |
< |
that it provides basic configuration to get the server started, after |
| 45 |
< |
which point the main configuration system takes over. This file should be |
| 46 |
< |
checked through, and is pretty well explained by comments.</p> |
| 47 |
< |
<p>The rest of the server configuration is based on system.conf. This can |
| 48 |
< |
hold the entire system configuration, including hosts. It may also specify |
| 49 |
< |
other configuration files to be included in the main configuration. This |
| 50 |
< |
file is also commented extensively.</p> |
| 51 |
< |
<p>This step may well take some time to get right, and you can come back to |
| 52 |
< |
it at any point. Lots of the configuration can be changed "on the fly" |
| 53 |
< |
as well.</p> |
| 54 |
< |
<p>For fuller and complete details of the configuration system, and the |
| 55 |
< |
server in general, please see the Server User Guide in the documentation |
| 56 |
< |
section of the website.</p> |
| 57 |
< |
<h3>2a. Setting up the database</h3> |
| 58 |
< |
<p>The i-scream central monitoring system can make use of a database for |
| 59 |
< |
generating historical reports. The documentation explains how you would |
| 60 |
< |
configure the system to do this. You will need to create a single basic |
| 61 |
< |
table yourself, this is also explained in the documentation.</p> |
| 62 |
< |
<h3>3. Starting the server</h3> |
| 63 |
< |
<p>Starting up the server is a trivial task. Usually you can just get away |
| 64 |
< |
with running the run script provided. This will boot the server up |
| 65 |
< |
displaying some basic information to the console. If something goes wrong, |
| 66 |
< |
the error message should point to the cause.</p> |
| 67 |
< |
<h3>4. Setting up hosts</h3> |
| 68 |
< |
<p>Hosts can be run on either Unix (tested with Solaris, FreeBSD and some |
| 69 |
< |
Linux distributions) or Windows. Both are equally easy to setup.</p> |
| 70 |
< |
<p>Firstly, the Unix host is called "ihost". This can be downloaded from the |
| 71 |
< |
i-scream website. Once extracted it just needs to be started up. You need two |
| 72 |
< |
pieces of information to do this: the filtermanager (part of the server) host |
| 73 |
< |
and port number. If you haven't changed much in terms of configuration this will |
| 74 |
< |
be the machine the server is running on, and port 4567. To start ihost you |
| 75 |
< |
simply type:</p> |
| 76 |
< |
</font> |
| 77 |
< |
<pre>ihost.pl server.domain.com port</pre> |
| 78 |
< |
<font face="arial,sans-serif" size="2"> |
| 79 |
< |
<p>ihost will then contact the server to obtain it's configuration and start |
| 80 |
< |
sending information.</p> |
| 81 |
< |
<p>The windows host, winhost, is very similar. All you need to do is install it |
| 82 |
< |
using the provided installer in the download, and then edit the ini file to |
| 83 |
< |
provide the two bits of information above. Running the application starts up |
| 84 |
< |
communication with the server and data sending commences.</p> |
| 85 |
< |
<p>Full details of both of these hosts can be found in the relevant |
| 86 |
< |
documentation on the website.</p> |
| 87 |
< |
<h3>5. Using Conient</h3> |
| 88 |
< |
<p>Conient allows you to view, in real time, the data being sent by the |
| 89 |
< |
hosts. This is a perfect way to test that all the above steps have |
| 90 |
< |
successfully been completed.</p> |
| 91 |
< |
<p>At present Conient is simply another archive which can be extracted and |
| 92 |
< |
run. However, in the near future we hope to have an installer to make life |
| 93 |
< |
easier. Conient is a Java application and will run on most Java enabled |
| 94 |
< |
platforms.</p> |
| 95 |
< |
<p>After extracting, the run script can be used to start Conient, or in some |
| 96 |
< |
cases the JAR file can be executed manually. The GUI will then load. The |
| 97 |
< |
configuration section requires you to enter a host and port for the |
| 98 |
< |
server. By default this will be the machine on which the server is running |
| 99 |
< |
and port 4510. Conient will then connect upon request and start displaying |
| 100 |
< |
information.</p> |
| 101 |
< |
<p>Assuming data is displayed you have successfully setup the i-scream |
| 102 |
< |
central monitoring system. Well done!</p> |
| 103 |
< |
<p>This is explained in much more detail in the Conient documentation.</p> |
| 104 |
< |
<h3>6. Setting up DBReporter</h3> |
| 105 |
< |
<p>If you are making use of a database you can setup the DBReporter to |
| 106 |
< |
generate web-based reports of the information collected. This is just a |
| 107 |
< |
case of extracting the archive to a suitable location, configuring it, and |
| 108 |
< |
setting it to run on a regular basis (we suggest daily). DBReporter will |
| 109 |
< |
also ensure the database is kept relatively clean.</p> |
| 110 |
< |
<p>Full instructions are available in the DBReporter documentation.</p> |
| 111 |
< |
<h3>7. Setting up the Web Interface</h3> |
| 112 |
< |
<p>The Web interface allows you to view various aspects of the i-scream |
| 113 |
< |
central monitoring system's output. These include realtime viewing of data |
| 114 |
< |
(much like Conient), links to the DBReporter above, and full displaying of |
| 115 |
< |
the alerts that can be generated by the server.</p> |
| 116 |
< |
<p>The archive contains a series of PHP scripts which should be placed on |
| 117 |
< |
your PHP enabled web server. The configuration files allow you to tailor |
| 118 |
< |
the setup to suit your needs.</p> |
| 119 |
< |
<p>Full instructions are available in the relevant documentation.</p> |
| 120 |
< |
<h3>8. Further</h3> |
| 121 |
< |
<p>You may decide to expand your setup to cover a larger network. For example, a |
| 122 |
< |
distributed filter arrangement could cut down on the amount of traffic |
| 123 |
< |
being sent around the network. The server itself can be distributed to suit your |
| 124 |
< |
needs. You may wish to run the database section of the server on the same |
| 125 |
< |
machine as the database, while running the rest on another machine.</p> |
| 126 |
< |
<p>Some discussion about this is available in the server documentation.</p> |
| 127 |
< |
<p>If you have any questions about any of the above, please don't hesitate to |
| 128 |
< |
contact us at <a href="mailto:dev@i-scream.org">dev@i-scream.org</a>. If you find we've missed something out, |
| 129 |
< |
again, please let us know.</p> |
| 130 |
< |
<p>Finally, we'd like to thank you for trying this i-scream product. We realise |
| 131 |
< |
that it's still at an early stage, and we therefore appreciate you taking |
| 132 |
< |
the time to try it out.</p> |
| 133 |
< |
<p>The i-scream team.</p> |
| 134 |
< |
</div> |
| 135 |
< |
|
| 12 |
> |
<div id="contents"> |
| 13 |
> |
<h1 class="top"> |
| 14 |
> |
Getting Started |
| 15 |
> |
</h1> |
| 16 |
> |
<h2> |
| 17 |
> |
Getting Started with the i-scream Central Monitoring System |
| 18 |
> |
</h2> |
| 19 |
> |
<h3> |
| 20 |
> |
1. Installing the corba services (pre-requisite for the |
| 21 |
> |
server) |
| 22 |
> |
</h3> |
| 23 |
> |
<p> |
| 24 |
> |
The server requires a CORBA Naming Service to run. It may |
| 25 |
> |
be that you already have such a system running, in which |
| 26 |
> |
case you can use that. Simply edit the jacorb.properties |
| 27 |
> |
file to point to your Naming service. If you don't have a |
| 28 |
> |
naming service running you could just set up your own |
| 29 |
> |
manually, but if like us you want the easy approach, |
| 30 |
> |
install our corba services program. |
| 31 |
> |
</p> |
| 32 |
> |
<p> |
| 33 |
> |
This program runs the naming service and provides a builtin |
| 34 |
> |
webserver to serve requests to the server application. The |
| 35 |
> |
documentation details how to get this running. It should |
| 36 |
> |
simply be a case of extracting and running. |
| 37 |
> |
</p> |
| 38 |
> |
<h3> |
| 39 |
> |
1. Installing the server |
| 40 |
> |
</h3> |
| 41 |
> |
<p> |
| 42 |
> |
The first stage is to download and install the server |
| 43 |
> |
application. The latest versions of all i-scream |
| 44 |
> |
applications can be found at the following URL: |
| 45 |
> |
</p> |
| 46 |
> |
<p> |
| 47 |
> |
<a href="http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/cms/"> |
| 48 |
> |
http://www.mirror.ac.uk/sites/ftp.i-scream.org/pub/i-scream/cms/</a> |
| 49 |
> |
</p> |
| 50 |
> |
<p> |
| 51 |
> |
Once downloaded, the archive should be extracted to a |
| 52 |
> |
directory of your choice. The server will run on most Java |
| 53 |
> |
enabled platforms (including Windows, Linux and FreeBSD). |
| 54 |
> |
</p> |
| 55 |
> |
<p> |
| 56 |
> |
The archive consists of only a few files and directories. |
| 57 |
> |
The main file is the iscream-server.jar archive which |
| 58 |
> |
contains all the binary code for the server. The lib |
| 59 |
> |
directory contains other JAR archives which the server |
| 60 |
> |
requires to run. The etc directory contains (or will |
| 61 |
> |
contain) configuration for most of the i-scream central |
| 62 |
> |
monitoring system. The next step is to configure the server |
| 63 |
> |
to suit your requirements. |
| 64 |
> |
</p> |
| 65 |
> |
<h3> |
| 66 |
> |
2. Configuring the server |
| 67 |
> |
</h3> |
| 68 |
> |
<p> |
| 69 |
> |
The configuration is split into two main files. The first, |
| 70 |
> |
default.properties can be considered a bootstrap |
| 71 |
> |
configuration. This means that it provides basic |
| 72 |
> |
configuration to get the server started, after which point |
| 73 |
> |
the main configuration system takes over. This file should |
| 74 |
> |
be checked through, and is pretty well explained by |
| 75 |
> |
comments. |
| 76 |
> |
</p> |
| 77 |
> |
<p> |
| 78 |
> |
The rest of the server configuration is based on |
| 79 |
> |
system.conf. This can hold the entire system configuration, |
| 80 |
> |
including hosts. It may also specify other configuration |
| 81 |
> |
files to be included in the main configuration. This file |
| 82 |
> |
is also commented extensively. |
| 83 |
> |
</p> |
| 84 |
> |
<p> |
| 85 |
> |
This step may well take some time to get right, and you can |
| 86 |
> |
come back to it at any point. Lots of the configuration can |
| 87 |
> |
be changed "on the fly" as well. |
| 88 |
> |
</p> |
| 89 |
> |
<p> |
| 90 |
> |
For fuller and complete details of the configuration |
| 91 |
> |
system, and the server in general, please see the Server |
| 92 |
> |
User Guide in the documentation section of the website. |
| 93 |
> |
</p> |
| 94 |
> |
<h3> |
| 95 |
> |
2a. Setting up the database |
| 96 |
> |
</h3> |
| 97 |
> |
<p> |
| 98 |
> |
The i-scream central monitoring system can make use of a |
| 99 |
> |
database for generating historical reports. The |
| 100 |
> |
documentation explains how you would configure the system |
| 101 |
> |
to do this. You will need to create a single basic table |
| 102 |
> |
yourself, this is also explained in the documentation. |
| 103 |
> |
</p> |
| 104 |
> |
<h3> |
| 105 |
> |
3. Starting the server |
| 106 |
> |
</h3> |
| 107 |
> |
<p> |
| 108 |
> |
Starting up the server is a trivial task. Usually you can |
| 109 |
> |
just get away with running the run script provided. This |
| 110 |
> |
will boot the server up displaying some basic information |
| 111 |
> |
to the console. If something goes wrong, the error message |
| 112 |
> |
should point to the cause. |
| 113 |
> |
</p> |
| 114 |
> |
<h3> |
| 115 |
> |
4. Setting up hosts |
| 116 |
> |
</h3> |
| 117 |
> |
<p> |
| 118 |
> |
Hosts can be run on either Unix (tested with Solaris, |
| 119 |
> |
FreeBSD and some Linux distributions) or Windows. Both are |
| 120 |
> |
equally easy to setup. |
| 121 |
> |
</p> |
| 122 |
> |
<p> |
| 123 |
> |
Firstly, the Unix host is called "ihost". This can be |
| 124 |
> |
downloaded from the i-scream website. Once extracted it |
| 125 |
> |
just needs to be started up. You need two pieces of |
| 126 |
> |
information to do this: the filtermanager (part of the |
| 127 |
> |
server) host and port number. If you haven't changed much |
| 128 |
> |
in terms of configuration this will be the machine the |
| 129 |
> |
server is running on, and port 4567. To start ihost you |
| 130 |
> |
simply type: |
| 131 |
> |
</p> |
| 132 |
> |
<pre> |
| 133 |
> |
ihost.pl server.domain.com port |
| 134 |
> |
</pre> |
| 135 |
> |
<p> |
| 136 |
> |
ihost will then contact the server to obtain it's |
| 137 |
> |
configuration and start sending information. |
| 138 |
> |
</p> |
| 139 |
> |
<p> |
| 140 |
> |
The windows host, winhost, is very similar. All you need to |
| 141 |
> |
do is install it using the provided installer in the |
| 142 |
> |
download, and then edit the ini file to provide the two |
| 143 |
> |
bits of information above. Running the application starts |
| 144 |
> |
up communication with the server and data sending |
| 145 |
> |
commences. |
| 146 |
> |
</p> |
| 147 |
> |
<p> |
| 148 |
> |
Full details of both of these hosts can be found in the |
| 149 |
> |
relevant documentation on the website. |
| 150 |
> |
</p> |
| 151 |
> |
<h3> |
| 152 |
> |
5. Using Conient |
| 153 |
> |
</h3> |
| 154 |
> |
<p> |
| 155 |
> |
Conient allows you to view, in real time, the data being |
| 156 |
> |
sent by the hosts. This is a perfect way to test that all |
| 157 |
> |
the above steps have successfully been completed. |
| 158 |
> |
</p> |
| 159 |
> |
<p> |
| 160 |
> |
At present Conient is simply another archive which can be |
| 161 |
> |
extracted and run. However, in the near future we hope to |
| 162 |
> |
have an installer to make life easier. Conient is a Java |
| 163 |
> |
application and will run on most Java enabled platforms. |
| 164 |
> |
</p> |
| 165 |
> |
<p> |
| 166 |
> |
After extracting, the run script can be used to start |
| 167 |
> |
Conient, or in some cases the JAR file can be executed |
| 168 |
> |
manually. The GUI will then load. The configuration section |
| 169 |
> |
requires you to enter a host and port for the server. By |
| 170 |
> |
default this will be the machine on which the server is |
| 171 |
> |
running and port 4510. Conient will then connect upon |
| 172 |
> |
request and start displaying information. |
| 173 |
> |
</p> |
| 174 |
> |
<p> |
| 175 |
> |
Assuming data is displayed you have successfully setup the |
| 176 |
> |
i-scream central monitoring system. Well done! |
| 177 |
> |
</p> |
| 178 |
> |
<p> |
| 179 |
> |
This is explained in much more detail in the Conient |
| 180 |
> |
documentation. |
| 181 |
> |
</p> |
| 182 |
> |
<h3> |
| 183 |
> |
6. Setting up DBReporter |
| 184 |
> |
</h3> |
| 185 |
> |
<p> |
| 186 |
> |
If you are making use of a database you can setup the |
| 187 |
> |
DBReporter to generate web-based reports of the information |
| 188 |
> |
collected. This is just a case of extracting the archive to |
| 189 |
> |
a suitable location, configuring it, and setting it to run |
| 190 |
> |
on a regular basis (we suggest daily). DBReporter will also |
| 191 |
> |
ensure the database is kept relatively clean. |
| 192 |
> |
</p> |
| 193 |
> |
<p> |
| 194 |
> |
Full instructions are available in the DBReporter |
| 195 |
> |
documentation. |
| 196 |
> |
</p> |
| 197 |
> |
<h3> |
| 198 |
> |
7. Setting up the Web Interface |
| 199 |
> |
</h3> |
| 200 |
> |
<p> |
| 201 |
> |
The Web interface allows you to view various aspects of the |
| 202 |
> |
i-scream central monitoring system's output. These include |
| 203 |
> |
realtime viewing of data (much like Conient), links to the |
| 204 |
> |
DBReporter above, and full displaying of the alerts that |
| 205 |
> |
can be generated by the server. |
| 206 |
> |
</p> |
| 207 |
> |
<p> |
| 208 |
> |
The archive contains a series of PHP scripts which should |
| 209 |
> |
be placed on your PHP enabled web server. The configuration |
| 210 |
> |
files allow you to tailor the setup to suit your needs. |
| 211 |
> |
</p> |
| 212 |
> |
<p> |
| 213 |
> |
Full instructions are available in the relevant |
| 214 |
> |
documentation. |
| 215 |
> |
</p> |
| 216 |
> |
<h3> |
| 217 |
> |
8. Further |
| 218 |
> |
</h3> |
| 219 |
> |
<p> |
| 220 |
> |
You may decide to expand your setup to cover a larger |
| 221 |
> |
network. For example, a distributed filter arrangement |
| 222 |
> |
could cut down on the amount of traffic being sent around |
| 223 |
> |
the network. The server itself can be distributed to suit |
| 224 |
> |
your needs. You may wish to run the database section of the |
| 225 |
> |
server on the same machine as the database, while running |
| 226 |
> |
the rest on another machine. |
| 227 |
> |
</p> |
| 228 |
> |
<p> |
| 229 |
> |
Some discussion about this is available in the server |
| 230 |
> |
documentation. |
| 231 |
> |
</p> |
| 232 |
> |
<p> |
| 233 |
> |
If you have any questions about any of the above, please |
| 234 |
> |
don't hesitate to contact us at |
| 235 |
> |
<a href="mailto:dev@i-scream.org">dev@i-scream.org</a>. |
| 236 |
> |
If you find we've missed something out, again, please let |
| 237 |
> |
us know. |
| 238 |
> |
</p> |
| 239 |
> |
<p> |
| 240 |
> |
Finally, we'd like to thank you for trying this i-scream |
| 241 |
> |
product. We realise that it's still at an early stage, and |
| 242 |
> |
we therefore appreciate you taking the time to try it out. |
| 243 |
> |
</p> |
| 244 |
> |
<p> |
| 245 |
> |
The i-scream team. |
| 246 |
> |
</p> |
| 247 |
> |
</div> |
| 248 |
|
<!--#include virtual="/footer.inc" --> |
| 249 |
< |
|
| 141 |
< |
</div> |
| 142 |
< |
|
| 249 |
> |
</div> |
| 250 |
|
<!--#include virtual="/menu.inc" --> |
| 251 |
< |
|
| 252 |
< |
</div> |
| 146 |
< |
|
| 147 |
< |
</body> |
| 251 |
> |
</div> |
| 252 |
> |
</body> |
| 253 |
|
</html> |
