HTML |
---|
<div id="google_translate_element"></div>
<script type="text/javascript">
function googleTranslateElementInit() {
new google.translate.TranslateElement({pageLanguage: 'en'}, 'google_translate_element');
}
</script>
<script type="text/javascript" src="//translate.google.com/translate_a/element.js?cb=googleTranslateElementInit"></script> |
Working with DNS Zones
This page details some common DNS tasks performed from the DNS tab and DNS Gadget Tab.
DNS Zones are accessed under the DNS tab Tab, DNS Groups or DNS Zones sub sub-tabs. Separate zone lists exist under each DNS Group. DNS group.
DNS Records are accessed from either the View Zone page (for records under that zone), or globally under the DNS Records sub-tab. For Details on working with records in either area, see Working with DNS Records
For a more general overview DNS Groups and Editing Zones, see Working with DNS Groups and Editing DNS Zones. This page focuses on specific DNS zone tasks.
Info | ||
---|---|---|
| ||
In DNSv3, zone files in the server directory will have a number appended, similar to 'example.com._123.zone'. This number is the Resource ID associated with the zone, and is used to identify the zone and differentiate zones that may have the same name, but under different DNS Groups. This append does not affect any zone functionality otherwise. |
Table of Contents |
---|
Working with DNS Zones
Add a Zone
Add a new zone while in the DNS Groups tab by selecting "Add Zone" under the desired Group. You group.
You may also add new zones from the DNS Zonespagetab, also by the clicking "Add Zone" at the top of the page.
button. The "Create New Zone" dialog will pop up.
DNS
Enter the name of your new zone and select a parent resource, if desired. The DNS group will already be selected.
...
From there, you may either save your changes and complete zone creation, or add in optional field details.
Info | ||
---|---|---|
| ||
A note on importing large zones via AXFR, You may need to adjust timeout settings depending on the size of the zone you are importing. On the ProVision server, you will need to ensure that it has access to the server that will be transferring the zone and that AXFR is enabled. On the ProVision server, you may need to adjust the php.ini setting "max_execution_time" to 300 seconds, this will ensure that importing a larger zone doesn’t time out. On the DNS server, you may also need to adjust timeout settings (tcp-timeout, max-transfer-time-out, etc.). We recommend that you set timeout settings back to the default if they are not needed. |
Optional Fields
Expand the "Optional Fields" section by clicking on the chevron (>) or the "Optional Fields" header.
Under this section, add in optional values for Zone Type, Host, Email, Serial , Refresh, Retry, Expiry, or TTL.
When finished, click the "Save Changes" button.
To exit without saving, simply click "Close".
Autogenerate Reverse Zone
Autogenerate a reverse zone from an IP Block by clicking on the CIDR link in the IPAM Gadget block list.
The reverse zone will be created for the block, and the Zone View page will load, displaying further information.
Edit
...
a Zone (View Zone page)
Zones may be editing by clicking on the Zone zone name in any zone list in which it appears - the DNS Zones Zone List, zones listed under DNS Groups Zone List, or zones listed as attached to a server under DNS Servers.
Clicking on the zone name from any zone list opens up the View Zone page.
Here, from where comments may be added, records added or updated, servers attached to the zone, advanced settings edited, backups restored or the zone pushed / exported. For details on a general interface overview of the View Zone page, see Editing DNS Zones.
For detailed information on working with DNS Records from the View Zone page Record List or the DNS Records sub-tab, see Working with DNS Records.
Add a comment
...
To add a comment to a zone, click anywhere inside the comment area and begin typing. The comment will be saved when an area outside of the comment box is clicked, deselecting the comment area.
Edit Advanced Settings
...
Open the zone "Advanced Settings" section by clicking on the header or the expansion arrow (>). Edit fields as needed, and click "Save" when complete.
Add or Edit Zone Records
From the View Zone page, under DNS Records, look for the line "Add a new ___ Record". Select the desired record type, then click "Add".
To edit an existing zone record, click on the record line in the DNS Records list.
The Edit Record dialog will open, allowing you to fill in record details.
Fill in the Host, Value, TTL, and comment if desired.
An option exists to "Skip Validation" - check to select if you wish to bypass validation for the record.
If previous versions of the record exist, the revision log will be visible under "Record revisions".
When edits or reviewing is complete, click "Save changes", or "Close" to exit without saving.
Delete Zone Records
Delete a zone record by clicking the "Delete" button under "Actions" for the desired record entry.
Attach / Detach Servers to a Zone
Under the "Attached Servers" section of the View Zone page, next to "Attach Server:", select the desired server to attach and choose the server type (Default, Master, Slave), then click the "Attach" button.
Under this area, you can change settings such as Parent Resource, DNSSEC, Lists, Zone permissions, and free lines.
Edit fields as needed, and click "Save" when doneTo detach a server from a zone, look for the server under the "Attached Servers" list, then click "Detach" under actions for that server.
Move Zones to a Different Group
Zones may be moved to a different Group group than the one created under, by clicking under, either individually or as a group.
Single Zone Move
To move a single zone, navigate to the DNS group the zone is under, then click the "Move" button in the Actions column for the zone's Actions menu.
The "Move Zone" modal will appear - select the new Group group to move to the zone under, and click "Save Changes" to complete.
Bulk Zone Move
You may move all the zones in a group to another group by selecting "Move Zones" under the desired group.
Pushing Zones
Zones may be pushed individually ("Push Zone Now"), as a scheduled future push ("Schedule Push"), or pushed as part of a Group group or Server Pushserver push.
Push Now (from Group List)
...
To immediately push a single zone, navigate to the DNS Group group the zone is under, then click the "Push" button in the Actions column for the zone.
You may also look for the zone in the DNS Zones the DNS Zones tab Zone List, and then likewise, click the "Push" button in the zone row.
Users can customize a push by choosing an option from the push options modal and clicking "Execute Push". To push normally, click "Execute Push" without selecting any options.
The "Push Status" modal will appear, showing status and any errors that occur. When a successful zone push is complete, a green "Finished DNS Pushing Request" message will appear, and the window may be closed.
Push Now (from View Zone page)
...
The View Zone page, accessed from clicking on the zone name in the Group group zone list, includes a "Push Zone Now" button that immediately attempts to push the zone to the attached server(s).
Click on "Push Zone Now", and the optionally select a customization, and click "Execute Push". The "Push Status" modal will appear, showing status and any errors that occur.
When a successful zone push is complete, a green "Finished DNS Pushing Request" message will appear, and the window may be closed.
Schedule Push (from View Zone page)
...
The View Zone page includes an option to schedule a zone push, similar to scheduling a Group group push.
Click "Schedule Push" for the zone, then select a date, time (12 hour, with AM / PM toggle24 hour), add a notification email address, and click "Save changes".
The Scheduled scheduled task will be shown in both the Zone View page (under "Scheduled Tasks") and the the Admin Scheduler task list.
The task may be deleted prior to running by clicking the "delete" button, but will automatically be removed once completed.
...
All zones contained in a DNS Group group may be pushed at the same time, by pushing the DNS Groupgroup.
For information on working with DNS Groupsgroups, including performing a manual or scheduled Group group push, see see Working with DNS Groups - Pushing a Group.
...
Admin users may push all zones on a server from the DNS Tab -> DNS Servers page.
For information on working with DNS Serversservers, including performing a manual or scheduled server push, see see Working with DNS Servers - Pushing a Server.
...
Individual .zone files may later be compressed into a .zip, and used with ProVision's the BIND DNS Zone Upload / Import tool.
Import Zone / Import Records
A zone file (.zone) may be imported into a zone to populate record data. Note: To import the record data, the zone must already exist in ProVision - although it may be an empty placeholder zone if necessary.
Enable Saving Import Files (Admin Setting - Optional)
Before you import a zone file, you may (optionally) select to save the import file to the zone. Saving the file allows you to later re-download it directly from ProVision.
To enable saving import files, go to Admin Preferences → DNS Settings sub-tab. From there, select "Import Settings" in the DNS Global Settings module.
Toggle "Keep Import File" into the ON position, then select "Save Changes".
Import Zone File
To import a zone file to populate record data in ProVision, go to the View Zone page for the zone. The zone must already exist in ProVision, although it may be empty
Click "Import Zone" on the View Zone page.
A Zone Import dialog box will open. Next to Zone File:, click "Choose File" and select your .zone file to import. Then, select an import policy to follow.
When done, click "Import Zone".
Importing Zone file with Comments
DNS Zone Import will also import comments contained in the .zone file, such as an internal change log (as seen in the image below).
During import, these comments are added to ProVision's zone comments field:
Download Imported Zone File
If "Keep Import File" has been enabled, the original zone import file will display in the View Zone page under "Zone Backups and Attached Files".
Check a Zone
Check a zone for errors by clicking the "Check" button under "Actions" for the desired zone.
A dialog box will appear, with details on any errors.
You may clear the error if desired, recheck, or close the box. Clicking the "Clear Errors" button allows you to choose whether to clear the zone error only or the zone error and any errors in records in the zone.
Choose an option and click "Execute Clear Errors".
Delete a Zone
Users with resource delete permissions over the zone may zone may delete a zone record by clicking the "Delete" button under "Actions" for the desired zone entry in any Zone List.
...
Additional Information:
For more information on working with DNS Zones, Groups, and Servers, see the following sections: