DNS Boss README Description: ____________ DNS Boss is a GUI tool for installing and maintaining DNS on the Solaris SPARC, Solaris x86, or Linux platforms. With DNS Boss you can take care of your DNS needs by creating either a DNS Primary, a DNS Secondary, or a DNS Caching-only server. DNS Boss is a huge time saving tool, it is easy to install, and it is very easy to use! To get the DNS for your site up, you do not need to do anything other than install your machine, and then install and run DNS Boss. After you run DNS Boss on the machine running your DNS server, your DNS data will becomes live, and other DNS clients can start getting their DNS requests answered from your new DNS server. Once you create your DNS Primary with DNS Boss, you can easily build DNS Secondaries and Caching-only servers if you want, by installing and running the same DNS Boss software on those machines. DNS Boss has a standard "X" GUI, a Web GUI, a command-line interface, and an open Java API if you wish to do automated report writting, or if you wish to do custom integration. DNS Boss has the capability to support multiple users including limiting access to certain DNS domains and locking mechanisms. 30 day free trial: __________________ DNS Boss is distributed with a 30 day free trial for the DNS Boss software running on your DNS Primary. 31 days after installation, a license to use the software must be purchased, or the software will not allow you to do updates. The same DNS Boss software can also be used to create your DNS Secondaries, or DNS Caching-only servers for free. To purchase a license for your DNS Primary, see http://www.dnsboss.com, or send email to support@dnsboss.com. Solaris installation example: _____________________________ # mkdir /export/home1/tmp_dir # cp DNSBoss_SPARC_Solaris.tar.Z /export/home1/tmp_dir # cd /export/home1/tmp_dir # /bin/uncompress DNSBoss_SPARC_Solaris.tar.Z # /bin/tar xvf DNSBoss_SPARC_Solaris.tar # /usr/sbin/pkgadd -d . # cd ../ ; rm -rf /export/home1/tmp_dir Linux Installation example: ___________________________ # mkdir /home/dnsboss # mv DNSBoss_Linux.tar.Z /home/dnsboss # cd /home/dnsboss # /bin/gunzip DNSBoss_Linux.tar.gz # /bin/tar xvf DNSBoss_Linux.tar # ./install.sh To run it: __________ Solaris, or Linux: __________________ This is the normal "X" GUI. # /opt/DNSBoss/bin/dnsboss To convert your pre-existing DNS data: ______________________________________ # cp /etc/named.conf /etc/named.conf-orig or # cp /etc/named.boot /etc/named.boot-orig Bring up the "X" GUI and set the BIND version to your version of BIND. # /opt/DNSBoss/bin/dnsboss Then select under the "Advanced" menu: "Convert pre-existing DNS data into DNS Boss format DNS data" Then select the button: "Load DNS domain" to navigate between DNS domains. Select "Update all domains" once. Select "Edit hosts" to add hosts, then you will need to select "Update this domain" every time a change is made. Example of how to use other BIND version: _________________________________________ Go to the Advanced menu, and select: Set the path to the named executable Other command line options: ___________________________ Shows all command line options. # /opt/DNSBoss/bin/dnsboss_commandline -help Builds DNS for all DNS domains and restarts BIND. # /opt/DNSBoss/bin/dnsboss_commandline Builds DNS for all DNS domains and restarts BIND. # /opt/DNSBoss/bin/dnsboss_commandline -autobuild_all_domains Builds DNS for one DNS domain and restarts BIND. # /opt/DNSBoss/bin/dnsboss_commandline -autobuild your_domain.com Builds DNS for all DNS domains but do not restart BIND. # /opt/DNSBoss/bin/dnsboss_commandline -autobuild_no_restart your_domain.com Add a DNS domain. # /opt/DNSBoss/bin/dnsboss_commandline -add_domain your_domain.com Delete a DNS domain. # /opt/DNSBoss/bin/dnsboss_commandline -delete_domain your_domain.com Convert a pre-existing domain. Requires existence of /etc/named.conf-orig or /etc/named.boot-orig containing your pre-existing DNS data. # /opt/DNSBoss/bin/dnsboss_commandline -converter Add an IP and a name to a DNS domain. # /opt/DNSBoss/bin/dnsboss_commandline -add_ip_to_domain your_domain.com subnet ip name Add a host to the next available IP for DNS domain on subnet. # /opt/DNSBoss/bin/dnsboss_commandline -add_host_to_next_available_ip name your_domain.com subnet true Remove an entry. # /opt/DNSBoss/bin/dnsboss_commandline -remove_host name your_domain.com Check if an IP exists in any DNS domain. # /opt/DNSBoss/bin/dnsboss_commandline -ip_exists ip Check if a name exists in DNS domain. # /opt/DNSBoss/bin/dnsboss_commandline -name_exists_in_domain name yourdomain.com List all names in a DNS domain. # /opt/DNSBoss/bin/dnsboss_commandline -list_names_in_domain yourdomain.com List all IP's in a DNS domain. # /opt/DNSBoss/bin/dnsboss_commandline -list_ips_in_domain yourdomain.com List all subnets in a DNS domain. # /opt/DNSBoss/bin/dnsboss_commandline -list_subnets_in_domain yourdomain.com List duplicate names in a DNS domain. # /opt/DNSBoss/bin/dnsboss_commandline -list_duplicate_names_in_domain yourdomain.com List duplicate CNAME's in a DNS domain. # /opt/DNSBoss/bin/dnsboss_commandline -list_duplicate_cnames_in_domain yourdomain.com List all IP's in all DNS domains. # /opt/DNSBoss/bin/dnsboss_commandline -list_ips_in_all_domains List all subnets in all DNS domains. # /opt/DNSBoss/bin/dnsboss_commandline -list_subnets_in_all_domains List duplicate IP's in all DNS domains. # /opt/DNSBoss/bin/dnsboss_commandline -list_duplicate_ips_in_all_domains List duplicate IP's, names, and CNAME's in all DNS domains. # /opt/DNSBoss/bin/dnsboss_commandline -list_duplicate_ips_names_and_cnames_in_all_domains List percent fill of IP address space in all DNS domains. # /opt/DNSBoss/bin/dnsboss_commandline -list_percent_fill_of_ip_address_space_in_all_domains List the total unique DNS names to calculate license pricing. # /opt/DNSBoss/bin/dnsboss_commandline -license Lock the application so nobody else can do updates. Available only on Unix OS's. # /opt/DNSBoss/bin/lockdnboss To uninstall for Solaris or Linux: __________________________________ # /opt/DNSBoss/bin/uninstall_dnsboss To start Web UI on Solaris or Linux: ____________________________________ # /opt/DNSBoss/bin/S99dnsbossweb start Allow user jane_doe access to all DNS domains. # vi /opt/DNSBoss/etc/password.txt jane_doe:secret123:* Make sure the license agreement is accepted. # vi /opt/DNSBoss/etc/server.properties la=true Start a Web browser and point it to port 8080 of the DNS primary running DNS Boss. Make sure to use https, and not http when typing in the URL. Here is an example: # netscape https://192.168.15.10:8080 To navigate between DNS domains, just click the 'Load DNS domain' button. Unix crontab example for automated 'hands off' DNS builds: __________________________________________________________ Crontab Example for Solaris to update DNS every 30 minutes: godzilla# setenv EDITOR /usr/ucb/vi godzilla# crontab -e 1,30 * * * * /opt/DNSBoss/bin/dnsboss_commandline > /dev/null 2>&1 Open Java API for custom DNS automation: ________________________________________ # cd /opt/DNSBoss/lib/tools/java_api # ./api_demo Website/documentation: ______________________ http://www.dnsboss.com Support, bugs, requests for permanent licenses: _______________________________________________ support@dnsboss.com
