lights(1)

1LIGHTS(1)             User Contributed Perl Documentation            LIGHTS(1)
2
3
4

NAME

6       lights - DNSSEC-Tools Rollover Overview GUI Display
7

SYNOPSIS

9         lights [options]
10

DESCRIPTION

12       lights gives a very simple overview of the rollover status of a set of
13       zones.  The rollover status counts are given in a "traffic light"
14       display.  In contrast, blinkenlights gives a detailed display of the
15       roll status of a set of zones.  lights gives very little control over
16       rollerd, the way blinkenlights does.  lights can halt rollerd's
17       execution only.
18
19       The rollover status is retrieved in one of two ways.  By default,
20       rollerd is contacted via the rollctl command.  Alternately, if the -rrf
21       option is given, then zone status is read directly from a rollrec file.
22       The default method gets the status directly from rollerd and the user
23       need not know the location of the relevant rollrec file.  However, that
24       method will not get zone status until rollerd is available to respond
25       to the information request.  Consequently, the alternate method allows
26       lights to bypass communicating with rollerd and not having to wait for
27       rollerd to be available.
28
29       A window is created that has three colored sections - green, yellow,
30       and red.  The green section displays a count of those zones that are in
31       "normal" status; that is, they are not in rollover.  The yellow section
32       displays a count of those zones that are in rollover.  The red section
33       displays a count of those zones that are in need of attention.  A
34       common cause for this last state is because a zone is in phase 5 of KSK
35       rollover and is waiting for its parent zone to publish the child's new
36       DS record.
37
38       Clicking on the color rows in the main window will bring up a dialog
39       box that lists the zones in that state.  This list will not
40       automatically update as zones change rollover state.
41

OPTIONS

43       lights supports the following options.
44
45       -interval wait-time
46           Interval between checks of zone rollover status  By default, wait-
47           time is given in minutes.  This can be adjusted by specifying one
48           of the following time-unit suffixes.
49
50           * s - seconds
51
52           * m - minutes
53
54           * h - hours
55
56           Examples:
57
58           * -interval 24 - 24 minutes
59
60           * -interval 24s - 24 seconds
61
62           * -interval 24m - 24 minutes
63
64           * -interval 24h - 24 hours
65
66       -rrf rollrec-file
67           A rollrec file to be read for zone status.
68
69       -labels
70           Labels will be given for each color field in the GUI.
71
72       -verbose
73           Give verbose output.
74
75       -help
76           Give a usage message and exit.
77
78       -Version
79           Displays the version information for lights and the DNSSEC-Tools
80           package.
81

REQUIREMENTS

83       lights is implemented in Perl/Tk, so both Perl and Perl/Tk must be
84       installed on your system.
85

KNOWN ISSUES

87       The following are known issues.  These will be resolved in the fullness
88       of time.
89
90       •   Resizing the window leaves the color blobs in their original size.
91           This is an issue with the Tk widget used to display the color
92           stripes.  Other display methods are being investigated...
93

COPYRIGHT

95       Copyright 2010-2014 SPARTA, Inc.  All rights reserved.  See the COPYING
96       file included with the DNSSEC-Tools package for details.
97

AUTHOR

99       Wayne Morrison, tewok@tislabs.com
100