-----BEGIN PGP SIGNED MESSAGE-----


PHP SETI@home web monitor (phpsetimon).
Copyright ©2003, 2004 by Mario A. Valdez-Ramirez
You can contact Mario A. Valdez-Ramirez by email at
mario@mariovaldez.org or by paper mail at 
Olmos 809, San Nicolas, NL. 66495, Mexico.

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or (at
your option) any later version.

This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
USA


=========================================
2004/03/31.


=========================================
* About the PHP SETI@home web monitor.

The PHP SETI@home web monitor is a very simple PHP script to monitor
single or multiple setiathome programs running in your workstation or
server, via the local web server. 

The main page of the PHP SETI@home web monitor is:
http://www.mariovaldez.net/software/phpsetimon/


=========================================
* Features.

* Ideal for remote (or headless) servers running SETI@home. 
* Provides basic historical and current processing statistics. 
* Can preserve a graphical historical record of processed units (as
marks in a skymap). 
* Doesn't use CPU cycles (except a couple of seconds the first time a
map is created). 
* Require software available by default in most GNU/Linux
distributions. 
* Doesn't require a SQL database or SSH connections. 
* All graphic support is optional. 
* Works also in Windows servers. 
* Doesn't require special software to view the report page (no Java,
no libraries, just a web browser). 
* Can work with several setiathome clients running in the same server
(in multiprocessor servers). 
* Can work with remote setiathome clients (via mounted directories). 
* Can request skymap segments from NASA's SkyView virtual telescope. 
* GPL license (open-source). 
* Simple to install. 
* Very simple to use. 


=========================================
* Requirements of the PHP SETI@home web monitor.

Requirements.
* Required: PHP 4.1.x or higher. Your web server should be able to
interpret the PHP language. It really doesn't matter the platform
(tested with GNU/Linux and Windows 2000). 
* Required: A web server. It should work with any web server running
in your workstation or server (tested with Apache in GNU/Linux, with
Apache in Windows 2000 and IIS in Windows 2000). 
* Optional: GD library (compiled in php) version 1.8 or 2.0.
Recommended: GD version 2.0. Chances are your PHP distribution
already has GD 2.0 support included. 
* Required: SETI@home client, (tested with 3.03 for Linux and 3.08
for Windows). 


=========================================
* Download the PHP SETI@home web monitor.

The current and older versions are available as a tar.gz package or
as a zip file at
http://www.mariovaldez.net/software/phpsetimon/

Also you can find ther the Readme (readme.txt), Changelog
(version.txt), checksums (checksums.txt) and license (license.txt)
files.
 

=========================================
* Installation of the PHP SETI@home web monitor.

Installation.
1) Get the files.
Get the files from 
http://www.mariovaldez.net/software/phpsetimon/ or
http://www.medicumdoctum.com/archivos/phpsetimon/ 
(There are zip and tar.gz files available).

2) Unpack.
Extract the files in a web server directory. That will create a
"phpsetimon" directory with several files and directories inside. (Be
sure to unpack preserving the directory structure).

3) Change ownership.
Change the ownership of those files and the directory "phpsetimon" to
the user used by your web server (usually "nobody" in Unix/Linux).
To change the ownership in Linux/Unix, you execute in a shell
terminal in the server the command chown:

chown -h -R nobody:nobody phpsetimon/

In Windows environments, using the Windows Explorer, check the
Security tab of the Properties dialog of the directory, and set the
permissions so that the user IUSR_servername has permissions to read
and write on the "phpsetimon" directory. 

4) Locate your SETI files.
Locate the working files of your seti@home software (state.sah,
user_info.sah, work_unit.sah, result.sah).

5) Configure.
Edit the seticlients.inc.php file, defining how many clients you want
to monitor in the variable ps_seti_instances. Then define the
location (directory) of the *.sah files of your SETI client in
ps_homedir[1] for the first client, ps_homedir[2] for the second, and
so on. For each client directory you need to define a name used to
navigate the result page in ps_homename[1] for the first client,
ps_homename[2] for the second, and so on.
For each client you need to define if it is local (in the same
computer than the web server) or remote (in other computer, accessed
via a mounted directory) in ps_homeislocal[1] for the first client,
ps_homeislocal[2] for the second, and so on.

