RNDC

La commande Exécuter une commande RNDC (RUNRNDCCMD), ou son alias RNDC, démarre l'utilitaire Remote Name Daemon Control. Cette commande permet de contrôler un système de noms de domaine (DNS) s'exécutant sur votre système local. The Run RNDC Command (RUNRNDCCMD) command, or its alias RNDC, starts the Remote Name Daemon Control utility. This command allows you to control a Domain Name System (DNS) running on your local system.

Restrictions:

• Vous devez posséder le droit d'exécution (*X) sur les répertoires du chemin /QIBM/UserData/OS400/DNS/_DYN You must have execute (*X) authority to the directories in the path /QIBM/UserData/OS400/DNS/_DYN
• Vous devez posséder le droit de lecture (*R) sur les fichiers du répertoire /QIBM/UserData/OS400/DNS/_DYN. You must have read (*R) authority to the /QIBM/UserData/OS400/DNS/_DYN directory files.
• Vous devez posséder le droit d'exécution (*X) sur les répertoires du chemin d'accès du fichier de configuration RNDC. You must have execute (*X) authority to the directories in the path of the RNDC configuration file.
• Vous devez posséder le droit de lecture (*R) sur le fichier de configuration RNDC. You must have read (*R) authority to the RNDC configuration file.
• Vous devez posséder le droit d'exécution (*X) sur les répertoires du chemin d'accès du fichier de clés RNDC. You must have execute (*X) authority to the directories in the path of the RNDC key file.
• Vous devez posséder le droit de lecture (*R) sur le fichier de clés. You must have read (*R) authority to the key file.
• Vous devez posséder le droit d'exécution (*X) sur les répertoires du chemin d'accès du fichier de sortie. You must have execute (*X) authority to the directories in the path of the output file.
• Vous devez posséder le droit d'écriture (*W) sur le fichier de sortie s'il existe déjà. You must have write (*W) authority to the output file if it already exists.
• Vous devez posséder les droits de lecture, d'écriture et d'exécution (*RWX) sur le répertoire parent du fichier de sortie si celui-ci n'existe pas encore. You must have read, write and execute (*RWX) authority to the output file's parent directory if the output file does not already exist.

Paramètres

Commande RNDC (RNDCCMD)RNDC command (RNDCCMD)

Indique la commande de contrôle à envoyer au serveur DNS. Specifies the control command to be sent to the DNS server.

Ce paramètre est obligatoire. This is a required parameter.

valeur-caractère

Specify the control command to run. The command must be one of the following:

reload
    Reload configuration file and zones
reload zone ¬class ¬view||
    Reload a single zone
refresh zone ¬class ¬view||
    Schedule immediate maintenance for a zone
retransfer zone ¬class ¬view||
    Re-transfer a single zone from the master
sign zone ¬class ¬view||
    Sign or re-sign a zone with the new DNSKEY
    RRset if the zone's DNSKEY RRset is changed
    after merging DNSSEC keys under the key
    directory(specified by key-directory
    option in named.conf).
    This command requires that the auto-dnssec
    zone option is set to allow or maintain,
    and that the zone is configured to allow
    dynamic updates(can be configured using
    allow-update or update-policy option)
loadkeys zone ¬class ¬view||
    Merge DNSKEY keys under the key directory(
    specified by key-directory option in
    named.conf) into the zone's DNSKEY RRset.
    While unlike sign command, loadkeys does not
    immediately re-sign the zone with the new
    keys, the zone is allowed to incrementally
    re-sign over time.
    This command requires that the auto-dnssec
    zone option is set to maintain, and that
    the zone is configured to allow dynamic
    updates(can be configured using
    allow-update or update-policy option)
freeze
    Suspend updates to all dynamic zones
freeze zone ¬class ¬view||
    Suspend updates to a dynamic zone. Also
    freeze causes previous updates are
    saved to the zone file
thaw
    Enable updates to all dynamic zones and
    reload them
thaw zone ¬class ¬view||
    Enable updates to a frozen dynamic zone and
    reload it
reconfig
    Reload configuration file and new zones only
stats
    Write server statistics to the statistics file
querylog
    Toggle query logging
dumpdb ¬-all!-cache!-zones| ¬view ...|
    Dump cache(s) to the dump file (named_dump.db)
stop
    Save pending updates to master files and stop
    the server
stop -p
    Save pending updates to master files and stop
    the server reporting process id
halt
    Stop the server without saving pending updates
halt -p
    Stop the server without saving pending updates
    reporting process id
trace
    Increment debugging level by one
trace level
    Change the debugging level
notrace
    Set debugging level to 0
flush
    Flushes all of the servers caches
flush ¬view|
    Flushes the servers cache for a view
flushname name ¬view|
    Flush the given name from the servers cache(s)
status
    Display status of the server
recursing
    Dump the queries that are currently recursing
    (named.recursing)
validation ¬on!off| ¬view ...|
    Enable or disable DNSSEC validation.
    Note that dnssec-enable option also needs to
    be set to yes for DNSSEC validation

Serveur de noms de domaine (DMNNAMSVR)Domain name server (DMNNAMSVR)

