docs/doc/source/deploy_install_guides/release/setup-simple-dns-server-in-lab.rst
Ron Stone f98eb51fb4 Simplify install dirs
Simplify install doc dir structure
- Remove r6 directory
- Rename r7 directory to be non release-specific
- Delete unused files
- Delete obsolete include files
- Delete obsolete commented sections in install topics
- Remove redundent version menu entry

Signed-off-by: Ron Stone <ronald.stone@windriver.com>
Change-Id: I59634826d4b3af41410e9d26cc182f6b4aed8ade
2023-01-04 07:30:40 -05:00

100 lines
2.7 KiB
ReStructuredText

.. _setup-simple-dns-server-in-lab-r7:
=====================================
Set up a Simple DNS Server in the Lab
=====================================
While installing or using |prod|, you may require a |DNS| server that you can add
entries to for name resolution.
If you don't have access to such a DNS server, here is an example procedure for
standing up a simple Bind server on an Ubuntu 20.04 server.
.. rubric:: |proc|
#. Run the following commands to install.
.. code-block:: bash
$ sudo apt update
$ sudo apt install bind9
#. Use the following commands for a basic setup.
.. code-block:: bash
$ sudo ufw allow Bind9
$ sudo vi /etc/bind/named.conf.options
dnssec-validation no;
listen-on {
10.10.10.0/24; # this ubuntu server's address is 10.10.10.9/24
};
allow-query { any; };
# If this DNS Server can't find name, forward to …
forwarders {
8.8.8.8;
8.8.4.4;
};
$ sudo named-checkconf
$ sudo systemctl restart bind9
# Test
$ nslookup ubuntu.com 10.10.10.9
#. Add a domain, e.g. mydomain.com.
.. code-block:: bash
$ sudo vi /etc/bind/named.conf.local
zone "mydomain.com" {
type master;
file "/etc/bind/db.mydomain.com";
};
$ sudo systemctl reload bind9
$ sudo cp /etc/bind/db.local /etc/bind/db.mydomain.com
# Edit db.mydomain.com … where HOSTNAME is hostname of the dns bind server
$ sudo vi /etc/bind/db.mydomain.com
;
;
;
$TTL 604800
@ IN SOA HOSTNAME. admin.HOSTNAME. (
2 ; Serial
604800 ; Refresh
86400 ; Retry
2419200 ; Expire
604800 ) ; Negative Cache TTL
;
@ IN NS HOSTNAME.
@ IN A 10.10.10.9
wrcp IN A 10.10.10.2
horizon.wrcp IN A 10.10.10.2
registry IN A 10.10.10.10
$ sudo rndc reload
$ sudo systemctl reload bind9
$ sudo systemctl restart bind9
$ sudo systemctl status bind9
# test
$ nslookup mydomain.com 10.10.10.9
$ nslookup wrcp.mydomain.com 10.10.10.9
$ nslookup registry.mydomain.com 10.10.10.9