Skip to content

Commit

Permalink
DNS Articles Critical Updates - 2 (#1244)
Browse files Browse the repository at this point in the history 
* Update regional-records.md

* Update dns-hosting.md

* Update resolution-status.md

* Update resolution-status.md

* Update transferring-domain-between-accounts.md

* Update transferring-domain-between-accounts.md

* Update resolution-status.md

* Update dns-hosting.md

* Update record-editor.md

* Update dns-hosting.md

* Update dns-hosting.md

* Update record-editor.md

* Update regional-records.md

* Update resolution-status.md

* Update transferring-domain-between-accounts.md

* Update transferring-domain-between-accounts.md

* Update transferring-domain-between-accounts.md

* Update transferring-domain-between-accounts.md

* Update dns-hosting.md

* Update dns-hosting.md

* Update dns-hosting.md

* record editor updates

* adding images

* updating numbering

* Update record-editor.md

---------

Co-authored-by: David Morrow <[email protected]>
  • Loading branch information
@itsalyse @dperrymorrow
itsalyse and dperrymorrow authored Nov 8, 2024
1 parent ecdf1d8 commit 9580726
Show file tree
Hide file tree
Showing 16 changed files with 100 additions and 80 deletions.
51 changes: 22 additions & 29 deletions content/articles/dns-hosting.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -16,23 +16,21 @@ categories:

DNSimple provides robust DNS hosting using a [global Anycast network](/articles/anycast).

To use our DNS hosting service, the account must be subscribed to a [valid plan](https://dnsimple.com/pricing). Each plan provides different levels of services. You can selectively enable/disable the DNS hosting service for a single domain, depending on whether you need to use our DNS hosting feature or not.

## Using DNSimple as a DNS hosting provider

If you want to use DNSimple to manage the DNS of an existing domain, you have two options:

1. **Keep the domain registration at your current registrar and transfer the DNS management to us.**
1. **Keep the domain registration at your current registrar, and transfer the DNS management to us.**

To use DNSimple to host your DNS for a domain, follow these instructions to [point your domain to our name servers](/articles/delegating-dnsimple-hosted).

1. **Transfer the domain registration and DNS management to us.**

If you want DNSimple to act as your domain registrar, follow these instructions to [transfer your domain to DNSimple](/articles/transferring-domain).

If you don't have a domain yet, you can [register a domain](https://dnsimple.com/tlds) with us, and subscribe to a DNS hosting plan to manage the domain with us.

To use our DNS hosting service, the account must be subscribed to a valid plan. Each plan provides different levels of services. You can selectively enable/disable the DNS hosting service for a single domain, depending on whether you need to use our DNS hosting feature or not.

If you don't have a domain yet, you can [sign up](https://dnsimple.com/pricing) or log in to [register a domain](https://dnsimple.com/tlds), and activate the zone to manage your DNS with us.

## Adding the domain

Expand All @@ -42,7 +40,7 @@ To use our DNS hosting services, you need to [add the domain to a DNSimple accou

Once you've added your domain, you can configure the DNS records using the following options:

- By [auto-importing](https://support.dnsimple.com/articles/auto-import-dns/) existing DNS records if your zone is resolving with another DNS provider.
- [Auto-importing](https://support.dnsimple.com/articles/auto-import-dns/) existing DNS records if your zone is resolving with another DNS provider.
- Configuring [connectors](https://support.dnsimple.com/categories/connectors/). With two-way connections, both sides of the service are configured and monitored automatically.
- Adding [one-click services](https://support.dnsimple.com/categories/services/). Our ready-to-use DNS snippets create the DNS configuration needed for web pages, email, and more.
- Manually entering DNS records in the DNS [record editor](https://support.dnsimple.com/articles/record-editor/).
Expand All @@ -51,8 +49,7 @@ After configuring your records, you'll be prompted to activate the DNS zone, mak

## Configuring the domain records

You manage your domain DNS records (also called DNS zone) using the [DNS record editor](/articles/record-editor). From the record editor, you can create, delete, and update the DNS records that represent the DNS zone of your domain.

You can manage your domain DNS records (also called a DNS zone) using the [DNS record editor](/articles/record-editor). From the record editor, you can create, delete, and update the DNS records that represent the DNS zone of your domain.

## Activating a DNS zone

Expand All @@ -61,49 +58,45 @@ You can activate the DNS hosting service for a domain from the domain DNS tab.
<div class="section-steps" markdown="1">
##### To activate a DNS zone

1. Log in to DNSimple with your user credentials.
1. If you have multiple accounts, select your account in the navigation bar.
1. On the top-nav menu click the <label>Domains</label> tab, locate the relevant domain, and click on the name to access the domain page.
1. Switch to the <label>DNS</label> tab.
1. If you have multiple accounts, select the relevant account in the navigation bar.
1. Click the relevant domain name to access the domain page.
1. On the left side, click the <label>DNS</label> tab.
![tab for link to dns settings](/files/dns-tab.png)

![Domain DNS tab link](/files/domain-tab-dns-link.png)

1. Find the <label>DNS active zone</label> card, and follow the instructions to activate the zone.

![Enable DNS hosting](/files/domain-dns-hosting-enable.png)
1. On the <label>DNS zone is inactive</label> card, click **Activate zone**.
![activate dns zone](/files/inactive-zone.png)

</div>

Each new domain or zone added to an account has the DNS zone inactive, whether you register/transfer the domain or simply add it.

The DNS zone is automatically inactive for each new domain or zone added to an account, whether you register/transfer the domain or simply add it.

## Deactivating a DNS zone

<div class="section-steps" markdown="1">
##### To deactivate a DNS zone

1. Log in to DNSimple with your user credentials.
1. If you have multiple accounts, select your account in the navigation bar.
1. Click the <label>Domains</label> tab, and locate the relevant domain name to access the domain page.
1. Switch to the <label>DNS</label> tab.
1. If you have multiple accounts, select the relevant account in the navigation bar.
1. Click the relevant domain name to access the domain page.
1. On the left side, click the <label>DNS</label> tab.
![tab for link to dns settings](/files/dns-tab.png)

![Domain DNS tab link](/files/domain-tab-dns-link.png)

1. Find the <label>DNS Hosting</label> card and follow the instructions to disable DNS hosting.

![Disable DNS hosting](/files/domain-dns-hosting-disable.png)
1. On the <label>DNS zone is active</label> card, click **Deactivate zone**.
![Enable DNS hosting](/files/domain-dns-hosting-enable.png)

</div>

If a domain is delegated to our name servers, deactivating a DNS zone for a domain will cause the domain to immediately stop resolving, regardless of whether the domain is registered or just hosted with us.

If the domain is registered with us but delegated to another DNS provider, deactivating the DNS zone won't change the delegation. The domain will continue to resolve with the other DNS provider.


## Use cases

There are a few cases where you may want to deactivate a zone:

- You wanted to register a domain with us, but you'll be using a different DNS hosting provider.
- You wanted to register a domain with us, but you aren't actively using the domain (e.g the domain is just reserved for future use or parked).
- You added the domain just to purchase an SSL certificate, but the domain is not delegated to us and it isn't resolving with DNSimple.

## Have more questions?

If you have any questions or need assistance activating or deactivating a DNS zone, [contact support](https://dnsimple.com/feedback), and we'll be happy to help.
41 changes: 23 additions & 18 deletions content/articles/record-editor.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -14,49 +14,51 @@ categories:

---

The **Record Editor** is the DNSimple DNS editor. The editor gives you the ability to view, create, and manage the DNS records for a domain.
The record editor is DNSimple's DNS editor. It gives you the ability to view, create, and manage the DNS records for a domain.

Any [supported DNS record type](/articles/supported-dns-records) can be managed from the record editor, except system records.


## Locating the record editor

To access the record editor from the domain page, click on the records icon.

![Record Editor from the domain page](/files/rec-editor-domain-page.png)

1. Click the relevant domain name.
1. Click the DNS tab on the left side.
![dns tab link](/files/dns-tab.png)

## System records

System Records are special DNS records created by DNSimple when you add a domain to your account. They're necessary to resolve your domain. They can't be edited from the record editor, because they're managed by the DNSimple system.
System records are special DNS records created by DNSimple when you add a domain to your account. They're necessary to resolve your domain. They can't be edited from the record editor, because they're managed by the DNSimple system.

![System Records](/files/rec-editor-page.png)
![custom vs system record](/files/custom-vs-system-record.png)

The system records include a [SOA record](/articles/soa-record) and the [four name servers](/articles/ns-record), as long as the domain is resolving with DNSimple name servers.
The system records include an [SOA record](/articles/soa-record) and the [four name servers](/articles/ns-record), as long as the domain is resolving with DNSimple's name servers.

## Adding a record

From the <label>Add a Record</label> menu select a DNS record type, and click on the type to enter the new record page. DNSimple supports [several different DNS record types](/articles/supported-dns-records).

![Select Record Type](/files/rec-editor-new-record.png)

<Info>
To make changes to records, you will need to have access to the account or have been given access to the specific domain. When adding a record, make sure the domain is delegating to us so the records propagate.
</Info>

## Simple editor

In most cases, you'll be asked to provide a _Name_, a _TTL_, and the content for the record.
In most cases, you'll be asked to provide a **Name**, a **TTL**, and the content for the record.

- _Name_: This is the record hostname. Leave it blank to configure a record for the root domain. Otherwise, enter the subdomain part for a different hostname. You can also enter an `*` for a wildcard record.
- **Name**: This is the record hostname. Leave it blank to configure a record for the root domain. Otherwise, enter the subdomain part for a different hostname. You can also enter an `*` for a wildcard record.

- _TTL_: TTL stands for Time-to-Live. It determines how long a DNS lookup for that record can be cached. The default value is 1 hour (3600 seconds), but you can adjust it by selecting a different value from the select field.
- **TTL**: TTL stands for Time-to-Live. It determines how long a DNS lookup for that record can be cached. The default value is 1 hour (3600 seconds), but you can adjust it by selecting a different value from the select field.

Enter the required infomation and press <label>Add Record</label> to create the record.
Enter the required information, and click <label>Add Record</label> to create the record.

## Record fields editor

Some DNS record types count with a special form that breaks the record content's parts into separate fields. This form provides enhanced error messages to help address any issues.

You can always switch back to the simple editor using the tabs on top. This can be useful when pasting DNS record content from a third-party service provider.

![Simple editor tab](/files/rec-editor-simple-editor-tab.png)
![switch to simple record editor](/files/switch-to-simple-editor.png)

### Specific record instructions

Expand All @@ -71,19 +73,22 @@ You can always switch back to the simple editor using the tabs on top. This can

To modify a record, click on the edit icon at the end of the record row.

![Update Record](/files/rec-editor-edit.png)

![modify a record](/files/modify-record.png)

## Deleting a record

To delete a record, click on the trash icon at the end of the record row.

<warning>
Please note there's no undo. The only way to restore a deleted record is to create it again.
There is no way to undo deleting a record. The only way to restore a deleted record is to create it again.
</warning>

![Delete Record](/files/rec-editor-delete.png)
![delete record](/files/delete-record.png)

## Managing integrated zone records

The Record Editor is also used to manage records for your integrated zones. Refer to [Record Editor for Integrated Zones](/articles/record-editor-integrated-zones) for more details.

## Have more questions?

If you have any questions or need assistance with the record editor, reach out to [support](https://dnsimple.com/feedback), and we'll be happy to help.
23 changes: 10 additions & 13 deletions content/articles/regional-records.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -8,35 +8,32 @@ categories:
# Regional Records

<info>
This article describes a feature only available on certain plans. [See the differences between plans](/articles/dnsimple-plans/).
This article describes a feature only available on the Teams plan and higher, where it's enabled by default. [See the differences between plans](/articles/dnsimple-plans/).
</info>

Regional records lets you select geographical regions where you want a record to appear.
Regional records let you select points of presence (POP) — geographical regions where you want a record to appear.

We have <%= POPS.count %> points of presence:

<% POPS.each do |server| %>* <%= server %>
<% end %>

When creating a new record, select the point of presence for this record. **If you don't select any, the record will appear in all of them.**
When you're setting up a new record for your domain, you have the option to specify its Points of Presence (POPs). **If you don't specify any, the record will be made available across all DNSimple's Points of Presence by default.**

This feature is enabled by default on certain plans. [See the differences between plans](/articles/dnsimple-plans/).
![choose regions to respond from](/files/choose-regions.png)

![Regional record selection](/files/regional-records.png)

<info>
Usage note for regional records
</info>
## Regional record usage note

Our regional records provide additional granularity for customers who want to tailor their DNS responses based on the DNS requests origination.

We have multiple Points of Presence (POPs). Some of these are geographically close, which can affect the routing path taken from Internet Service Providers (ISPs) used by the customers to our POPs.
We have multiple POPs. Some of these are geographically close, which can affect the routing path taken from Internet Service Providers (ISPs) used by the customers to our POPs.

The Internet traffic routing is impacted by multiple factors, as the network operators routing preferences vary based on optimal routing selection, costs, and specific operator agreements.
Internet traffic routing is impacted by multiple factors. Network operators' routing preferences vary based on optimal routing selection, costs, and specific operator agreements.

In certain cases, network topology and geographical proximity do not align perfectly and can lead to unpredictable results with regard to where the network packets terminate.

When using regional records, bear in mind that defining a record for specific POP, without adding the same regional record for a geographically-close POP, can cause failing DNS resolution due to the above factors.
When setting up regional records, it's important to include records for POPs that are geographically close to each other. Not doing so can cause failing DNS resolution due to the above factors.

Please [contact us](https://dnsimple.com/feedback) with any questions about regional records usage.
## Have more questions?

[Contact us](https://dnsimple.com/feedback) with any questions about regional records usage, and we'll be happy to help.
26 changes: 19 additions & 7 deletions content/articles/resolution-status.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -7,16 +7,28 @@ categories:

# Resolution Status

The resolution status in the domain page shows the name servers currently resolving for your domain configured at the registrar. Name servers are responsible for answering DNS queries for your domain.
The resolution status shows the name servers currently configured at the registry. Name servers are responsible for answering DNS queries for your domain, and they're important to your domain functioning.

![Domain is resolving](/files/resolution-status-resolving.png)
## Domains registered with DNSimple

## Domain registered with DNSimple
If you registered the domain with us, we'll set the name servers automatically to DNSimple. To find this information:

If you registered the domain with us, we'll set the name servers automatically to DNSimple. If you updated the name servers to another provider, those will appear as well.
1. Click the relevant domain in your Domain List.
1. Click the **Registration** tab on the left side.
1. You'll see the name servers listed in the **Delegation** card.

If you transferred the domain to us, we don't automatically switch your name servers. [Switch the name servers to us, once you're ready](/articles/delegating-dnsimple-registered/).
![list of nameservers for a domain](/files/nameserver-list.png)

## Domain registered with other registrar
If you updated the name servers to another provider, those will appear as well.

If the domain is registered with another registrar, and you're using DNSimple only for DNS hosting, we currently don't show the name servers for your domain. If you want to point the name servers to us, [please follow these instructions](/articles/delegating-dnsimple-hosted).
![list of external nameservers](/files/external-nameservers.png)

If you transferred the domain to us, we don't automatically switch your name servers, but you can [switch the name servers to DNSimple](/articles/delegating-dnsimple-registered/).

## Domains registered with another registrar

If the domain is registered with another registrar, and you're using DNSimple only for DNS hosting, we currently don't show the name servers for your domain. If you want to point the name servers to us, [follow these instructions](/articles/delegating-dnsimple-hosted).

## Have more questions?

If you have any questions about resolution status or pointing your name servers to DNSimple, [contact support](https://dnsimple.com/feedback), and we'll be happy to help.
Loading

0 comments on commit 9580726

Please sign in to comment.