SCROLLKEEPER-UPDATE(8) SCROLLKEEPER-UPDATE(8)
NAME
scrollkeeper-update - identify new, modified, or removed OMF files and update the
scrollkeeper databases
SYNOPSIS
scrollkeeper-update [ -v ] [ -q ] [ -n ] [ -p database-directory ] [ -o omf-direc-
tories ]
DESCRIPTION
This synchronizes the scrollkeeper database with the OMF directory. It searches
the scrollkeeper OMF directory to identify if any files were added, removed, or
modified and updates its internal database files to reflect any changes.
This utility is generally executed as the last step of installation, after the OMF
file is copied into place. It is also typically the last step of uninstallation,
after the OMF file is removed. Using this, an administrator can easily manually
install and uninstall documents into the database. It can also be run to guarantee
the database is fully up-to-date.
Note that because scrollkeeper-update is normally run during installation and its
output is typically seen by users, non-critical warnings and errors such as those
caused by invalid metadata are written to the log file instead of to the terminal.
Developers should use the log file to identify any problems.
OPTIONS
-v Be verbose: Say which scrollkeeper-install and scrollkeeper-uninstall com-
mands are being run to bring the database up to date.
-q Run in quiet mode, suppressing output of all but the most serious warning
and error messages to STDOUT. Note that most output to the log file will be
unchanged.
-n Use the network to retrieve the DTD if it is not available via the system's
XML catalog.
-p database-directory
Use database-directory as the directory for the scrollkeeper database rather
than the usual one obtained by running scrollkeeper-config --pkglocalstate-
dir.
-o omf-directories
Examine the directories named in omf-directories rather than the one usual
one obtained by running scrollkeeper-config --omfdir (or specified in the
OMF_DIR environment variable if set). The omf-directories should be a
colon-separated list of directories.
ENVIRONMENT
OMF_DIR
If no -o option is specified, this variable overrides the scrollkeeper-con-
fig-provided OMF directory. It should be a colon-separated list of directo-
ries.
FILES
/var/lib/scrollkeeper/scrollkeeper_docs
/var/lib/scrollkeeper/TOC/<docnumber>
/var/lib/scrollkeeper/<locale>/scrollkeeper_cl.xml
/var/lib/scrollkeeper/<locale>/scrollkeeper_extended_cl.xml
/var/log/scrollkeeper.log
AUTHOR
Laszlo Kovacs <laszlo.kovacs AT sun.com>
Dan Mueth <d-mueth AT uchicago.edu>
SEE ALSO
scrollkeeper-config(1), scrollkeeper-gen-seriesid(1), scrollkeeper.conf(5), scroll-
keeper(7), scrollkeeper-preinstall(8), scrollkeeper-rebuilddb(8)
scrollkeeper Dec 5, 2001 SCROLLKEEPER-UPDATE(8)
Generated by $Id: phpMan.php,v 4.49 2006/02/26 13:18:18 chedong Exp $ Author: Che Dong
On Apache/1.3.37 (Unix) mod_throttle/3.1.2 FrontPage/5.0.2.2635 mod_psoft_traffic/0.2 mod_ssl/2.8.28 OpenSSL/0.9.8b
Under GNU General Public License
2009-01-07 21:07 @38.103.63.55 Crawled by CCBot/1.0 (+http://www.commoncrawl.org/bot.html)