Menu

Tree [cce044] master /
 History

HTTPS access


File Date Author Commit
 doc 2009-06-28 R. Bernstein R. Bernstein [13e876] Adminstrivia: .gitignore
 home-page 2008-03-09 rockyb rockyb [b24983] Historical artifact
 sample 2005-07-26 rockyb rockyb [9ea569] Fix some typographical mistakes and correct the...
 test 2012-09-06 r r [91f3e7] Small changes
 .cvsignore 2004-10-16 rockyb rockyb [fe4e2c] config.status is created or a temporary file of...
 .gitignore 2009-06-28 R. Bernstein R. Bernstein [13e876] Adminstrivia: .gitignore
 AUTHORS 2006-02-25 rockyb rockyb [2db01f] - post-configure.in: It's probably time we now ...
 COPYING 2008-07-03 rockyb rockyb [d02561] Wasn't parsing --fast in fs-report. Get ready f...
 Makefile.PL 2004-02-25 rockyb rockyb [6ed0b6] Initial revision
 Makefile.am 2008-07-03 rockyb rockyb [114095] Appease automake god.
 NEWS 2008-07-03 rockyb rockyb [d50d63] One more typo.
 README 2004-10-20 rockyb rockyb [601f7c] Update Overview: Revise to include ilimit and e...
 THANKS 2008-07-03 rockyb rockyb [d02561] Wasn't parsing --fast in fs-report. Get ready f...
 autogen.sh 2004-02-25 rockyb rockyb [9a0841] Create dummy ChangeLog. Enable --maintainer-mod...
 configure.ac 2012-09-06 r r [f2652c] Add ext4
 cvs2cl_header 2004-02-25 rockyb rockyb [15ed9d] Auxiliary files for cvs2cl.
 cvs2cl_usermap 2006-02-27 rockyb rockyb [cf3557] Use cpan address.
 fs-check.in.in 2013-11-27 R. Bernstein R. Bernstein [cce044] We don't have SUBOWNER yet
 fs-report.in 2008-07-03 rockyb rockyb [d02561] Wasn't parsing --fast in fs-report. Get ready f...
 post-configure.in 2006-05-13 rockyb rockyb [ac353f] minor changes

Read Me

----------------------
OVERVIEW
----------------------

fs-check checks filesystem sizes to see if they are getting too
full. It uses a configuration file that specifies the filesystems to
check, email contacts, trigger thresholds (percentage or amount
used/unused), and a report program to run. It includes fs-report,
which shows things like the largest files, the newest files, and core
files. It can be run from cron or as a daemon.

More detail...

Lines in the configuration that fs-check reads file might look like this:

# This is who gets mail when something's wrong and no further specification
default owner  sysadmin@breakaway.com 90%

# This is the program to run when no other program is specified...
default action /usr/local/bin/fs-report

# Let filesystems get to 90% full before complaining
default limit 90%

# But let i-nodes go to 98% ...
default ilimit 98%

limit   /oracle 70%
owner   /oracle  dba@breakaway.com
action  /oracle /var/adm/bin/run_special_oracle_report_program
exclude_pat ^/cdrom

More detail on fs-check and fs-report can be found in the manual pages.

----------------------
INSTALLATION
----------------------

** 0. Copy tarfile ***

Download. If you are reading this chances are you've done that.

** 1. Untar ***

Once you have this, untar the distribution gzipped tar file. If you
have GNU tar you run something like this:

  tar -zxvpf fs-check-version.tar.gz

What's this with that the "z" on tar? GNU tar will uncompress while
untar'ing. If you don't have GNU tar but have GNU zip: 

gzcat fs-check-version.tar.gz | tar -xvpf -

*** 2. Configure, make and test ****

Now run:

  ./configure

If that you don't get any error messages, great! You can see what you 
can "configure" by giving the --help option, i.e.

  ./configure --help

Next try making the documentation:

  make

If you get an error about "pod2man not found", it is not a big loss if
you don't care about documentation.

Something I like to do, but I guess it's optional is running the
regression tests: 

  make check.

Finally install. Depending on the permissions you have on filesystems
and this has been configured to get installed (to change the default
locationsee --prefix on configure), you might have to be root.

  make install


If you want to do all in one line:

  ./configure && make && make check && make install

Or to live dangerously:

  ./configure && su -c make install


*** 2. Add Crontab line ****

Even though fs-check runs as a daemon, it is often run from cron. 

You might add a like this to your crontab:

#
# File system checker....
#
5 * * * * /usr/local/bin/fs-check.pl -1 --config /var/adm/fs-check.cnf

----------------------
TEST
----------------------

*** 3. Review configuration *** 

The defaults should be looked over - some servers may have
specially full disks or disks that others should be notified about

Test the program like this:

  fs-check -n -v -1 --config fs-check.cnf