Indique le nom ou l'adresse IP du serveur DNS que RNDC utilisera comme serveur courant pour la session d'interrogation. Vous pouvez indiquer n'importe quel serveur DNS auquel votre réseau TCP/IP a accès. Specifies the name or the IP address of the DNS server that RNDC will use as its current server for the query session. You can specify any DNS server to which your TCP/IP network has access.

Remarque :RNDC envoie des informations aux serveurs DNS et a besoin d'un serveur DNS actif pour envoyer ses commandes. Si vous n'indiquez pas de serveur DNS avec DMNNAMSVR au démarrage de l'outil, il tentera d'utiliser le serveur, le port et la clé par défaut définis dans le fichier rndc.conf. Il s'agit généralement de l'interface de bouclage 127.0.0.1 et du port 953. Remarque :RNDC sends information to DNS servers and it needs an active DNS server to send its commands. If you do not specify a DNS server with DMNNAMSVR when you start the tool, it will attempt to use the default server, port and key defined in the rndc.conf file. This is usually the loopback interface 127.0.0.1 and port 953.

*DFT

Utiliser le serveur DNS par défaut défini dans le fichier /QIBM/UserData/OS400/DNS/_DYN/rndc.conf. Use the default DNS server defined in the /QIBM/UserData/OS400/DNS/_DYN/rndc.conf file.

server-domain-name

Indiquez le nom d'un serveur DNS. Il s'agit d'un nom de domaine tel que 'myserver.i5os.ibm.com'. Specify the name of a DNS server. This is a domain name like 'myserver.i5os.ibm.com'.

server-internet-address

Indiquez l'adresse IP d'un serveur DNS. Specify the IP address of a DNS server.

RNDC-server-name

Indiquez le nom d'un serveur DNS du fichier rndc.conf. Il peut s'agir d'un nom tel que 'NS'. Specify the name of a DNS server in the rndc.conf file. This can be the name like 'NS'.

Port du serveur de noms de domaine (PORT)Domain name server port (PORT)

Indique le port de serveur par défaut à utiliser. Specifies the default server port to use.

953

Utiliser le port de canal de contrôle 953. Use control channel port 953.

1-65535

Indiquez un numéro de port valide. Specify a valid port number.

Fichier de configuration RNDC (RNDCCFGF)RNDC configuration file (RNDCCFGF)

Indique le fichier de configuration RNDC à utiliser pour cette session. Ce fichier contient à la fois des instructions de clé d'accès et d'options qui définissent le serveur par défaut et la clé d'accès de ce serveur. Il est possible d'utiliser RNDC pour contrôler des serveurs DNS situés sur d'autres systèmes si ce fichier de configuration contient les instructions de clé d'accès et de serveur qui s'appliquent aux serveurs distants. Specifies the RNDC configuration file to be used for this session. This file contains both access key and option statements that define the default server and the access key for that server. It is possible to use RNDC to control DNS servers located on other systems if this configuration file contains the access key and server statements that apply to the remote servers.

*DFT

Utiliser /QIBM/UserData/OS400/DNS/_DYN/rndc.conf comme fichier de configuration par défaut. Le serveur par défaut de ce fichier est 'localhost'. Use /QIBM/UserData/OS400/DNS/_DYN/rndc.conf as the default configuration file. The default server in this file is 'localhost'.

chemin-d'accès

Indiquez le chemin d'accès d'un fichier STREAM contenant les informations de configuration RNDC. Par exemple, '/home/myprofile/my-rndc-conf-file'. Specify the path name for a stream file containing RNDC configuration information. For example, '/home/myprofile/my-rndc-conf-file'.

Adresse source (SRCADR)Source address (SRCADR)

Indique l'adresse source de la connexion au serveur. Specifies the source address for the connection to the server.

*DFT

Utilise la valeur par défaut fournie par la pile. Uses the default supplied by the stack.

*ANY4

Utiliser l'adresse générique IPv4 ('0.0.0.0'). Use the IPv4 wildcard address ('0.0.0.0').

*LOOPBACK4

Utiliser l'adresse de bouclage IPv4 ('127.0.0.1'). Use the IPv4 loopback address ('127.0.0.1').

*ANY6

Utiliser l'adresse générique IPv6 ('::'). Use the IPv6 wildcard address ('::').

*LOOPBACK6

Utiliser l'adresse de bouclage IPv6 ('::1'). Use the IPv6 loopback address ('::1').

valeur-caractère

Indiquez une adresse Internet IPv4 ou IPv6 valide. Specify a valid IPv4 or IPv6 internet address.

Fichier de clés (KEYFILE)Key file (KEYFILE)

Indique le fichier de clé d'accès à utiliser pour cette session. La clé de ce fichier sera utilisée pour authentifier les commandes envoyées au serveur. Specifies the access key file to use for this session. The key in this file will be used to authenticate commands sent to the server.

*DFT

Utiliser /QIBM/UserData/OS400/DNS/_DYN/rndc.key comme fichier de clés par défaut. Use /QIBM/UserData/OS400/DNS/_DYN/rndc.key as the default key file.

