Skip to Content
Browse documentation

setupdns — Command Reference

Install BIND, rebuild DNS configuration or regenerate the local RNDC key.

Install BIND, rebuild DNS configuration or regenerate the local RNDC key.

Requirements

Run as root on the Eenos server. Configured DNS role, supported repositories and an existing zone/configuration backup. Only bind is accepted as --flavor.

Usage

The following example uses the operation described below; replace example identities and paths before use:

/usr/local/eenos/scripts/setupdns --rebuildconf

Arguments and options

Argument / optionUsage and meaning
-i, --installFlag. Install the DNS server and rebuild its configuration.
-r, --rebuildconfFlag. Rebuild the DNS server configuration.
-k, --rebuildrndckeyFlag. Rebuild the local RNDC key, restart BIND and verify RNDC access.
-f, --flavorValue: FLAVOR. Choices: bind. Parser default: bind. DNS server flavor (default: bind).

-h, --help displays this parser's help. Selectors in the same mutually exclusive group cannot be combined. The installed version remains authoritative for available options.

Operational effects

Installation/rebuild changes DNS service configuration. RNDC-key regeneration restarts BIND and verifies local RNDC access.

Verify the result

Check BIND startup, RNDC communication and authoritative answers.

Check operation output and the relevant service/application state. Several legacy wrappers exit successfully after logging a handler failure, so a zero shell exit status alone is not proof of completion.

Back to Service Setup · All command-line tools