starlingx/docs
Code Issues Proposed changes

Added Setup Blind Server topic

Browse Source 
Applied Mary's comments and suggestions.

Fixed code blocks and added file to r6_release.

Signed-off-by: egoncalv <elisamaraaoki.goncalves@windriver.com>
Change-Id: Ie2f4177d50df13b4c3612c0b0268ab56febb5689
This commit is contained in:
egoncalv 2021-08-16 13:19:12 -03:00 committed by Elisamara Aoki Gonçalves
parent 1a2b9390b8
commit 4b5977b603
4 changed files with 213 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
doc/source/deploy_install_guides/r5_release/index.rst
View File

@ -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
*******************************************

99
doc/source/deploy_install_guides/r5_release/setup-simple-dns-server-in-lab.rst Normal file
View File

@ -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

7
doc/source/deploy_install_guides/r6_release/index.rst
View File

@ -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
*******************************************

99
doc/source/deploy_install_guides/r6_release/setup-simple-dns-server-in-lab.rst Normal file
View File

@ -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