chemin-d'accès

Indiquez le chemin d'accès d'un fichier STREAM contenant les informations de clé. Par exemple, '/home/myprofile/my-rndc-key-file'. Specify the path name for a stream file containing key information. For example, '/home/myprofile/my-rndc-key-file'.

Nom de clé (KEYNAME)Key name (KEYNAME)

Indique le nom de la clé d'accès à utiliser pour cette session. Ce nom de clé doit être connu du serveur utilisé pour cette session. Si aucun nom de clé n'est indiqué, RNDC utilisera les valeurs par défaut du fichier /QIBM/UserData/OS400/DNS/_DYN/rndc.conf. Specifies the access key name to be used for this session. This key name must be known by the server that is being used for this session. If no key name is specified, RNDC will use the defaults from the /QIBM/UserData/OS400/DNS/_DYN/rndc.conf file.

*DFT

Utilise le nom de clé rndc-key. Use key name rndc-key.

valeur-caractère

Specify the RNDC key name to use.

Le serveur DNS interrogé doit inclure cette clé et cet algorithme dans son fichier de configuration named.conf afin d'autoriser les clients RNDC disposant de cette clé. The DNS server being queried needs to include this key and algorithm in its named.conf configuration file in order to allow RNDC clients with this key.

Afficher les informations de débogage (DEBUG)Show debug information (DEBUG)

Indique s'il faut ou non activer le mode de débogage. Lorsque le mode de débogage est activé, davantage d'informations sont affichées sur le paquet envoyé au serveur et sur la réponse obtenue. Specifies whether or not to turn debugging mode on. More information is displayed about the packet sent to the server and the resulting answer when debugging mode is on.

*NO

Désactivez les messages de débogage. Turn off debugging messages.

*YES

Activez les messages de débogage. Turn on debugging messages.

Fichier de sortie (TOSTMF)Output file (TOSTMF)

Indique le nom d'un fichier STREAM dans lequel toute la sortie de la commande est écrite. Specifies the name of a stream file where all command output is written.

*STDOUT

Toute la sortie de la commande est dirigée vers l'unité de sortie standard (normalement l'écran). All command output goes to the standard output device (normally the display).

chemin-d'accès

Indiquez le chemin d'accès d'un fichier STREAM dans lequel la sortie doit être écrite. Specify the path name for a stream file where output should be written.

Exemples

Exemple 1 : Rechargement de toute la configuration du serveur DNS et des zones statiques Example 1: Reload All DNS Server Configuration and Static Zones

RUNRNDCCMD   RNDCCMD('reload')

Cette commande illustre un simple rechargement de toutes les modifications de la configuration d'un serveur DNS et des zones statiques. This command illustrates a simple reload of any changes to a DNS server configuration and any static zones.

La sortie de ce type de requête peut se présenter comme suit : The output from this type of query might look like this:

server reload successful

De même, si votre clé RNDC du fichier rndc.conf n'est pas valide, la sortie de ce type de requête peut se présenter ainsi : Similarly, if your RNDC key from the rndc.conf file is not valid, the output from this type of query might look like this:

rndc: connection to remote host closed
This may indicate that
* the remote server is using an older version of the
  command protocol,
* this host is not authorized to connect,
* the clocks are not syncronized, or
* the key is invalid.

Exemple 2 : Rechargement d'une seule zone Example 2: Reload a Single Zone

RUNRNDCCMD  RNDCCMD('reload i5os.ibm.com')

Cette commande illustre un simple rechargement d'une seule zone statique appelée 'i5os.ibm.com'. This command illustrates a simple reload of a single static zone called 'i5os.ibm.com'.

La sortie de ce type de requête peut se présenter comme suit : The output from this type of query might look like this:

zone reload up-to-date

Si la zone n'est pas une zone statique, la sortie de ce type de requête peut se présenter ainsi : If the zone is not a static zone, the output from this type of query might look like this:

rndc: 'reload i5os.ibm.com' failed: dynamic zone

Exemple 3 : Vidage du cache Example 3: Dumping the Cache

RUNRNDCCMD   RNDCCMD('dumpdb -cache')

Cette commande illustre comment vider le cache actif du serveur. La sortie de ce type de requête sera vide, car elle est dirigée vers le fichier named_dump.db du répertoire du serveur ; par exemple, pour le serveur NS, le fichier serait /QIBM/UserData/OS400/DNS/NS/named_dump.db. This command illustrates how to dump the active cache on the server. The output from this type of query will be empty, because it goes to file named_dump.db in the server directory, i.e., for server NS the file would be /QIBM/UserData/OS400/DNS/NS/named_dump.db.

Messages d'erreur

Messages *ESCAPE *ESCAPE Messages

DNS0013

Erreur lors du traitement des paramètres de la commande. Error processing command parameters.

DNS0065

L'option 33 de i5/OS est requise mais n'est pas installée. Option 33 of i5/OS is required, but is not installed.

TCP7124

Le programme &1 de la bibliothèque &2, de type *PGM, s'est terminé anormalement. Program &1 in library &2 type *PGM ended abnormally.