Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

lights(1p) [debian man page]

LIGHTS(1p)						User Contributed Perl Documentation						LIGHTS(1p)

lights - DNSSEC-Tools Rollover Overview GUI Display SYNOPSIS
lights [options] DESCRIPTION
lights gives a very simple overview of the rollover status of a set of zones. The rollover status counts are given in a "traffic light" display. In contrast, blinkenlights gives a detailed display of the roll status of a set of zones. lights gives very little control over rollerd, the way blinkenlights does. lights can halt rollerd's execution only. The rollover status is retrieved in one of two ways. By default, rollerd is contacted via the rollctl command. Alternately, if the -rrf option is given, then zone status is read directly from a rollrec file. The default method gets the status directly from rollerd and the user need not know the location of the relevant rollrec file. However, that method will not get zone status until rollerd is available to respond to the information request. Consequently, the alternate method allows lights to bypass communicating with rollerd and not having to wait for rollerd to be available. A window is created that has three colored sections - green, yellow, and red. The green section displays a count of those zones that are in "normal" status; that is, they are not in rollover. The yellow section displays a count of those zones that are in rollover. The red section displays a count of those zones that are in need of attention. A common cause for this last state is because a zone is in phase 6 of KSK rollover and is waiting for its parent zone to publish the child's new DS record. Clicking on the color rows in the main window will bring up a dialog box that lists the zones in that state. This list will not automatically update as zones change rollover state. OPTIONS
lights supports the following options. -interval wait-time Interval between checks of zone rollover status By default, wait-time is given in minutes. This can be adjusted by specifying one of the following time-unit suffixes. * s - seconds * m - minutes * h - hours Examples: * -interval 24 - 24 minutes * -interval 24s - 24 seconds * -interval 24m - 24 minutes * -interval 24h - 24 hours -rrf rollrec-file A rollrec file to be read for zone status. -labels Labels will be given for each color field in the GUI. -verbose Give verbose output. -help Give a usage message and exit. -Version Displays the version information for lights and the DNSSEC-Tools package. REQUIREMENTS
lights is implemented in Perl/Tk, so both Perl and Perl/Tk must be installed on your system. KNOWN ISSUES
The following are known issues. These will be resolved in the fullness of time. o Resizing the window leaves the color blobs in their original size. This is an issue with the Tk widget used to display the color stripes. Other display methods are being investigated... COPYRIGHT
Copyright 2010-2012 SPARTA, Inc. All rights reserved. See the COPYING file included with the DNSSEC-Tools package for details. AUTHOR
Wayne Morrison, SEE ALSO
blinkenlights(8), bubbles(8), rollerd(8), rollrec(5) perl v5.14.2 2012-06-21 LIGHTS(1p)

Check Out this Related Man Page

LSDNSSEC(1p)						User Contributed Perl Documentation					      LSDNSSEC(1p)

lsdnssec - List DNSSEC components of zones from files or directories SYNOPSIS
The lsdnssec program summarizes information about DNSSEC-related files. These files may be specified on the command line or found in directories that were given on the command line. The -d flag controls the amount of detail in the lsdnssec output. lsdnssec displays the following information about each zone for which it collects information: keys Key information is shown about the keys currently in use. A bar graph is included that shows the age of the key with respect to the configured expected key lifetime. This information is collected from any .krf files lsdnssec finds. rolling status If any zone keys are being rolled via rollerd, then the status of the rolling state is shown. The time needed to reach the next state is also displayed. This information is collected from any .rollrec or .rrf files found by lsdnssec. OPTIONS
-z ZONENAME1[,ZONENAME2] --zone=ZONENAME1[,ZONENAME2] Only prints information about the named zone(s). -p NUMBER --phase=NUMBER Only prints information about zones currently being rolled by rollerd and where either a zsk or a ksk rollover is taking place and is in phase NUMBER. If the phase NUMBER is specified as 0, then any zone in any rolling phase will be printed (but not zones that aren't being rolled at all). This flag is especially useful to find all of your zones that are currently in KSK rolling phase 6, which requires operator intervention to propagate the new DS records into the parent zone. -r --roll-status Show only rolling information from the rollrec files. By default both roll-state and key information is shown. -k --key-data Show only keying information from the krf files. By default both roll-state and key information is shown. -K --key-gen-time Normally rollerd calculates the age of a key based on the last time a key was rolled. However, it's also possible to calculate the age of a key based on the difference between the time of execution and when the key was created (which was typically before the rolling began). The -K flag switches to this second mode of key age calculation (which will not match how rollerd actually performs). -M --monitor The -M flag gives an abbreviated version of lsdnssec output that is intended for use by monitoring systems. It displays the zone name, the rollover phase, and the time remaining in that phase. This option implicitly sets the -r flag on and sets the detail level to 1. -d 1-9 --detail 1-9 Controls the amount of information shown in the output. A level of 9 shows everything; a level of 1 shows a minimal amount. The default level is 5. --debug Turns on extra debugging information. COPYRIGHT
Copyright 2009-2012 SPARTA, Inc. All rights reserved. See the COPYING file included with the DNSSEC-Tools package for details. AUTHOR
Wes Hardaker <hardaker AT AT AT> SEE ALSO
lskrf(1) zonesigner(8), rollerd(8) perl v5.14.2 2012-06-21 LSDNSSEC(1p)
Man Page

Featured Tech Videos