Also edit the config.inc.php file to define:
* ps_cfg_truecolor. If you are using a GD graphics library 2.0.x or
higher (which support truecolor processing) set this to true. 
* ps_cfg_useproxy, ps_cfg_proxyaddress, ps_cfg_proxyport. If the web
server is behind a http proxy, set the parameters here. 
* ps_cfg_cangetpid. If you are using a non-Unix local client (if the
web server is in a non-Unix host) set this to false. If you are using
Windows 2000 and have installed the Support Tools (included in the
installation CD), you can enable this option. 
* ps_cfg_ignorepidfile. If you are using a local client that don't
create pid.sah files (like the Windows graphical clients), set this
to true. 

6) Test.
Try to open the seti.php file from your the browser thru the web
server.

7) If you are upgrading.
If you are upograding from a version older than 0.1.0b7 then move the
following files:
xxxx_history.txt files to the history directory. 
xxxx_skymap.png files to the maps directory. 
xxxx_zoom.png files to the zooms directory. 
xxxx_skyview.gif files to the skyview directory. 

8) You are done.


=========================================
* Questions, comments, suggestions.

Don't hesitate to contact me by email (mario@mariovaldez.org).


=========================================
* The skymap.

The two flat skymaps included by the PHP SETI@home web monitor are
rectangular projections generated by the StarChart software for
GNU/Linux. (You don't need to install the StarChart software to use
the PHP SETI@home web monitor). 

For the old skymap we generated four rectagular projections looking
at 0, 6, 12 and 18 hrs RA (Right Ascension), 0 deg Dec (Declination)
with a scale of 120 deg. Then we merged the images and added some
extra lines manually (the grid and scales) with an image processing
application. The resulting skymap ranges 24 hours RA and from +70 to
- - -70 degrees declination.

For the newer skymap we generated eight rectangular projections
looking at 0, 3, 6, 9, 12, 15, 18 and 21 hrs RA, 0 deg Dec with a
scale of 80 deg. Then we merged the images and added some extra lines
manually (the grid and scales) with an image processing application.
The resulting skymap ranges 24 hours RA and from +40 to -40 degrees
declination, which is enough for the SETI@home as the Arecibo
Observatory can only scan from +38 degrees to -2 degrees Dec. 

Please note that the images downloaded from NASA's SkyView virtual
telescope are rendered from copyrighted material by the dataset
owners. By default, the PHP SETI@home web monitor requests images
from the Digitized Sky Survey 1 which copyright note is as follow
(according to SkyView):

The Space Telescope Science Institute (AURA Inc) asserts a copyright
on these data which forbids the general distribution of the southern
data prior to June 1995 and the northern data prior to February 1996.
The original survey data is copyright ROE, the UK-PPARC (Particle
Physics and Astronomy Research Council, the successor to the Science
and Engineering Research Council), the AAO, CalTech and the National
Geographic Society. 

Alse note that by downloading images from the SkyView site you are
bound to their privacy statement, disclaimer and security terms. 
 


If you are only interested in the skymaps, you can get them at
http://www.mariovaldez.net/software/phpsetimon/ , including
the source PNG files (which are covered by the GPL license).




-----BEGIN PGP SIGNATURE-----
Version: PGP 8.0

iQCVAwUBQGrI6TpHuYe8JiHtAQHPbwQA0BsYSRWj+6/y/wKZvWPFQUb+yT6fJeFD
GWfmvRFd3R4Cb2znq8qjg7scZa6XfCsDfANdF8xTkNKPPl6mD0yGdFuooCF2rhcB
vOHpDxvCNdaYejuVyXPdLqSy/aVxznBZLcVgGw/9dL155T568y9hd6ExNFwfDMDB
RUUWqKJPYiM=
=zug1
-----END PGP SIGNATURE-----