1MOD-ACTIVE(8)               System Manager's Manual              MOD-ACTIVE(8)
2
3
4

NAME

6       mod-active - batch processing of ctlinnd newgroup/rmgroup/changegroup
7

SYNOPSIS

9       mod-active [ ctlinnd_command_file ]
10

DESCRIPTION

12       mod-active  is  a perl script that updates the active file based on its
13       input lines of ctlinnd newgroup, rmgroup and changegroup commands.   It
14       pauses  the  server  briefly while the existing active file is read and
15       rewritten, which not only keeps innd from updating the active file  but
16       also locks against other instances of mod-active.
17
18       The input to mod-active can come either from one or more files named on
19       the command line, or from the standard input.  Typically its  input  is
20       the  output  from  the  docheckgroups  or actsync commands.  Every line
21       which contains the string "ctlinnd  newgroup",  "ctlinnd  rmgroup",  or
22       "ctlinnd  changegroup",  optionally  preceded  by whitespace and/or the
23       path to ctlinnd, is noted for the update.  Redundant commands, such  as
24       a  newgroup  directive  for  a  group that already exists, are silently
25       ignored.  All other lines in the input are also silently ignored.
26
27       After the new active file has  been  generated,  the  existing  one  is
28       renamed  to active.old and the new one is moved into place.  The script
29       then displays the differences between the two files.
30
31       Any groups that were added to the active file are  also  added  to  the
32       active.times file with the string "checkgroups-update".
33

BUGS

35       Though  innd  is paused while mod-active works, it is not inconceivable
36       that there could be a conflict if something else tries  to  update  the
37       active  file  during the relatively short time that mod-active is work‐
38       ing.  The two most realistic ways I can think of for this to happen are
39       either by an administrator concurrently doing a manual ctlinnd command,
40       or by innd receiving a control message,  then  mod-active  pausing  the
41       server,  then  the control message handler script that innd forked run‐
42       ning its own ctlinnd command while mod-active is  working.   I've  been
43       using  mod-active  regularly  for  several years, though, and never had
44       either problem.
45

HISTORY

47       Written by David C Lawrence <tale@isc.org>.
48

SEE ALSO

50       active(5), active.times(5), actsync(8), ctlinnd(8), innd(8).
51
52
53
54                                                                 MOD-ACTIVE(8)
Impressum