Dtrealms

From DNSSEC-Tools
Jump to: navigation, search
{{#if:1| {{#if:| {{#if:1| {{#if:1| {{#if:| {{#if:|
DNSSEC-Tools Component
dtrealms
This describes dtrealms, which in the Authoritative Server Tools category within the DNSSEC-Tools Components framework of tools.
Tool Name: dtrealms
Tool Type: Authoritative Server Tools
Manual: Manual

}}

Example: Example

}}

CLI: Help

}}

Tutorial: Tutorial

}}

How To: How To

}}

Download: dtrealms

}}

About

dtrealms manages multiple distinct DNSSEC-Tools rollover environments running simultaneously. Each rollover environment, called a realm, is defined in a realms file. dtrealms uses this file to determine how the rollover environment must be initialized such that it can run independently of the other rollover environments on a particular system. This is useful for such things as managing very large collections of zones, segregating customer zones, and software tests.

The realms file may be created with the realminit command. Currently, the distinct environment for each realm must be created manually. It is hoped that a tool will soon be available to assist with creating each realm's environment.

dtrealms isn't necessary for running multiple realms. However, it does make it easier to manage any number of realms running consecutively and in their own environment.

The realmctl command can be used to communicate with a running dtrealms daemon.

Example of a dtrealms Log File

Below is a dtrealms log file. This was created with an "info" log level. This log file shows two realms, example and test. After starting these realms, the grandvizier graphic display tool is started to monitor the realms' execution.

Mar 20 15:39:45 2012: dtrealms starting ----------------------------------------
Mar 20 15:39:45 2012: dtrealms parameters:
Mar 20 15:39:45 2012:      realm file    "testing.realm"
Mar 20 15:39:45 2012:      directory       "."
Mar 20 15:39:45 2012:      config file     "/usr/local/etc/dnssec-tools/dnssec-tools.conf"
Mar 20 15:39:45 2012:      logfile         "log.dtrealms"
Mar 20 15:39:45 2012:      loglevel        "4"
Mar 20 15:39:45 2012:      logtz           "gmt"
Mar 20 15:39:45 2012:      running as      "realms-manager"
Mar 20 15:39:45 2012:  
Mar 20 15:39:45 2012: creating realms list
Mar 20 15:39:45 2012: adding realm "example" to list
Mar 20 15:39:45 2012: adding realm "test" to list
Mar 20 15:39:45 2012: starting realms
Mar 20 15:39:45 2012: test: realm definition is valid
Mar 20 15:39:45 2012: test: starting realm "rollerd -foreground -sleep 30 -loglevel tmi -logfile log.test -rrf /dnssec/realms/r-test/demo-test.rollrec"
Mar 20 15:39:45 2012: example: realm definition is valid
Mar 20 15:39:45 2012: example: starting realm "rollerd -foreground -sleep 60 -loglevel phase -logfile log.example -display -rrf /dnssec/realms/r-example/demo-example.rollrec"
Mar 20 15:39:45 2012: starting grandvizier