From 4b5977b6032380d60e76e67367035d6b867e6a01 Mon Sep 17 00:00:00 2001 From: egoncalv Date: Mon, 16 Aug 2021 13:19:12 -0300 Subject: [PATCH] Added Setup Blind Server topic Applied Mary's comments and suggestions. Fixed code blocks and added file to r6_release. Signed-off-by: egoncalv Change-Id: Ie2f4177d50df13b4c3612c0b0268ab56febb5689 --- .../r5_release/index.rst | 8 ++ .../setup-simple-dns-server-in-lab.rst | 99 +++++++++++++++++++ .../r6_release/index.rst | 7 ++ .../setup-simple-dns-server-in-lab.rst | 99 +++++++++++++++++++ 4 files changed, 213 insertions(+) create mode 100644 doc/source/deploy_install_guides/r5_release/setup-simple-dns-server-in-lab.rst create mode 100644 doc/source/deploy_install_guides/r6_release/setup-simple-dns-server-in-lab.rst diff --git a/doc/source/deploy_install_guides/r5_release/index.rst b/doc/source/deploy_install_guides/r5_release/index.rst index 261773417..8cefaf22e 100644 --- a/doc/source/deploy_install_guides/r5_release/index.rst +++ b/doc/source/deploy_install_guides/r5_release/index.rst @@ -54,6 +54,14 @@ Use a private Docker registry bare_metal/bootstrapping-from-a-private-docker-registry +Set up a Simple DNS Server in Lab +********************************* + +.. toctree:: + :maxdepth: 1 + + setup-simple-dns-server-in-lab + Install controller-0 from a PXE boot server ******************************************* diff --git a/doc/source/deploy_install_guides/r5_release/setup-simple-dns-server-in-lab.rst b/doc/source/deploy_install_guides/r5_release/setup-simple-dns-server-in-lab.rst new file mode 100644 index 000000000..12ba33215 --- /dev/null +++ b/doc/source/deploy_install_guides/r5_release/setup-simple-dns-server-in-lab.rst @@ -0,0 +1,99 @@ +.. _setup-simple-dns-server-in-lab: + +================================= +Set up a Simple DNS Server in 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 to install. + + .. code-block:: bash + + $ sudo apt update + $ sudo apt install bind9 + +#. This is the 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 diff --git a/doc/source/deploy_install_guides/r6_release/index.rst b/doc/source/deploy_install_guides/r6_release/index.rst index 9d9a0b961..f2dae895e 100644 --- a/doc/source/deploy_install_guides/r6_release/index.rst +++ b/doc/source/deploy_install_guides/r6_release/index.rst @@ -54,6 +54,13 @@ Use a private Docker registry bare_metal/bootstrapping-from-a-private-docker-registry +Set up a Simple DNS Server in Lab +********************************* + +.. toctree:: + :maxdepth: 1 + + setup-simple-dns-server-in-lab Install controller-0 from a PXE boot server ******************************************* diff --git a/doc/source/deploy_install_guides/r6_release/setup-simple-dns-server-in-lab.rst b/doc/source/deploy_install_guides/r6_release/setup-simple-dns-server-in-lab.rst new file mode 100644 index 000000000..bc22b691e --- /dev/null +++ b/doc/source/deploy_install_guides/r6_release/setup-simple-dns-server-in-lab.rst @@ -0,0 +1,99 @@ +.. _setup-simple-dns-server-in-lab-r6: + +================================= +Set up a Simple DNS Server in 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 to install. + + .. code-block:: bash + + $ sudo apt update + $ sudo apt install bind9 + +#. This is the 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