18ccba4577
git-svn-id: https://svn.code.sf.net/p/xcat/code/xcat-core/trunk@11633 8638fb3e-16cb-4fca-ae20-7b5d299a9bcd
88 lines
2.5 KiB
Plaintext
88 lines
2.5 KiB
Plaintext
=head1 NAME
|
|
|
|
B<makedns> - sets up domain name services (DNS).
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
B<makedns> [I<-h>|I<--help>]
|
|
|
|
B<makedns> [-e|--external] [I<-n>|I<--new>] [I<noderange>]
|
|
|
|
B<makedns> [-e|--external] [I<-d>|I<--delete> I<noderange>]
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
B<makedns> configures a DNS server on the local machine from the /etc/hosts file entries if no I<noderange> specified. It also uses the following
|
|
attributes set in the B<site> table as default values: B<domain>, B<forwarders>, B<nameservers>.
|
|
The B<net> and B<mask> attributes in the B<networks> table will also be used. Only entries in
|
|
/etc/hosts or the hosts specified by I<noderange> that are part of a network listed in the B<networks> table will be added to DNS.
|
|
|
|
B<makedns> can only handle hostnames from a single domain, normally a private domain just for the cluster. The
|
|
typical cluster set up is for site.domain to be set to the cluster domain, site.nameservers to be set to the
|
|
cluster-facing IP address of the management node, and site.forwarders to be set to the IP address of one or more
|
|
nameservers at your site that can resolve names outside of your cluster. With this set up, all nodes ask the
|
|
management node to resolve names, and if it is a name that the MN DNS does not know about, it will ask the outside
|
|
world.
|
|
|
|
By default, B<makedns> sets up named service and updates the DNS records on the mamagement node, but if -e flag is specified, it also has the flexibility to update the DNS records to an external DNS server which is listed in the /etc/resolv.conf on the management node if this external DNS server can recognize xcat key as authentication.
|
|
|
|
For more information on Cluster Name Resolution:
|
|
https://sourceforge.net/apps/mediawiki/xcat/index.php?title=Cluster_Name_Resolution
|
|
|
|
=head1 OPTIONS
|
|
|
|
=over 6
|
|
|
|
=item B<-n>|B<--new>
|
|
|
|
Use this flag to create new named configuration and db files.
|
|
|
|
=item B<-d>|B<--delete>
|
|
|
|
Remove the DNS records.
|
|
|
|
=item B<-e>|B<--external>
|
|
|
|
Update DNS records to the external DNS server listed in /etc/resolv.conf.
|
|
|
|
=item B<noderange>
|
|
|
|
A set of comma delimited node names and/or group names. See the "noderange" man page for details on additional supported formats.
|
|
|
|
=back
|
|
|
|
=head1 Examples
|
|
|
|
=over 6
|
|
|
|
=item 1
|
|
|
|
To set up DNS for all the hosts in /etc/hosts file.
|
|
|
|
B<makedns>
|
|
|
|
=item 2
|
|
|
|
To set up DNS for I<node1>.
|
|
|
|
B<makedns> I<node1>
|
|
|
|
=item 3
|
|
|
|
To create a new named configuration and db files for all hosts in /etc/hosts.
|
|
|
|
B<makedns> B<-n>
|
|
|
|
=item 4
|
|
|
|
To delete the DNS records for I<node1>.
|
|
|
|
B<makedns> B<-d> I<node1>
|
|
|
|
=back
|
|
|
|
=head1 SEE ALSO
|
|
|
|
L<makehosts(8)|makehosts.8>
|
|
|