Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
en:documentation:plugin:dns_plugin:how_to_setup_dns_plugin_1.0.5 [2017/10/31 10:32]
127.0.0.1 external edit
— (current)
Line 1: Line 1:
-===== How to setup Dns plugin ===== 
  
-Argonaut-ldap2zone is the program used to create bind zone files and refresh the bind service. 
- 
-Argonaut-ldap2zone is in development stage, so you need to take him from fusiondirectory development repository. Add argonaut development repository in your system, reload your list of packages and install: 
- 
-=== debian === 
- 
-Adding the Argonaut repositories 
- 
-[[https://​documentation.argonaut-project.org/​en/​documentation_admin/​how-to-install-the-argonaut-components|How to install Argonaut]] 
- 
-<​code>​ 
-apt-get install bind9 bind9-host argonaut-ldap2zone ldap-utils 
-apt-get install fusiondirectory-plugin-dns fusiondirectory-plugin-dns-schema 
-</​code>​ 
- 
-=== rpm <​TODO>​ === 
-<​code>​ 
-rpm user, please edit 
-</​code>​ 
- 
-===== Requirements ===== 
- 
-In order to use dns plugin, you need to have a dns server installed and configured in your infrastructure environnement. You can do that installing the following: 
- 
-=== debian === 
- 
-<​code>​ 
-apt-get install bind9 bind9-host ldap-utils 
-</​code>​ 
- 
-=== rpm <​TODO>​ === 
-<​code>​ 
-rpm user, please edit 
-</​code>​ 
- 
-===== ===== 
- 
-In order to install dns plugin, you need to have installed and configured Systems plugin. If you don't know how to install him, you can take a look at: 
- 
-  * [[en:​documentation:​plugin:​systems_plugin:​how_to_setup_systems_plugin_1.0.5|How to setup systems-plugin]] 
- 
-===== Install required packages ===== 
- 
-=== debian === 
- 
-<​code>​ 
-apt-get install fusiondirectory-plugin-dns 
-</​code>​ 
- 
-===rpm <​TODO>​ === 
-<​code>​ 
-rpm user, please edit 
-</​code>​ 
- 
-===== Install required schemas ===== 
- 
-=== debian === 
- 
-<​code>​ 
-apt-get install fusiondirectory-plugin-dns-schema 
-fusiondirectory-insert-schema -i /​etc/​ldap/​schema/​fusiondirectory/​dnszone.schema 
-fusiondirectory-insert-schema -i /​etc/​ldap/​schema/​fusiondirectory/​dns-fd-conf.schema 
-</​code>​ 
- 
-=== rpm <​TODO>​ === 
-<​code>​ 
-rpm user, please edit 
-</​code>​ 
- 
-===== Configure related services ===== 
- 
-Configure your /​etc/​ldap/​ldap.conf according to your environment:​ 
- 
-=== debian === 
- 
-<​code>​ 
-BASE    dc=opensides,​dc=de 
-URI     ​ldap://​fd-server 
-</​code>​ 
- 
-=== rpm <​TODO>​ === 
- 
-<​code>​ 
-rpm user, please edit 
-</​code>​ 
- 
-===== (Re)Start related service ===== 
- 
-=== debian === 
- 
-(Re)Start slapd: 
- 
-<​code>​ 
-root@fd-server:​~#​ service slapd stop 
-root@fd-server:​~#​ service slapd start 
-</​code>​ 
- 
-=== rpm <​TODO>​ === 
- 
-<​code>​ 
-rpm user, please edit 
-</​code>​ 
- 
-===== How to use the dns plugin ===== 
- 
-==== Add dns service to a system in fusiondirectory ==== 
- 
-In our exemple the dns service is in dhcp-server. 
- 
-**1.** If not already done, create a new server in fusiondirectory. If you don't know, see [[en:​documentation:​how_to:​create_system:​server|how to create a new server]]. 
- 
-**2.** Click on the dhcp-server:​ 
- 
-{{:​en:​documentation:​plugin:​dns_plugin:​dns-argonaut-ldap2zone-1-en.png?,​900|}} 
- 
-**3.** Click on Services: 
- 
-{{:​en:​documentation:​plugin:​dns_plugin:​dns-argonaut-ldap2zone-2-en.png?,​900|}} 
- 
-**4.** Create //DNS service// via //Actions --> Create//: 
- 
-{{:​en:​documentation:​plugin:​dns_plugin:​dns-argonaut-ldap2zone-4-en.png?,​300|}} 
- 
-**5.** Add a new dns-zone: 
- 
-{{:​en:​documentation:​plugin:​dns_plugin:​dns-argonaut-ldap2zone-5-en.png?,​900|}} 
- 
-**6.** Fill in all required fields and click "​Save":​ 
- 
-{{:​en:​documentation:​plugin:​dns_plugin:​dns-argonaut-ldap2zone-6-en.png?,​900|}} 
- 
-Note: There will be data to type in for the DNS service. All of it is just the usual information. 
- 
-**NOTE:** Make sure you fill in "​Primary dns server for this zone" as a HOSTNAME, NOT AN IP! 
-Otherwise, zone file (in /​var/​cache/​bind/​db.your.zone.) will be badly formatted and won't be loaded. 
- 
- 
-**7.** Click "​Save"​ again: 
- 
-{{:​en:​documentation:​plugin:​dns_plugin:​dns-argonaut-ldap2zone-7-en.png?,​900|}} 
- 
-**8.** Click "​Ok":​ 
- 
-{{:​en:​documentation:​plugin:​dns_plugin:​dns-argonaut-ldap2zone-8-en.png?,​900|}} 
- 
-**9.** Enter the server again, check the '​Enable DNS for this device'​ checkbox and click "​Ok":​ 
- 
-{{:​en:​documentation:​plugin:​dns_plugin:​dns-argonaut-ldap2zone-9-en.png?,​900|}} 
- 
-**10.** You are back to main "​Systems"​ screen now, and ready to continue with last step(s). 
- 
-===== Update dns zone ===== 
- 
-If not already done, [[en:​documentation:​plugin:​argonaut_plugin:​how_to_setup_argonaut_plugin_ldap2zone|add argonaut DNS service]] to your dns server in fusiondirectory interface. 
- 
-Every time that you add or change your dns zone in your dns-server, you need to update bind. You can do that directly in FusionDirectory GUI or manually from dns-server command line. 
- 
-==== run argonaut-ldap2zone from FusionDirectory ==== 
- 
-After you have saved all your changes in your dns server, click on dns settings icon: 
- 
-{{:​en:​documentation:​plugin:​argonaut_plugin:​argonaut-ldap2zone-4-en.png?,​900|}} 
- 
-then you can reload the zone's clicking on button highlighted in red: 
- 
-{{:​en:​documentation:​plugin:​argonaut_plugin:​argonaut-ldap2zone-5-en.png?,​900|}} 
- 
-==== run manually argonaut-ldap2zone ==== 
- 
-On the dns server: 
- 
-<​code>​ 
-root@dhcp-server:​~#​ argonaut-ldap2zone --verbose <​name-of-the-zone>​ 
-</​code>​ 
- 
-If you want to test your zone before enabling it and dump it on another directory 
- 
-<​code>​ 
-root@dhcp-server:​~#​ argonaut-ldap2zone --verbose --norestart --dumpdir dnszone/ master.fdi <​name-of-the-zone>​ 
-</​code>​ 
- 
-==== ==== 
- 
-In my exemple I've created 2 zones, that give me : 
- 
-<​code>​ 
-root@dhcp-server:​~#​ argonaut-ldap2zone --verbose labo.opensides.be 
-Searching DNS Zone '​labo.opensides.be.'​ 
-Found 1 results 
-Added record ns @ IN localhost ​ 
-Added record SOA @ IN localhost root.fd-install. 201211211 3600 1800 720000 6400 500 
-Reverse zone is 56.168.192.in-addr.arpa. 
-Found 1 results 
-Added record ns @ IN localhost ​ 
-Added record SOA @ IN localhost root.fd-install. 201211211 3600 1800 720000 6400 500 
-server reload successful 
- 
-root@dhcp-server:​~# ​ argonaut-ldap2zone --verbose acme.com 
-Searching DNS Zone '​acme.com.'​ 
-Found 1 results 
-Added record ns @ IN dhcp-server ​ 
-Added record SOA @ IN dhcp-server admin.acme.com. 201211212 3600 1800 720000 6400 500 
-Reverse zone is 1.0.10.in-addr.arpa. 
-Found 1 results 
-Added record ns @ IN dhcp-server ​ 
-Added record SOA @ IN dhcp-server admin.acme.com. 201211212 3600 1800 720000 6400 500 
-server reload successful 
-</​code>​ 
en/documentation/plugin/dns_plugin/how_to_setup_dns_plugin_1.0.5.1509442337.txt.gz ยท Last modified: 2017/10/31 10:32 by 127.0.0.1
CC Attribution-Share Alike 4.0 International
Driven by DokuWiki Recent changes RSS feed Valid CSS Valid XHTML 1.0