ovdb_upgrade(8) InterNetNews Documentation ovdb_upgrade(8)NAME
ovdb_upgrade - Perform any needed upgrades on the ovdb database
SYNOPSYS
ovdb_upgrade
DESCRIPTION
The ovdb_upgrade command is be used to upgrade the ovdb database when migrating to a newer version of the BerkeleyDB library (in which
there is a change in BerkeleyDB's internal db format).
The upgrade is done in-place, and is not reversable.
Here is an example procedure to upgrade a database created with BerkeleyDB 2.x to use BerkeleyDB 3.x:
1 Install BerkeleyDB 3.x
2 Do a `make clean' in the INN source tree
3 If BerkeleyDB 3.x is installed into a different path than the 2.x version, run configure again, specifying the new path. For example:
`./configure --with-berkeleydb=/usr/local/BerkeleyDB.3.x [... other options]'
4 Shut down INN (e.g., with `rc.news stop'). Be sure to kill all nnrpds as well.
5 Do a `make update' to build INN with the new BerkeleyDB version and install the new binaries.
6 Run `ovdb_upgrade' as the news user.
7 Start INN with `rc.news'
HISTORY
Written by Heath Kehoe <hakehoe@avalon.net> for InterNetNews.
SEE ALSO ovdb(5)3rd Berkeley Distribution INN 2.3 ovdb_upgrade(8)
Check Out this Related Man Page
RC.NEWS(8) InterNetNews Documentation RC.NEWS(8)NAME
rc.news - Start or stop INN daemons
SYNOPSIS
rc.news [start | stop]
DESCRIPTION
rc.news can be used to start or stop innd and supporting programs. It checks to make sure INN is not already running, handles cases of
unclean shutdown, finishes up tasks which might have been interrupted by the preceding shutdown, e-mails certain boot-time warnings to
newsmaster (as set in inn.conf), and is generally safer and easier than starting and stopping everything directly. It needs to be run as
the news user so that files in pathrun are created with the right ownership (though this is less important for "rc.news stop").
Programs run and stopped by this script include:
o Always: innd is started or stopped.
o If doinnwatch is true in inn.conf: innwatch is started and stopped.
o If docnfsstat is true in inn.conf: cnfsstat is started and stopped.
o If ovmethod is set to "ovdb" in inn.conf: ovdb_init is run; ovdb_server and ovdb_monitor are stopped.
o If rc.news.local exists in pathbin: rc.news.local is run with argument "start" or "stop" (to perform site-specific startup or shutdown
tasks).
OPTIONS
"start"
If the first argument is "start", or no first argument is given, rc.news initiates INN startup.
"stop"
If the first argument is "stop", rc.news initiates INN shutdown. It is recommended to throttle the server first as described in
ctlinnd(8).
EXAMPLES
To start INN and leave certain error messages going to the terminal:
su - news -c <pathbin in inn.conf>/rc.news
To run INN at startup time from appropriate system boot scripts:
su - news -c <pathbin>/rc.news >/dev/console
To stop INN (throttling first):
<pathbin>/ctlinnd throttle reason
su - news -c '<pathbin>/rc.news stop'
BUGS
Running "rc.news start" as root is never the right thing to do, so we should at minimum check for this and error, or perhaps change
effective user ID.
HISTORY
// FIXME: any attribution for rc.news itself?
This manual page written by Jeffrey M. Vinocur <jeff@litech.org> for InterNetNews.
$Id: rc.news.pod 9340 2011-08-16 13:50:19Z iulius $
SEE ALSO ctlinnd(8), cnfsstat(8), inn.conf(5), innwatch(8), ovdb(5).
INN 2.5.3 2011-08-22 RC.NEWS(8)