This is STAMOS 0.5.

The latest release is available at:

	http://www.theknuddel.de/index_en.html
	
STAMOS was written by Knut Grahlmann <Knut.Grahlmann@web.de> and is copyrighted
under the terms of the GPL (see LICENSE for further information).


!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
IMPORTANT CHANGES FROM 0.41 to 0.5
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

1) The format of the conf-file changed a bit:
   -I took out the OS and OS_version      options.
   -I replaced CPU by CPU1, CPU2, CPU3 and CPU4.
2) There's a new word in the languages files: mounted on.




INSTALL:

1) In order to run this program, you need the uptimed utilities from
   http://capsi.com/linux-uptimed.shtml. For installation instructions on these,    see its INSTALL file.

2) When you got all that stuff running (it's really easy, believe me) installed,    you have two choices:
   a) You leave all STAMOS files in the folder it came in and only move this    
      folder somewhere "safe" (like /opt), or
   b) You copy the stamos file into a folder that is in PATH.
   
   I rather have my programs in their own folders, it's easier to update and
   less confusing.

3) Make sure that STAMOS is executable.

4) Also make sure that you have write access to the folder/file you are going to
   specify as your output file.

5) If you want, you can copy sample.conf to /etc/stamos.conf. (Makes life easier
   because you don't have to specify all parameters everytime you start STAMOS.)

6) Adapt the configuration file to your needs.

7) Since STAMOS' main purpose is to display the current uptime of a server, it
   wouldn't be very sensefull to start STAMOS by hand.
   I propose to let it run as a cron job every five (?) minutes.
   (snip ----/etc/crontab----
   */5 * * * * root /root/scripts/stamos (options)
   ---- snap)
   
   (For information about crontab refer to 'man crontab' and 'man 5 crontab'.)


HISTORY:

STAMOS stands for "Some Things About My Own Server".

At the time I started writing STAMOS, I had my own web server and I wanted to tell the world what a sweet (and especially STABLE) machine "yoda" was.

So I needed a way to put information about the current uptime in an HTML-file.
One could just use the output of "uptime" but that only has the current uptime and also no information about the start time etc.

However, one day, a thread about uptimes in suse-linux@suse.com let me find "uptimed" and "Ud":
Uptimed keeps track of your uptimes and makes a "file of fame".
Ud produces HTML, but here is what Rob Kaper (the author of uptimed) has to say
about Ud:
"Uptimed was inspired by Ud, a similar program. Ud has way more features,
but I didn't like how it was using pid files. Uptimed instead looks at the
boottime from /proc/stat to see whether a current uptime is actually the
same session as one in the log file."

I also do not use Ud, because I never had a chance to look at it, since its site was (and is still [04/05/1999]) somehow down.

While I wrote the original program that just displayed the uptime, I got the idea to include some more more stuff like information about the CPU, RAM etc..
And here it is...


USE:

STAMOS needs, in order to run, at least two commandline parameters, --uptimed and --output (for explanation see below). Without these two, it will refuse to work.

list of options:

mandatory options:
--output      the name and the path of the file where STAMOS should write to
--uptimed     the directory with the uprecords program in it

non-mandatory options:
--config	specifies the name and path of a config file and overrides the
                standard /etc/stamos.conf

--help         	displays a help screen
--language      lets you specify the path of a "language-file"
                see section LANGUAGE SUPPORT

--overwrite    	In case the output file exists, it is overwritten.
--quiet        	STAMOS produces (unless there are errors) NO screen output.
--verbose      	Makes STAMOS a bit more talkative during the creation of the
               	output file.


CONFIGURATION FILE:

See sample.conf for more information on the configuration file.

I propose to copy it to /etc/stamos.conf and adapt it there to your needs; in case something goes wrong with it, you still have an "original".


LANGUAGE SUPPORT:

From version 0.4 on, you can modify the language used in the output file.
In order to so, you need the language file of the language you want to use.
(If there is none that comes with the package, try to find one one my homepage.
If there is still none to find, why don't you write it yourself!? :-)
 see sample_lang for that)
Now, just start STAMOS like this: ./stamos --language=/path/to/that/file
or edit the configuration file.


TODO:

see TODO


CREDITS:

see CREDITS



Knut Grahlmann <Knut.Grahlmann@web.de> 12/29/2001
