 |
Click this button to go to the index for this section. |
bindconfig(8X)
NAME
bindconfig - Configures BIND services for a single system or cluster
SYNOPSIS
/usr/sbin/bindconfig [-ui cli [clioptions]|gui [x resources]|menu]
OPTIONS
-ui Specifies the user interface to be invoked. The choices are:
cli Specifies command line interface.
gui Specifies graphical user interface.
menu
Specifies menu interface. If you select this interface, the system
runs bindsetup. For more information, see the bindsetup(8)
reference page.
[clioptions]
Specific command line options that will be used to interact with
netconfig. The syntax is as follows:
-Help
Provides a brief help message, listing all the configurable
components along with the actions that can be performed on those
components. Configurable components are indicated in Help output
by a "-" prefix.
-<component>Help
Provides a detailed help message on how to configure the specified
configurable component. Each action will be listed on a separate
line with the attributes that can be used for the action. The
configurable components are:
client
Sets the respective variables in the /etc/rc.config file to
denote that the system is configured as a BIND client.
server
Sets the respective BIND variables in the /etc/rc.config file
to denote that the system is configured as a BIND server, and
allows the user to specify the boot, cache, and BIND database
directory. The named daemon can be started and stopped during
this configuration.
resolver
Sets the resolution order in the /etc/svc.conf and
/etc/svcorder files. Also sets the resolution parameters such
as domain and name server in the /etc/resolv.conf file. This
item must be configured in order for your system to run any
BIND service as either a client or server.
zone
Configured only when the BIND service type is Server. Sets the
domains of the zones the system has authority over in the
/etc/namedb/named.boot file and creates files for the BIND
database to be stored in.
resource
Resource records are specified for every zone configured, and
the resource record data is stored in the respective zone
database files.
all Used primarily to deconfigure BIND on a system, this removes
all traces of BIND from the /etc/rc.config,
/etc/namedb/named.boot, /etc/resolv.conf, /etc/svcorder and
/etc/svc.conf files and kills the named daemon if it is
running.
-<component><action>[attr=value...]
Used to perform a specific action on the selected component,
optionally by altering the attribute's value for the selected
component. A list of actions and their specific attribute-value
pair will be listed by the clioption - configurable_component>Help.
The actions are:
create
Causes a new configuration to be created on the system for the
selected component
modify
Modifies an existing configuration for the selected component
add Adds a new value to an attribute on an existing configuration
for the selected component
remove
Deletes a value of an attribute on an existing configuration
for the selected component
purge
Removes an existing configuration for the selected component
list
Lists all the attribute-value pairs for the selected component
on the system
The x resources are standard X11 resource options. For more information,
see the X(1X) reference page
DESCRIPTION
The Bind Configuration application, bindconfig, allows a system to be
configured as a Berkeley Internet Name Domain (BIND) Client, which queries
a BIND server for host name and address information, interprets responses,
and passes the information to requesting applications, or as a BIND Server,
which is the authoritative source for information about a zone or zones.
The BIND server either maintains the master copy of the hosts database for
the zone or zones, or obtains the required information.
Before using bindconfig, be sure to configure Network Interfaces using the
Network Configuration Manager application. You can access netconfig from
the Configuration Checklist. If the Network Interfaces are down when you
configure your system as either a BIND client or a BIND server, the named
daemon will not start.
Use bindconfig to:
· Configure the host system as a master nameserver for one or more
zones, as a caching-only nameserver, or as a nameservice client
· Initialize and maintain BIND data files and generate resource records
to manage areas such as: host name to address/address to host name
mapping, host information, host name aliasing, name servers, mail
exchange, and the cache file root server list
· Manage the BIND boot files, including creation of multiple zones of
authority, designation of forwarders, and indication of slave
configurations
· Maintain the resolver configuration file, specify queriable name
servers, and specify an alternate domain search list
The bindconfig application provides a host name and address lookup service
for the Internet Network. The application distributes only the hosts
database in the DIGITAL UNIX operating system.
You must have root privileges to run this application.
The bindconfig command has three user interface options:
· Graphical user interface (GUI)
· Command line interface (CLI)
· Menu interface (Menu)
Running the Graphical User Interface Option:
To start bindconfig from the graphical user interface, do the following:
1. Click on the Application Manager icon on the CDE front panel.
2. Double click on the System_Admin application group icon.
3. Double click on the Configuration application group icon.
4. Double click on the BIND icon.
To start bindconfig from the xterm, enter the following command from the
xterm:
/usr/sbin/bindconfig
Running the Command Line Interface Option:
To start the bindconfig command line interface, enter the following command
from the xterm:
bindconfig -ui cli [clioptions]
Running the Menu Interface Option:
To start the bindconfig menu interface, enter the following command from
the xterm:
bindconfig -ui menu
This option starts the setup script for bindsetup. For more information,
see the bindsetup(8) reference page.
Running Online Help:
You can view online help for this application by entering the following at
the command line:
/usr/dt/bin/dthelpview -helpVolume \
/usr/dt/appconfig/help/C/BindConfig.sdl
You can also view online help for this application by choosing Help from
the menu bar in the GUI version. The Help pulldown menu is displayed,
providing the following options:
Overview
Displays the Overview section of the help volume, which describes the
purpose of the application, how to run the application, and how to exit
the application.
Tasks
Displays the Tasks section of the help volume, which describes how to
use the application to perform various tasks.
Reference
Displays the Reference section of the help volume, which describes all
dialog boxes and dialog box components in the application.
On Item
Activates the On Item help functionality by displaying a question mark
as the cursor. When the cursor is positioned on any component in the
application and you click on the component, a Help Viewer window is
opened and the help for the selected component is displayed in the
window.
Using Help
Displays the standard CDE instructions on how to use the Help Viewer.
About
Displays version, copyright, and trademark information for the
application.
EXAMPLES
1. The following example shows how to configure the system for a BIND
client configuration using the command line interface:
bindconfig -ui cli -resolver create domain=x.y.com ns=1.1.1.1
bindconfig -ui cli -client create
2. The following example shows how to add an additional name server using
the command line interface:
bindconfig -ui cli -resolver add ns=1.1.1.2 search=y.y.com
3. The following example shows how to configure the system as a BIND
server using the command line interface:
bindconfig -ui cli -server create domain=x.y.com \
boot=/etc/namedb/named.boot
cache=/etc/namedb/named.ca dir=/etc/namedb active=yes
4. The following example shows how to deconfigure all BIND services using
the command line interface:
bindconfig -ui cli -all purge
FILES
/etc/hosts
Lists locally maintained host names and IP addresses
/etc/svc.conf
The database name with the selected naming services
/etc/rc.config
Specifies the environment variables that define the BIND configuration
on your system
Default BIND Files:
/etc/namedb
BIND server data file directory
/etc/namedb/named.boot
BIND server boot file
/etc/namedb/named.ca
BIND server cache file
/etc/namedb/named.local
BIND server local host reverse address host file
/etc/namedb/hosts.db
BIND primary server hosts file
/etc/namedb/hosts.rev
BIND primary server reverse address hosts file
/etc/resolv.conf
BIND data file
SEE ALSO
Commands: named(8), nslookup(8), svcsetup(8), xauth(1X), resolv.conf(4),
svc.conf(4), rc.config(4), bind_intro(7)