From 3b4c7b964e56a2f45276354fa1a04892dffaf086 Mon Sep 17 00:00:00 2001 From: marciocloudflare Date: Wed, 15 Jan 2025 11:34:18 +0000 Subject: [PATCH 01/41] changed name to config connector --- .../connector/configure-hardware-connector/index.mdx | 2 +- .../configuration/connector/configure-virtual-connector.mdx | 2 +- .../connector/{create-site.mdx => configure-connector.mdx} | 0 3 files changed, 2 insertions(+), 2 deletions(-) rename src/content/partials/magic-wan/connector/{create-site.mdx => configure-connector.mdx} (100%) diff --git a/src/content/docs/magic-wan/configuration/connector/configure-hardware-connector/index.mdx b/src/content/docs/magic-wan/configuration/connector/configure-hardware-connector/index.mdx index 9a4fc9f4e28293a..a01ed96438bc1f5 100644 --- a/src/content/docs/magic-wan/configuration/connector/configure-hardware-connector/index.mdx +++ b/src/content/docs/magic-wan/configuration/connector/configure-hardware-connector/index.mdx @@ -44,7 +44,7 @@ Refer to [SFP+ port information](/magic-wan/configuration/connector/configure-ha ## Set up Cloudflare dashboard If you need a throughput higher than 1 Gbps, you can use one of the SFP+ ports. Refer to [SFP+ port information](/magic-wan/configuration/connector/configure-hardware-connector/sfp-port-information/) for more information on the hardware supported.", lan: "refers to the physical Magic WAN Connector Ethernet port that you are using for your LAN. The ports are labeled `GE1`, `GE2`, `GE3`, `GE4`, `GE5`, and `GE6`. Choose a number corresponding to the port that you are using in Connector.
If you need a throughput higher than 1 Gbps, you can use one of the SFP+ ports. Refer to [SFP+ port information](/magic-wan/configuration/connector/configure-hardware-connector/sfp-port-information/) for more information on the hardware supported.", diff --git a/src/content/docs/magic-wan/configuration/connector/configure-virtual-connector.mdx b/src/content/docs/magic-wan/configuration/connector/configure-virtual-connector.mdx index 5c0a8263f9b44da..c0fa18f51b3f39b 100644 --- a/src/content/docs/magic-wan/configuration/connector/configure-virtual-connector.mdx +++ b/src/content/docs/magic-wan/configuration/connector/configure-virtual-connector.mdx @@ -104,7 +104,7 @@ You cannot use the same license key twice, or reuse a key once the virtual machi ## Set up Cloudflare dashboard Date: Wed, 15 Jan 2025 11:55:19 +0000 Subject: [PATCH 02/41] refactored connector partial --- .../connector/configure-connector.mdx | 75 +++++-------------- 1 file changed, 18 insertions(+), 57 deletions(-) diff --git a/src/content/partials/magic-wan/connector/configure-connector.mdx b/src/content/partials/magic-wan/connector/configure-connector.mdx index c3b6aa24299cd8a..f44a2446f5c89ed 100644 --- a/src/content/partials/magic-wan/connector/configure-connector.mdx +++ b/src/content/partials/magic-wan/connector/configure-connector.mdx @@ -7,66 +7,21 @@ params: import { GlossaryTooltip, Markdown, Render, TabItem, Tabs } from "~/components"; -### 1. Create a site +### 1. Add a Connector on-ramp -Sites represent the local network where you have installed your Magic WAN Connector - for example, a branch office location. +The first steps you need to do is to add your Connector to the Cloudflare dashboard and set up all the settings associated with it before you can connect your Magic WAN Connector to the Internet. -You need to create a site and set up all the settings associated with it before you can connect your Magic WAN Connector to the Internet. - -To add a site: - - +To add a Connector on-ramp: 1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/) and select your account. -2. Go to **Magic WAN** > **Sites**. -3. Select **Create** to create a new site and start the configuration wizard. -4. Add a name and description for your new site. -5. (Optional) In **Site location**, you can add the geographical coordinates for your site. If you add geographical coordinates, your site will show up in the [Site Analytics overview map](/magic-wan/analytics/site-analytics/). -6. Under **Connector**, select **Add Connector**. This will show you a list of Magic WAN Connector devices associated with your account. -7. If you have more than one Connector, choose the one that corresponds to the site you are creating. Connectors are identified by a serial number, also known as a service tag. Use this information to choose the right Connector. Select **Add Connector** when you are ready to proceed. -8. The Connector will be added to your site with an **Interrupt window** defined. The interrupt window is the time period when the Magic WAN Connector software can update, which may result in interruption to existing connections. You can change this later. Refer to [Interrupt window](/magic-wan/configuration/connector/maintenance/interrupt-service-window/) for more details on how to define when the Connector can update its systems. -9. Select **Next** to proceed to creating your WAN and LAN networks. - - - - - -Create a `POST` request [using the API](/api/resources/magic_transit/subresources/sites/methods/create/) to create a site. - -Example: - -```bash -curl https://api.cloudflare.com/client/v4/accounts/{account_id}/magic/sites \ ---header "X-Auth-Email: " \ ---header "X-Auth-Key: " \ ---header "Content-Type: application/json" \ ---data '{ - "name": "" - "description": "", -}' -``` - -```json output -{ - "result": { - "site": { - "id": "", - "name": "", - "description": "", - "connector_id": null, - "secondary_connector_id": null, - "ha_mode": false - } - }, - "success": true, - "errors": [], - "messages": [] -} -``` - -Take note of the site `id` parameter, as you will need it to create WANs and LANs. - - +2. Go to **Magic WAN** > **Connector on-ramps**. +3. Select **Add**. +4. In **Name**, input a name for your Connector and optionally you can also add a description for it. +5. You need to decide if you want to turn on high availability for this connector. Refer to [About high availability configurations](#about-high-availability-configurations) for more information. +6. Select **Add Connector**. This will show you a list of Magic WAN Connector devices associated with your account. +7. If you have more than one Connector, choose the one that corresponds to the site you are creating. Connectors are identified by a serial number, also known as a service tag. Use this information to choose the right Connector. Select **Select Connector** when you are ready to proceed. +8. The Connector will be added to your account with an **Interrupt window** defined. The interrupt window is the time period when the Magic WAN Connector software can update, which may result in interruption to existing connections. You can change this later. Refer to [Interrupt window](/magic-wan/configuration/connector/maintenance/interrupt-service-window/) for more details on how to define when the Connector can update its systems. +9. Select **Continue** to proceed to creating your WAN and LAN networks. ### 2. Create a WAN @@ -132,7 +87,7 @@ curl https://api.cloudflare.com/client/v4/accounts/{account_id}/magic/sites/{sit - **Next hop**: The address of the L3 router to which the Connector should forward packets for this subnet. - **Static NAT prefix**: Optional setting. If you want to enable NAT for a routed subnet, supply an "external" prefix for the overlay-facing side of the NAT to use. It must be the same size as **Prefix**.
Refer to [Routed subnets](/magic-wan/configuration/connector/network-options/routed-subnets/) for more information. 8. Select **Save**. -9. Select **Save and exit** to finish your configuration. Tunnels and static routes will be automatically created and associated with your site once the Magic WAN Connector boots up (refer to the next step). +9. Select **Done** to finish your configuration. Tunnels and static routes will be automatically created for your Magic WAN Connector, once it boots up. @@ -159,6 +114,12 @@ curl https://api.cloudflare.com/client/v4/accounts/{account_id}/magic/sites/{sit +### 4 Add your Connector to a site + +After finishing your Connector configuration, you need to add it to a site. Sites represent the local network where you have installed your Magic WAN Connector - for example, a branch office location - and allow you to have all your on-ramps in one place. Sites also allow you to check, at a glance, the state of your on-ramps and set up health alert settings so that you get notified whenre there are issues with the site's on-ramps. + +Refer to [Set up a site](#) for more information. + #### Network segmentation After setting up your LANs, you can configure your Connector to enable communication between them without traffic leaving your premises. Refer to [Network segmentation](/magic-wan/configuration/connector/network-options/network-segmentation/) for more information. From 813b0c74022360877d839449b44d255376ddcd69 Mon Sep 17 00:00:00 2001 From: marciocloudflare Date: Wed, 15 Jan 2025 11:59:37 +0000 Subject: [PATCH 03/41] corrected links --- .../configure-hardware-connector/index.mdx | 19 +++++++++---------- .../connector/configure-virtual-connector.mdx | 19 +++++++++---------- 2 files changed, 18 insertions(+), 20 deletions(-) diff --git a/src/content/docs/magic-wan/configuration/connector/configure-hardware-connector/index.mdx b/src/content/docs/magic-wan/configuration/connector/configure-hardware-connector/index.mdx index a01ed96438bc1f5..e772e14777aadac 100644 --- a/src/content/docs/magic-wan/configuration/connector/configure-hardware-connector/index.mdx +++ b/src/content/docs/magic-wan/configuration/connector/configure-hardware-connector/index.mdx @@ -133,16 +133,15 @@ Make sure you complete the setup workflow and activate your Magic WAN Connector ::: 1. Connect Magic WAN Connector to a DHCP port with access to the Internet. -2. [Create a site](#1-create-a-site) in the Cloudflare dashboard. -3. Associate a Connector to it. -4. Create a [DHCP WAN](#2-create-a-wan). -5. [Active](#activate-connector) and power on your Connector. -6. Wait 60 seconds. -7. Make changes to the [WAN settings](#2-create-a-wan) in the Cloudflare dashboard to a static IP set up. -8. Wait 60 seconds again. -9. Magic WAN Connector will go offline. This is normal and expected behavior. -10. Adjust your physical connections as required to match the static configuration. -11. Magic WAN Connector comes back online. +2. [Add a Connector on-ramp](#1-add-a-connector-on-ramp) in the Cloudflare dashboard. +3. Create a [DHCP WAN](#2-create-a-wan). +4. [Active](#activate-connector) and power on your Connector. +5. Wait 60 seconds. +6. Make changes to the [WAN settings](#2-create-a-wan) in the Cloudflare dashboard to a static IP set up. +7. Wait 60 seconds again. +8. Magic WAN Connector will go offline. This is normal and expected behavior. +9. Adjust your physical connections as required to match the static configuration. +10. Magic WAN Connector comes back online. --- diff --git a/src/content/docs/magic-wan/configuration/connector/configure-virtual-connector.mdx b/src/content/docs/magic-wan/configuration/connector/configure-virtual-connector.mdx index c0fa18f51b3f39b..a2854922ce83471 100644 --- a/src/content/docs/magic-wan/configuration/connector/configure-virtual-connector.mdx +++ b/src/content/docs/magic-wan/configuration/connector/configure-virtual-connector.mdx @@ -126,7 +126,7 @@ You cannot use the same license key twice, or reuse a key once the virtual machi ## Boot your Virtual Connector 1. Go to **Virtual Machines** in VMware, and boot up Virtual Connector's VM. -2. The Virtual Connector will make a request to Cloudflare. This is the step where Virtual Connector registers your provided license key and [downloads the site configuration](#1-create-a-site) for its connected site. +2. The Virtual Connector will make a request to Cloudflare. This is the step where Virtual Connector registers your provided license key and downloads the [configuration you provided](#1-add-a-connector-on-ramp). 3. The Virtual Connector will set up the LAN and WAN connections according to the configuration downloaded from the site you created on the Cloudflare dashboard. The Virtual Connector will also establish IPsec tunnels. 4. If successful, the [tunnel health checks](/magic-wan/configuration/common-settings/check-tunnel-health-dashboard/) will show as healthy. 5. If you do not see a [healthy heartbeat](/magic-wan/configuration/connector/maintenance/heartbeat/) the Cloudflare dashboard, reboot the Virtual Connector's VM in VMware. @@ -142,15 +142,14 @@ Make sure you complete the setup workflow and activate your Virtual Connector be ::: 1. Connect the machine where you installed the VM with Virtual Connector to a DHCP port with access to the Internet. -2. [Create a site](#1-create-a-site) in the Cloudflare dashboard. -3. Associate a Connector to it. -4. Create a [DHCP WAN](#2-create-a-wan). -5. [Active](#activate-connector) and boot your Virtual Connector. -6. Wait 60 seconds. -7. Make changes to the [WAN settings](#2-create-a-wan) in the Cloudflare dashboard to a static IP set up. -8. Wait 60 seconds again. -9. Modify your [Port Groups](#deploy-the-virtual-connector-on-vmware) as needed to change the source from which the WAN port obtains its IP address. -10. Reboot your virtual machine. +2. [Add a Connector on-ramp](#1-add-a-connector-on-ramp) in the Cloudflare dashboard. +3. Create a [DHCP WAN](#2-create-a-wan). +4. [Active](#activate-connector) and boot your Virtual Connector. +5. Wait 60 seconds. +6. Make changes to the [WAN settings](#2-create-a-wan) in the Cloudflare dashboard to a static IP set up. +7. Wait 60 seconds again. +8. Modify your [Port Groups](#deploy-the-virtual-connector-on-vmware) as needed to change the source from which the WAN port obtains its IP address. +9. Reboot your virtual machine. --- From 88fad05c999632ab113d251c794db6e90c64e6f3 Mon Sep 17 00:00:00 2001 From: marciocloudflare Date: Wed, 15 Jan 2025 12:06:05 +0000 Subject: [PATCH 04/41] updated steps numbers and ha configs --- .../partials/magic-wan/connector/activate-connector.mdx | 4 ++-- .../partials/magic-wan/connector/configure-connector.mdx | 9 +++++---- src/content/partials/magic-wan/connector/ha-configs.mdx | 7 ++++--- 3 files changed, 11 insertions(+), 9 deletions(-) diff --git a/src/content/partials/magic-wan/connector/activate-connector.mdx b/src/content/partials/magic-wan/connector/activate-connector.mdx index e0bb3adac0bc5f5..b8d84c83d905c57 100644 --- a/src/content/partials/magic-wan/connector/activate-connector.mdx +++ b/src/content/partials/magic-wan/connector/activate-connector.mdx @@ -5,9 +5,9 @@ params: import { Markdown } from "~/components"; -{props.shippedLanguage}, and will only establish a connection to the Cloudflare network when it is activated. Cloudflare recommends leaving it deactivated until you finish [setting it up in the dashboard](#1-create-a-site). +{props.shippedLanguage}, and will only establish a connection to the Cloudflare network when it is activated. Cloudflare recommends leaving it deactivated until you finish [setting it up in the dashboard](#1-add-a-connector-on-ramp). -When the Connector is first activated, one of the ports must be connected to the Internet through a device that supports DHCP. This is required so that the Connector can reach the Cloudflare global network and download the required configurations that you set up in the [site configuration](#1-create-a-site) step. +When the Connector is first activated, one of the ports must be connected to the Internet through a device that supports DHCP. This is required so that the Connector can reach the Cloudflare global network and download the required configurations that you [set up](#1-add-a-connector-on-ramp). :::caution Remember to connect Magic WAN Connector through a route that supports DHCP for its first connection to the Internet. Otherwise, the Connector will not work. diff --git a/src/content/partials/magic-wan/connector/configure-connector.mdx b/src/content/partials/magic-wan/connector/configure-connector.mdx index f44a2446f5c89ed..257197b2326abdc 100644 --- a/src/content/partials/magic-wan/connector/configure-connector.mdx +++ b/src/content/partials/magic-wan/connector/configure-connector.mdx @@ -18,10 +18,11 @@ To add a Connector on-ramp: 3. Select **Add**. 4. In **Name**, input a name for your Connector and optionally you can also add a description for it. 5. You need to decide if you want to turn on high availability for this connector. Refer to [About high availability configurations](#about-high-availability-configurations) for more information. -6. Select **Add Connector**. This will show you a list of Magic WAN Connector devices associated with your account. -7. If you have more than one Connector, choose the one that corresponds to the site you are creating. Connectors are identified by a serial number, also known as a service tag. Use this information to choose the right Connector. Select **Select Connector** when you are ready to proceed. -8. The Connector will be added to your account with an **Interrupt window** defined. The interrupt window is the time period when the Magic WAN Connector software can update, which may result in interruption to existing connections. You can change this later. Refer to [Interrupt window](/magic-wan/configuration/connector/maintenance/interrupt-service-window/) for more details on how to define when the Connector can update its systems. -9. Select **Continue** to proceed to creating your WAN and LAN networks. +6. Select **Create and continue**. +7. Select **Add Connector**. This will show you a list of Magic WAN Connector devices associated with your account. +8. If you have more than one Connector, choose the one that corresponds to the site you are creating. Connectors are identified by a serial number, also known as a service tag. Use this information to choose the right Connector. Select **Select Connector** when you are ready to proceed. +9. The Connector will be added to your account with an **Interrupt window** defined. The interrupt window is the time period when the Magic WAN Connector software can update, which may result in interruption to existing connections. You can change this later. Refer to [Interrupt window](/magic-wan/configuration/connector/maintenance/interrupt-service-window/) for more details on how to define when the Connector can update its systems. +10. Select **Continue** to proceed to creating your WAN and LAN networks. ### 2. Create a WAN diff --git a/src/content/partials/magic-wan/connector/ha-configs.mdx b/src/content/partials/magic-wan/connector/ha-configs.mdx index 1d1c42dafc678d5..157f639d2df02bf 100644 --- a/src/content/partials/magic-wan/connector/ha-configs.mdx +++ b/src/content/partials/magic-wan/connector/ha-configs.mdx @@ -32,12 +32,13 @@ You cannot enable high availability for an existing site. To add high availabili To set up a high availability configuration: 1. Follow the steps in [Create a site](#1-create-a-site) up until step 4. -2. After naming your site, select **Enable high availability**. -3. Under **Connector**, select **Add Connector**. +2. After naming your site, select **Turn on high availability**. +3. Select **Create and continue**. +4. Select **Add Connector**. 4. From the list, choose your first Connector > **Add Connector**. 5. Back on the previous screen, select **Add secondary Connector**. 6. From the list, choose your second Connector > **Add Connector**. -7. Select **Next** to [Create a WAN](#2-create-a-wan). If you are configuring a static IP, configure the IP for the primary node as the static address, and the IP for the secondary node as the secondary static address. +7. Select **Continue** to [Create a WAN](#2-create-a-wan). If you are configuring a static IP, configure the IP for the primary node as the static address, and the IP for the secondary node as the secondary static address. 8. To create a LAN, follow the steps mentioned above in [Create a LAN](#3-create-a-lan) up until step 4. 9. In **Static address**, enter the IP for the primary node in your site. For example, `192.168.10.1/24`. 10. In **Secondary static address**, enter the IP for the secondary node in your site. For example, `192.168.10.2/24`. From 6a882fda86b783aa10e8916c353ecefa7b1c8d51 Mon Sep 17 00:00:00 2001 From: marciocloudflare Date: Wed, 15 Jan 2025 12:06:46 +0000 Subject: [PATCH 05/41] corrected numbers --- .../magic-wan/connector/ha-configs.mdx | 22 +++++++++---------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/src/content/partials/magic-wan/connector/ha-configs.mdx b/src/content/partials/magic-wan/connector/ha-configs.mdx index 157f639d2df02bf..2f99f5b0c7ab521 100644 --- a/src/content/partials/magic-wan/connector/ha-configs.mdx +++ b/src/content/partials/magic-wan/connector/ha-configs.mdx @@ -35,14 +35,14 @@ To set up a high availability configuration: 2. After naming your site, select **Turn on high availability**. 3. Select **Create and continue**. 4. Select **Add Connector**. -4. From the list, choose your first Connector > **Add Connector**. -5. Back on the previous screen, select **Add secondary Connector**. -6. From the list, choose your second Connector > **Add Connector**. -7. Select **Continue** to [Create a WAN](#2-create-a-wan). If you are configuring a static IP, configure the IP for the primary node as the static address, and the IP for the secondary node as the secondary static address. -8. To create a LAN, follow the steps mentioned above in [Create a LAN](#3-create-a-lan) up until step 4. -9. In **Static address**, enter the IP for the primary node in your site. For example, `192.168.10.1/24`. -10. In **Secondary static address**, enter the IP for the secondary node in your site. For example, `192.168.10.2/24`. -11. In **Virtual static address**, enter the IP that the LAN south of the Connector will forward traffic to. For example, `192.168.10.3/24`. -12. Select **Save**. -13. From the **High availability probing link** drop-down menu, select the port that should be used to monitor the node's health. Cloudflare recommends you choose a reliable interface as the HA probing link. The primary and secondary node's probing link should be connected over a switch, and cannot be a direct connection. -14. +5. From the list, choose your first Connector > **Add Connector**. +6. Back on the previous screen, select **Add secondary Connector**. +7. From the list, choose your second Connector > **Add Connector**. +8. Select **Continue** to [Create a WAN](#2-create-a-wan). If you are configuring a static IP, configure the IP for the primary node as the static address, and the IP for the secondary node as the secondary static address. +9. To create a LAN, follow the steps mentioned above in [Create a LAN](#3-create-a-lan) up until step 4. +10. In **Static address**, enter the IP for the primary node in your site. For example, `192.168.10.1/24`. +11. In **Secondary static address**, enter the IP for the secondary node in your site. For example, `192.168.10.2/24`. +12. In **Virtual static address**, enter the IP that the LAN south of the Connector will forward traffic to. For example, `192.168.10.3/24`. +13. Select **Save**. +14. From the **High availability probing link** drop-down menu, select the port that should be used to monitor the node's health. Cloudflare recommends you choose a reliable interface as the HA probing link. The primary and secondary node's probing link should be connected over a switch, and cannot be a direct connection. +15. From b4a187d5674e0d011c2e3542c4d94bc17e26951d Mon Sep 17 00:00:00 2001 From: marciocloudflare Date: Wed, 15 Jan 2025 12:09:08 +0000 Subject: [PATCH 06/41] changed partial name --- .../connector/configure-hardware-connector/index.mdx | 2 +- .../configuration/connector/configure-virtual-connector.mdx | 2 +- .../{configure-connector.mdx => connector-onramps.mdx} | 0 3 files changed, 2 insertions(+), 2 deletions(-) rename src/content/partials/magic-wan/connector/{configure-connector.mdx => connector-onramps.mdx} (100%) diff --git a/src/content/docs/magic-wan/configuration/connector/configure-hardware-connector/index.mdx b/src/content/docs/magic-wan/configuration/connector/configure-hardware-connector/index.mdx index e772e14777aadac..d8f423ee1cfb5da 100644 --- a/src/content/docs/magic-wan/configuration/connector/configure-hardware-connector/index.mdx +++ b/src/content/docs/magic-wan/configuration/connector/configure-hardware-connector/index.mdx @@ -44,7 +44,7 @@ Refer to [SFP+ port information](/magic-wan/configuration/connector/configure-ha ## Set up Cloudflare dashboard If you need a throughput higher than 1 Gbps, you can use one of the SFP+ ports. Refer to [SFP+ port information](/magic-wan/configuration/connector/configure-hardware-connector/sfp-port-information/) for more information on the hardware supported.", lan: "refers to the physical Magic WAN Connector Ethernet port that you are using for your LAN. The ports are labeled `GE1`, `GE2`, `GE3`, `GE4`, `GE5`, and `GE6`. Choose a number corresponding to the port that you are using in Connector.
If you need a throughput higher than 1 Gbps, you can use one of the SFP+ ports. Refer to [SFP+ port information](/magic-wan/configuration/connector/configure-hardware-connector/sfp-port-information/) for more information on the hardware supported.", diff --git a/src/content/docs/magic-wan/configuration/connector/configure-virtual-connector.mdx b/src/content/docs/magic-wan/configuration/connector/configure-virtual-connector.mdx index a2854922ce83471..e21a3d2511476c3 100644 --- a/src/content/docs/magic-wan/configuration/connector/configure-virtual-connector.mdx +++ b/src/content/docs/magic-wan/configuration/connector/configure-virtual-connector.mdx @@ -104,7 +104,7 @@ You cannot use the same license key twice, or reuse a key once the virtual machi ## Set up Cloudflare dashboard Date: Wed, 15 Jan 2025 12:30:49 +0000 Subject: [PATCH 07/41] refined text --- src/content/partials/magic-wan/connector/before-you-begin.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/content/partials/magic-wan/connector/before-you-begin.mdx b/src/content/partials/magic-wan/connector/before-you-begin.mdx index 61f97351cf076d8..907d2d0a02955d2 100644 --- a/src/content/partials/magic-wan/connector/before-you-begin.mdx +++ b/src/content/partials/magic-wan/connector/before-you-begin.mdx @@ -8,7 +8,7 @@ You can install up to two Magic WAN Connectors for redundancy at each of your si In this type of high availability (HA) configuration, you will choose a reliable LAN interface as the HA link which will be used to monitor the health of the peer connector. HA links can be dedicated links or can be shared with other LAN traffic. -You must decide the type of configuration you want for your site from the beginning: no redundancy or with redundancy. You cannot add redundancy after finishing configuring your dashboard settings. If, at a later stage, you decide to enable redundancy, you will need to delete your site configuration in the Cloudflare dashboard, and start again. +You must decide the type of configuration you want for your site from the beginning: no redundancy or with redundancy. You cannot add redundancy after finishing configuring your dashboard settings. If, at a later stage, you decide to enable redundancy, you will need to delete your Connector on-ramp in the Cloudflare dashboard, and start again. @@ -21,5 +21,5 @@ You must decide the type of configuration you want for your site from the beginn :::caution -You cannot enable high availability for an existing site. To add high availability to an existing site in the Cloudflare dashboard, you need to delete the site and start again. Plan accordingly to create a high availability configuration from the start if needed. +You cannot enable high availability for an existing Connector on-rap. To add high availability to an existing Connector on-ramp in the Cloudflare dashboard, you need to delete the on-ramp and start again. Plan accordingly to create a high availability configuration from the start if needed. ::: From f9786a6fbe7c8d7e983cd631de1398b8fd082345 Mon Sep 17 00:00:00 2001 From: marciocloudflare Date: Wed, 15 Jan 2025 12:30:56 +0000 Subject: [PATCH 08/41] refined text --- .../partials/magic-wan/connector/connector-onramps.mdx | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/src/content/partials/magic-wan/connector/connector-onramps.mdx b/src/content/partials/magic-wan/connector/connector-onramps.mdx index 257197b2326abdc..92630383a309f8a 100644 --- a/src/content/partials/magic-wan/connector/connector-onramps.mdx +++ b/src/content/partials/magic-wan/connector/connector-onramps.mdx @@ -9,18 +9,18 @@ import { GlossaryTooltip, Markdown, Render, TabItem, Tabs } from "~/components"; ### 1. Add a Connector on-ramp -The first steps you need to do is to add your Connector to the Cloudflare dashboard and set up all the settings associated with it before you can connect your Magic WAN Connector to the Internet. +You need to add your Connector to your Cloudflare dashboard and configure its settings before connecting it to the Internet. To add a Connector on-ramp: 1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/) and select your account. 2. Go to **Magic WAN** > **Connector on-ramps**. 3. Select **Add**. -4. In **Name**, input a name for your Connector and optionally you can also add a description for it. -5. You need to decide if you want to turn on high availability for this connector. Refer to [About high availability configurations](#about-high-availability-configurations) for more information. +4. In **Name**, enter a descriptive name for your Connector. Optionally, you can also add a description for it. +5. You need to decide if you want to turn on high availability for the Connector. Refer to [About high availability configurations](#about-high-availability-configurations) for more information. 6. Select **Create and continue**. 7. Select **Add Connector**. This will show you a list of Magic WAN Connector devices associated with your account. -8. If you have more than one Connector, choose the one that corresponds to the site you are creating. Connectors are identified by a serial number, also known as a service tag. Use this information to choose the right Connector. Select **Select Connector** when you are ready to proceed. +8. If you have more than one Connector, choose the one that corresponds to the on-ramp you are creating. Connectors are identified by a serial number, also known as a service tag. Use this information to choose the right Connector. Select **Select Connector** when you are ready to proceed. 9. The Connector will be added to your account with an **Interrupt window** defined. The interrupt window is the time period when the Magic WAN Connector software can update, which may result in interruption to existing connections. You can change this later. Refer to [Interrupt window](/magic-wan/configuration/connector/maintenance/interrupt-service-window/) for more details on how to define when the Connector can update its systems. 10. Select **Continue** to proceed to creating your WAN and LAN networks. @@ -117,7 +117,7 @@ curl https://api.cloudflare.com/client/v4/accounts/{account_id}/magic/sites/{sit ### 4 Add your Connector to a site -After finishing your Connector configuration, you need to add it to a site. Sites represent the local network where you have installed your Magic WAN Connector - for example, a branch office location - and allow you to have all your on-ramps in one place. Sites also allow you to check, at a glance, the state of your on-ramps and set up health alert settings so that you get notified whenre there are issues with the site's on-ramps. +After finishing your Connector configuration, you need to add it to a site. Sites represent the local network where you have installed your Magic WAN Connector — for example, a branch office location — and allow you to have all your on-ramps in one place. Sites also allow you to check, at a glance, the state of your on-ramps and set up health alert settings so that you get notified when there are issues with the site's on-ramps. Refer to [Set up a site](#) for more information. From 5d3ad1353517143d1386a52525ac5a24eb259de0 Mon Sep 17 00:00:00 2001 From: marciocloudflare Date: Wed, 15 Jan 2025 12:33:11 +0000 Subject: [PATCH 09/41] corrected link --- src/content/partials/magic-wan/connector/ha-configs.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/partials/magic-wan/connector/ha-configs.mdx b/src/content/partials/magic-wan/connector/ha-configs.mdx index 2f99f5b0c7ab521..3353fa85a9aa2e7 100644 --- a/src/content/partials/magic-wan/connector/ha-configs.mdx +++ b/src/content/partials/magic-wan/connector/ha-configs.mdx @@ -31,7 +31,7 @@ You cannot enable high availability for an existing site. To add high availabili To set up a high availability configuration: -1. Follow the steps in [Create a site](#1-create-a-site) up until step 4. +1. Follow the steps in [Add a Connector on-ramp](#1-add-a-connector-on-ramp) up until step 4. 2. After naming your site, select **Turn on high availability**. 3. Select **Create and continue**. 4. Select **Add Connector**. From 6d8425694254fbd618f47932d871b4b9a9ce6546 Mon Sep 17 00:00:00 2001 From: marciocloudflare Date: Wed, 15 Jan 2025 14:42:12 +0000 Subject: [PATCH 10/41] added sites info to pages --- .../magic-wan/configuration/manually/how-to/bgp-peering.mdx | 4 ++++ .../manually/how-to/configure-static-routes.mdx | 4 ++++ .../configuration/manually/how-to/configure-tunnels.mdx | 6 ++++++ 3 files changed, 14 insertions(+) diff --git a/src/content/docs/magic-wan/configuration/manually/how-to/bgp-peering.mdx b/src/content/docs/magic-wan/configuration/manually/how-to/bgp-peering.mdx index 5553e3073e947db..f4d6501dbd48c35 100644 --- a/src/content/docs/magic-wan/configuration/manually/how-to/bgp-peering.mdx +++ b/src/content/docs/magic-wan/configuration/manually/how-to/bgp-peering.mdx @@ -19,3 +19,7 @@ import { Render } from "~/components" productGatewayOrEgress: "Magic WAN with Gateway" }} /> + +## Next steps + +Refer to [Set up a site](#) to create a site. Sites represent the local network of a data center, office or other physical location that combine all on-ramps used by your account. Sites also allow you to check, at a glance, the state of your on-ramps and set up health alert settings so that you get notified when there are issues with the site's on-ramps. \ No newline at end of file diff --git a/src/content/docs/magic-wan/configuration/manually/how-to/configure-static-routes.mdx b/src/content/docs/magic-wan/configuration/manually/how-to/configure-static-routes.mdx index 30fd9da20f20bfe..7baff0bfafa99c4 100644 --- a/src/content/docs/magic-wan/configuration/manually/how-to/configure-static-routes.mdx +++ b/src/content/docs/magic-wan/configuration/manually/how-to/configure-static-routes.mdx @@ -14,3 +14,7 @@ import { Render } from "~/components" Configuration", tunnelEndpoints: "/magic-wan/configuration/manually/how-to/configure-tunnels/", ipRanges: "
When using Magic WAN and Cloudflare Tunnel together, remember to consider the IP ranges utilized in the static routes of Cloudflare Tunnel when selecting static routes for Magic WAN. For more information, refer to [Cloudflare Tunnel](/magic-wan/zero-trust/cloudflare-tunnel/).
" }} /> + +## Next steps + +Refer to [Set up a site](#) to create a site. Sites represent the local network of a data center, office or other physical location that combine all on-ramps used by your account. Sites also allow you to check, at a glance, the state of your on-ramps and set up health alert settings so that you get notified when there are issues with the site's on-ramps. \ No newline at end of file diff --git a/src/content/docs/magic-wan/configuration/manually/how-to/configure-tunnels.mdx b/src/content/docs/magic-wan/configuration/manually/how-to/configure-tunnels.mdx index 4d18972a52e7562..b825f969c4448f0 100644 --- a/src/content/docs/magic-wan/configuration/manually/how-to/configure-tunnels.mdx +++ b/src/content/docs/magic-wan/configuration/manually/how-to/configure-tunnels.mdx @@ -73,6 +73,12 @@ import { GlossaryTooltip, Render } from "~/components"; }} /> +## Add a site + +Now that you have configured your tunnels, the next step is to create a site. Sites represent the local network of a data center, office or other physical location that combine all on-ramps used by your account. Sites also allow you to check, at a glance, the state of your on-ramps and set up health alert settings so that you get notified when there are issues with the site's on-ramps. + +Refer to [Set up a site](#) for more information. + ## Bidirectional vs unidirectional health checks Date: Wed, 15 Jan 2025 14:46:38 +0000 Subject: [PATCH 11/41] created sites brief partial --- .../configuration/manually/how-to/bgp-peering.mdx | 2 +- .../manually/how-to/configure-static-routes.mdx | 2 +- .../configuration/manually/how-to/configure-tunnels.mdx | 4 +--- .../partials/magic-wan/connector/connector-onramps.mdx | 4 +--- src/content/partials/magic-wan/sites-brief.mdx | 7 +++++++ 5 files changed, 11 insertions(+), 8 deletions(-) create mode 100644 src/content/partials/magic-wan/sites-brief.mdx diff --git a/src/content/docs/magic-wan/configuration/manually/how-to/bgp-peering.mdx b/src/content/docs/magic-wan/configuration/manually/how-to/bgp-peering.mdx index f4d6501dbd48c35..b4e7763782f434f 100644 --- a/src/content/docs/magic-wan/configuration/manually/how-to/bgp-peering.mdx +++ b/src/content/docs/magic-wan/configuration/manually/how-to/bgp-peering.mdx @@ -22,4 +22,4 @@ import { Render } from "~/components" ## Next steps -Refer to [Set up a site](#) to create a site. Sites represent the local network of a data center, office or other physical location that combine all on-ramps used by your account. Sites also allow you to check, at a glance, the state of your on-ramps and set up health alert settings so that you get notified when there are issues with the site's on-ramps. \ No newline at end of file +Now that you have configured BGP peering, the next step is to create a site. \ No newline at end of file diff --git a/src/content/docs/magic-wan/configuration/manually/how-to/configure-static-routes.mdx b/src/content/docs/magic-wan/configuration/manually/how-to/configure-static-routes.mdx index 7baff0bfafa99c4..a7030b8ee8cdaf6 100644 --- a/src/content/docs/magic-wan/configuration/manually/how-to/configure-static-routes.mdx +++ b/src/content/docs/magic-wan/configuration/manually/how-to/configure-static-routes.mdx @@ -17,4 +17,4 @@ import { Render } from "~/components" ## Next steps -Refer to [Set up a site](#) to create a site. Sites represent the local network of a data center, office or other physical location that combine all on-ramps used by your account. Sites also allow you to check, at a glance, the state of your on-ramps and set up health alert settings so that you get notified when there are issues with the site's on-ramps. \ No newline at end of file +Now that you have configured your routes, the next step is to create a site. \ No newline at end of file diff --git a/src/content/docs/magic-wan/configuration/manually/how-to/configure-tunnels.mdx b/src/content/docs/magic-wan/configuration/manually/how-to/configure-tunnels.mdx index b825f969c4448f0..4fb45e8f08bf5b2 100644 --- a/src/content/docs/magic-wan/configuration/manually/how-to/configure-tunnels.mdx +++ b/src/content/docs/magic-wan/configuration/manually/how-to/configure-tunnels.mdx @@ -75,9 +75,7 @@ import { GlossaryTooltip, Render } from "~/components"; ## Add a site -Now that you have configured your tunnels, the next step is to create a site. Sites represent the local network of a data center, office or other physical location that combine all on-ramps used by your account. Sites also allow you to check, at a glance, the state of your on-ramps and set up health alert settings so that you get notified when there are issues with the site's on-ramps. - -Refer to [Set up a site](#) for more information. +Now that you have configured your tunnels, the next step is to create a site. ## Bidirectional vs unidirectional health checks diff --git a/src/content/partials/magic-wan/connector/connector-onramps.mdx b/src/content/partials/magic-wan/connector/connector-onramps.mdx index 92630383a309f8a..8d06371f9752744 100644 --- a/src/content/partials/magic-wan/connector/connector-onramps.mdx +++ b/src/content/partials/magic-wan/connector/connector-onramps.mdx @@ -117,9 +117,7 @@ curl https://api.cloudflare.com/client/v4/accounts/{account_id}/magic/sites/{sit ### 4 Add your Connector to a site -After finishing your Connector configuration, you need to add it to a site. Sites represent the local network where you have installed your Magic WAN Connector — for example, a branch office location — and allow you to have all your on-ramps in one place. Sites also allow you to check, at a glance, the state of your on-ramps and set up health alert settings so that you get notified when there are issues with the site's on-ramps. - -Refer to [Set up a site](#) for more information. +After finishing your Connector configuration, you need to add it to a site. #### Network segmentation diff --git a/src/content/partials/magic-wan/sites-brief.mdx b/src/content/partials/magic-wan/sites-brief.mdx new file mode 100644 index 000000000000000..7b0bc0b5d29ce8a --- /dev/null +++ b/src/content/partials/magic-wan/sites-brief.mdx @@ -0,0 +1,7 @@ +--- +{} +--- + +Sites represent the local network of a data center, office or other physical location that combine all on-ramps used by your account. Sites also allow you to check, at a glance, the state of your on-ramps and set up health alert settings so that you get notified when there are issues with the site's on-ramps. + +Refer to [Set up a site](#) for more information. \ No newline at end of file From a245d301c35a03ce4617176317db61f662dca4b9 Mon Sep 17 00:00:00 2001 From: marciocloudflare Date: Wed, 15 Jan 2025 14:49:35 +0000 Subject: [PATCH 12/41] removed next step --- .../magic-wan/configuration/manually/how-to/bgp-peering.mdx | 6 +----- .../manually/how-to/configure-static-routes.mdx | 6 +----- 2 files changed, 2 insertions(+), 10 deletions(-) diff --git a/src/content/docs/magic-wan/configuration/manually/how-to/bgp-peering.mdx b/src/content/docs/magic-wan/configuration/manually/how-to/bgp-peering.mdx index b4e7763782f434f..875c41a501d7784 100644 --- a/src/content/docs/magic-wan/configuration/manually/how-to/bgp-peering.mdx +++ b/src/content/docs/magic-wan/configuration/manually/how-to/bgp-peering.mdx @@ -18,8 +18,4 @@ import { Render } from "~/components" mtLimitations: " ", productGatewayOrEgress: "Magic WAN with Gateway" }} -/> - -## Next steps - -Now that you have configured BGP peering, the next step is to create a site. \ No newline at end of file +/> \ No newline at end of file diff --git a/src/content/docs/magic-wan/configuration/manually/how-to/configure-static-routes.mdx b/src/content/docs/magic-wan/configuration/manually/how-to/configure-static-routes.mdx index a7030b8ee8cdaf6..ff12855eb69e3bd 100644 --- a/src/content/docs/magic-wan/configuration/manually/how-to/configure-static-routes.mdx +++ b/src/content/docs/magic-wan/configuration/manually/how-to/configure-static-routes.mdx @@ -13,8 +13,4 @@ import { Render } from "~/components" - Configuration", tunnelEndpoints: "/magic-wan/configuration/manually/how-to/configure-tunnels/", ipRanges: "
When using Magic WAN and Cloudflare Tunnel together, remember to consider the IP ranges utilized in the static routes of Cloudflare Tunnel when selecting static routes for Magic WAN. For more information, refer to [Cloudflare Tunnel](/magic-wan/zero-trust/cloudflare-tunnel/).
" }} /> - -## Next steps - -Now that you have configured your routes, the next step is to create a site. \ No newline at end of file + Configuration", tunnelEndpoints: "/magic-wan/configuration/manually/how-to/configure-tunnels/", ipRanges: "
When using Magic WAN and Cloudflare Tunnel together, remember to consider the IP ranges utilized in the static routes of Cloudflare Tunnel when selecting static routes for Magic WAN. For more information, refer to [Cloudflare Tunnel](/magic-wan/zero-trust/cloudflare-tunnel/).
" }} /> \ No newline at end of file From 991a5d4464965e80afa5b3a29696fc4a4151e791 Mon Sep 17 00:00:00 2001 From: marciocloudflare Date: Wed, 15 Jan 2025 16:19:30 +0000 Subject: [PATCH 13/41] changed where add sites appear in the flow --- .../magic-wan/configuration/manually/how-to/bgp-peering.mdx | 6 +++++- .../manually/how-to/configure-static-routes.mdx | 6 +++++- .../configuration/manually/how-to/configure-tunnels.mdx | 4 ---- 3 files changed, 10 insertions(+), 6 deletions(-) diff --git a/src/content/docs/magic-wan/configuration/manually/how-to/bgp-peering.mdx b/src/content/docs/magic-wan/configuration/manually/how-to/bgp-peering.mdx index 875c41a501d7784..61a42142c89aec6 100644 --- a/src/content/docs/magic-wan/configuration/manually/how-to/bgp-peering.mdx +++ b/src/content/docs/magic-wan/configuration/manually/how-to/bgp-peering.mdx @@ -18,4 +18,8 @@ import { Render } from "~/components" mtLimitations: " ", productGatewayOrEgress: "Magic WAN with Gateway" }} -/> \ No newline at end of file +/> + +## Next steps + +Now that you have configured your tunnels and BGP peering, the next step is to create a site. \ No newline at end of file diff --git a/src/content/docs/magic-wan/configuration/manually/how-to/configure-static-routes.mdx b/src/content/docs/magic-wan/configuration/manually/how-to/configure-static-routes.mdx index ff12855eb69e3bd..fb2a957a1ab8a27 100644 --- a/src/content/docs/magic-wan/configuration/manually/how-to/configure-static-routes.mdx +++ b/src/content/docs/magic-wan/configuration/manually/how-to/configure-static-routes.mdx @@ -13,4 +13,8 @@ import { Render } from "~/components" - Configuration", tunnelEndpoints: "/magic-wan/configuration/manually/how-to/configure-tunnels/", ipRanges: "
When using Magic WAN and Cloudflare Tunnel together, remember to consider the IP ranges utilized in the static routes of Cloudflare Tunnel when selecting static routes for Magic WAN. For more information, refer to [Cloudflare Tunnel](/magic-wan/zero-trust/cloudflare-tunnel/).
" }} /> \ No newline at end of file + Configuration", tunnelEndpoints: "/magic-wan/configuration/manually/how-to/configure-tunnels/", ipRanges: "
When using Magic WAN and Cloudflare Tunnel together, remember to consider the IP ranges utilized in the static routes of Cloudflare Tunnel when selecting static routes for Magic WAN. For more information, refer to [Cloudflare Tunnel](/magic-wan/zero-trust/cloudflare-tunnel/).
" }} /> + +## Next steps + +Now that you have configured your tunnels and static routes, the next step is to create a site. \ No newline at end of file diff --git a/src/content/docs/magic-wan/configuration/manually/how-to/configure-tunnels.mdx b/src/content/docs/magic-wan/configuration/manually/how-to/configure-tunnels.mdx index 4fb45e8f08bf5b2..4d18972a52e7562 100644 --- a/src/content/docs/magic-wan/configuration/manually/how-to/configure-tunnels.mdx +++ b/src/content/docs/magic-wan/configuration/manually/how-to/configure-tunnels.mdx @@ -73,10 +73,6 @@ import { GlossaryTooltip, Render } from "~/components"; }} /> -## Add a site - -Now that you have configured your tunnels, the next step is to create a site. - ## Bidirectional vs unidirectional health checks Date: Thu, 16 Jan 2025 10:06:53 +0000 Subject: [PATCH 14/41] created sites page --- .../docs/magic-wan/configuration/common-settings/sites.mdx | 6 ++++++ 1 file changed, 6 insertions(+) create mode 100644 src/content/docs/magic-wan/configuration/common-settings/sites.mdx diff --git a/src/content/docs/magic-wan/configuration/common-settings/sites.mdx b/src/content/docs/magic-wan/configuration/common-settings/sites.mdx new file mode 100644 index 000000000000000..00b56201ba6227a --- /dev/null +++ b/src/content/docs/magic-wan/configuration/common-settings/sites.mdx @@ -0,0 +1,6 @@ +--- +title: Sites +pcx_content_type: how-to +sidebar: + order: 2 +--- \ No newline at end of file From 47104a77bbaf9afbdc8ad46a34c6392830e45aa1 Mon Sep 17 00:00:00 2001 From: marciocloudflare Date: Thu, 16 Jan 2025 10:06:57 +0000 Subject: [PATCH 15/41] reordered pages --- .../common-settings/check-tunnel-health-dashboard.mdx | 2 +- .../configuration/common-settings/tunnel-health-checks.mdx | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/src/content/docs/magic-wan/configuration/common-settings/check-tunnel-health-dashboard.mdx b/src/content/docs/magic-wan/configuration/common-settings/check-tunnel-health-dashboard.mdx index 4b250492b2b7ee4..377f3841dc9f662 100644 --- a/src/content/docs/magic-wan/configuration/common-settings/check-tunnel-health-dashboard.mdx +++ b/src/content/docs/magic-wan/configuration/common-settings/check-tunnel-health-dashboard.mdx @@ -2,7 +2,7 @@ pcx_content_type: how-to title: Check tunnel health in the dashboard sidebar: - order: 2 + order: 3 --- import { Render } from "~/components"; diff --git a/src/content/docs/magic-wan/configuration/common-settings/tunnel-health-checks.mdx b/src/content/docs/magic-wan/configuration/common-settings/tunnel-health-checks.mdx index 007d1cd825d2be0..3f6a16eb93c44f6 100644 --- a/src/content/docs/magic-wan/configuration/common-settings/tunnel-health-checks.mdx +++ b/src/content/docs/magic-wan/configuration/common-settings/tunnel-health-checks.mdx @@ -2,7 +2,7 @@ pcx_content_type: how-to title: Update tunnel health checks frequency sidebar: - order: 3 + order: 4 --- import { Render } from "~/components"; From 40c7f6216fdadbc7d193c0182919412280ff5000 Mon Sep 17 00:00:00 2001 From: marciocloudflare Date: Thu, 16 Jan 2025 10:13:39 +0000 Subject: [PATCH 16/41] moved site title --- .../partials/magic-wan/connector/connector-onramps.mdx | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/src/content/partials/magic-wan/connector/connector-onramps.mdx b/src/content/partials/magic-wan/connector/connector-onramps.mdx index 8d06371f9752744..22a31e978e0521e 100644 --- a/src/content/partials/magic-wan/connector/connector-onramps.mdx +++ b/src/content/partials/magic-wan/connector/connector-onramps.mdx @@ -115,10 +115,6 @@ curl https://api.cloudflare.com/client/v4/accounts/{account_id}/magic/sites/{sit -### 4 Add your Connector to a site - -After finishing your Connector configuration, you need to add it to a site. - #### Network segmentation After setting up your LANs, you can configure your Connector to enable communication between them without traffic leaving your premises. Refer to [Network segmentation](/magic-wan/configuration/connector/network-options/network-segmentation/) for more information. @@ -133,3 +129,7 @@ Magic WAN Connector supports different types of DHCP configurations. Connector c - [Reserve IP addresses](/magic-wan/configuration/connector/network-options/dhcp/dhcp-static-address-reservation/) for specific devices on your network. Refer to [DHCP options](/magic-wan/configuration/connector/network-options/dhcp/) to learn more. + +### 4 Add your Connector to a site + +After finishing your Connector configuration, you need to add it to a site. \ No newline at end of file From 21706557aa475179d9a042cf9f22a95e607ea109 Mon Sep 17 00:00:00 2001 From: marciocloudflare Date: Thu, 16 Jan 2025 10:37:07 +0000 Subject: [PATCH 17/41] added intro --- .../docs/magic-wan/configuration/common-settings/sites.mdx | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/src/content/docs/magic-wan/configuration/common-settings/sites.mdx b/src/content/docs/magic-wan/configuration/common-settings/sites.mdx index 00b56201ba6227a..5c99c24f360e907 100644 --- a/src/content/docs/magic-wan/configuration/common-settings/sites.mdx +++ b/src/content/docs/magic-wan/configuration/common-settings/sites.mdx @@ -3,4 +3,6 @@ title: Sites pcx_content_type: how-to sidebar: order: 2 ---- \ No newline at end of file +--- + +Sites represent the local network of a data center, office or other physical location that combine all on-ramps used by your account. Sites also allow you to check, at a glance, the state of your on-ramps and set up health alert settings so that you get notified when there are issues with the site's on-ramps. \ No newline at end of file From 5981aaab3024fffc2a2c4eadfe026c7c0da7864b Mon Sep 17 00:00:00 2001 From: marciocloudflare Date: Thu, 16 Jan 2025 11:19:33 +0000 Subject: [PATCH 18/41] added content --- .../docs/magic-wan/configuration/common-settings/sites.mdx | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/src/content/docs/magic-wan/configuration/common-settings/sites.mdx b/src/content/docs/magic-wan/configuration/common-settings/sites.mdx index 5c99c24f360e907..01d3c47b541a5df 100644 --- a/src/content/docs/magic-wan/configuration/common-settings/sites.mdx +++ b/src/content/docs/magic-wan/configuration/common-settings/sites.mdx @@ -5,4 +5,9 @@ sidebar: order: 2 --- -Sites represent the local network of a data center, office or other physical location that combine all on-ramps used by your account. Sites also allow you to check, at a glance, the state of your on-ramps and set up health alert settings so that you get notified when there are issues with the site's on-ramps. \ No newline at end of file +Sites represent the local network of a data center, office or other physical location that combine all on-ramps used by your account. Sites also allow you to check, at a glance, the state of your on-ramps and set up health alert settings so that you get notified when there are issues with the site's on-ramps. + +To use a site, start by setting up your on-ramps. These can be [GRE or IPsec tunnels](/magic-wan/configuration/manually/how-to/configure-tunnels/), a [Magic WAN Connector](/magic-wan/configuration/connector/), or a direct [CNI link](/magic-wan/network-interconnect/). When you are finished setting these up, refer to the steps below to learn how to set up a site. + +1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/) and select your account. +2. 2. Go to **Magic WAN** > **Network overview**. \ No newline at end of file From ffe52ccdcd7c5e3751dd8c4811f523822a1ad2ac Mon Sep 17 00:00:00 2001 From: marciocloudflare Date: Thu, 16 Jan 2025 11:29:04 +0000 Subject: [PATCH 19/41] corrected dash path --- .../magic-wan/connector/app-aware-policies/add-app.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/content/partials/magic-wan/connector/app-aware-policies/add-app.mdx b/src/content/partials/magic-wan/connector/app-aware-policies/add-app.mdx index b076d10b203ae2e..dc69f871228dac0 100644 --- a/src/content/partials/magic-wan/connector/app-aware-policies/add-app.mdx +++ b/src/content/partials/magic-wan/connector/app-aware-policies/add-app.mdx @@ -6,7 +6,7 @@ params: import { Markdown } from "~/components"; 1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/login), and select your account. -2. Select **Magic WAN** > **Sites**. -3. Select the site you want to configure > **Edit**. +2. Select **Magic WAN** > **Connector on-ramps**. +3. Select the Connector you want to configure > **Edit**. 4. Select **Traffic Steering**. 5. In **{props.featureName}**, select **Add**. From 3abd1039c9d599235dcdaa922dde538df212a3e6 Mon Sep 17 00:00:00 2001 From: marciocloudflare Date: Thu, 16 Jan 2025 11:29:46 +0000 Subject: [PATCH 20/41] corrected dash path --- .../magic-wan/connector/app-aware-policies/delete-app.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/content/partials/magic-wan/connector/app-aware-policies/delete-app.mdx b/src/content/partials/magic-wan/connector/app-aware-policies/delete-app.mdx index ccfa5e511ed808e..c4b957ee08bf869 100644 --- a/src/content/partials/magic-wan/connector/app-aware-policies/delete-app.mdx +++ b/src/content/partials/magic-wan/connector/app-aware-policies/delete-app.mdx @@ -6,8 +6,8 @@ params: import { Markdown } from "~/components"; 1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/login), and select your account. -2. Select **Magic WAN** > **Sites**. -3. Select the site you want to configure > **Edit**. +2. Select **Magic WAN** > **Connector on-ramps**. +3. Select the Connector you want to configure > **Edit**. 4. Select **Traffic Steering**. 5. In **{props.featureName}**, find the application you want to delete, and select the **three dots** next to it. 6. Select **Remove**. From 1cb8717c0fca4da81a9ab95bc542e0c1e868f463 Mon Sep 17 00:00:00 2001 From: marciocloudflare Date: Thu, 16 Jan 2025 11:40:22 +0000 Subject: [PATCH 21/41] corrected path --- .../common-settings/check-tunnel-health-dashboard.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/magic-wan/configuration/common-settings/check-tunnel-health-dashboard.mdx b/src/content/docs/magic-wan/configuration/common-settings/check-tunnel-health-dashboard.mdx index 377f3841dc9f662..533a94633ff18e1 100644 --- a/src/content/docs/magic-wan/configuration/common-settings/check-tunnel-health-dashboard.mdx +++ b/src/content/docs/magic-wan/configuration/common-settings/check-tunnel-health-dashboard.mdx @@ -12,7 +12,7 @@ import { Render } from "~/components"; params={{ dashInfo: "The dashboard shows the view of tunnel health as measured from each Cloudflare location where your traffic is likely to land.", - productPath: "**Magic WAN** > **Tunnel health check**", + productPath: "**Magic WAN** > **Tunnel health**", }} /> From cabd9701c6cabd536fc7bb4ece7ab5f59fdf79fe Mon Sep 17 00:00:00 2001 From: marciocloudflare Date: Thu, 16 Jan 2025 11:45:20 +0000 Subject: [PATCH 22/41] removed spaces --- .../application-based-policies/breakout-traffic.mdx | 1 - .../partials/magic-wan/connector/app-aware-policies/add-app.mdx | 2 +- 2 files changed, 1 insertion(+), 2 deletions(-) diff --git a/src/content/docs/magic-wan/configuration/connector/network-options/application-based-policies/breakout-traffic.mdx b/src/content/docs/magic-wan/configuration/connector/network-options/application-based-policies/breakout-traffic.mdx index 7fd687adec3c6ec..be8bf50e608f7d4 100644 --- a/src/content/docs/magic-wan/configuration/connector/network-options/application-based-policies/breakout-traffic.mdx +++ b/src/content/docs/magic-wan/configuration/connector/network-options/application-based-policies/breakout-traffic.mdx @@ -45,7 +45,6 @@ You need to configure Breakout traffic for each of your existing sites, as it is file="connector/app-aware-policies/add-app" params={{ featureName: "Breakout traffic" }} /> - 6. Select one or more applications that should bypass Cloudflare filtering from the list. You can also use the search box. 7. Select **Add applications**. diff --git a/src/content/partials/magic-wan/connector/app-aware-policies/add-app.mdx b/src/content/partials/magic-wan/connector/app-aware-policies/add-app.mdx index dc69f871228dac0..7acae29e2df3d6e 100644 --- a/src/content/partials/magic-wan/connector/app-aware-policies/add-app.mdx +++ b/src/content/partials/magic-wan/connector/app-aware-policies/add-app.mdx @@ -9,4 +9,4 @@ import { Markdown } from "~/components"; 2. Select **Magic WAN** > **Connector on-ramps**. 3. Select the Connector you want to configure > **Edit**. 4. Select **Traffic Steering**. -5. In **{props.featureName}**, select **Add**. +5. In **{props.featureName}**, select **Add**. \ No newline at end of file From 0e1f998abc388f7e864eb40a47db97f7cd5241c0 Mon Sep 17 00:00:00 2001 From: marciocloudflare Date: Thu, 16 Jan 2025 11:52:26 +0000 Subject: [PATCH 23/41] corrected dash path --- .../connector/network-options/dhcp/dhcp-relay.mdx | 6 +++--- .../connector/network-options/dhcp/dhcp-server.mdx | 6 +++--- 2 files changed, 6 insertions(+), 6 deletions(-) diff --git a/src/content/docs/magic-wan/configuration/connector/network-options/dhcp/dhcp-relay.mdx b/src/content/docs/magic-wan/configuration/connector/network-options/dhcp/dhcp-relay.mdx index c48ae48f1d8559f..62656bf09b5d8ea 100644 --- a/src/content/docs/magic-wan/configuration/connector/network-options/dhcp/dhcp-relay.mdx +++ b/src/content/docs/magic-wan/configuration/connector/network-options/dhcp/dhcp-relay.mdx @@ -29,9 +29,9 @@ To configure DHCP relay: 1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/) and select your account. -2. Go to **Magic WAN** > **Sites**. -3. Select your site > **Edit**. -4. Select **Network**. +2. Go to **Magic WAN** > **Connector on-ramps**. +3. Select your Connector > **Edit**. +4. Select **Network Configuration**. 5. In **LAN configuration**, select the LAN where you need to configure DHCP relay. 6. Select **Edit**. 7. Select **This is a DHCP Relay**. diff --git a/src/content/docs/magic-wan/configuration/connector/network-options/dhcp/dhcp-server.mdx b/src/content/docs/magic-wan/configuration/connector/network-options/dhcp/dhcp-server.mdx index 3abd012ec9e7fc4..172e1eff7cdb26f 100644 --- a/src/content/docs/magic-wan/configuration/connector/network-options/dhcp/dhcp-server.mdx +++ b/src/content/docs/magic-wan/configuration/connector/network-options/dhcp/dhcp-server.mdx @@ -10,9 +10,9 @@ When you use a static IP address, Magic WAN Connector can also act as a DHCP ser 1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/) and select your account. -2. Go to **Magic WAN** > **Sites**. -3. Select your site > **Edit**. -4. Select **Network**. +2. Go to **Magic WAN** > **Connector on-ramps**. +3. Select your Connector > **Edit**. +4. Select **Network Configuration**. 5. In **LAN configuration**, select the LAN where you want to enable DHCP server. 6. Select **Edit**. 7. Under **Static addressing**, select **This is a DHCP Server**. You also have to specify: From 9d84c7122c23e4f84f8a2984c8f909b23cd33de1 Mon Sep 17 00:00:00 2001 From: marciocloudflare Date: Thu, 16 Jan 2025 11:55:11 +0000 Subject: [PATCH 24/41] corrected dash path --- .../network-options/network-segmentation.mdx | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/src/content/docs/magic-wan/configuration/connector/network-options/network-segmentation.mdx b/src/content/docs/magic-wan/configuration/connector/network-options/network-segmentation.mdx index 4eee4d59bccc123..cfd7bbd58d7037f 100644 --- a/src/content/docs/magic-wan/configuration/connector/network-options/network-segmentation.mdx +++ b/src/content/docs/magic-wan/configuration/connector/network-options/network-segmentation.mdx @@ -42,9 +42,9 @@ The following guide assumes you have already created a site and configured your Follow the steps below to create a new LAN policy to segment your network. Only the fields marked **required** are mandatory. 1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/login), and select your account. -2. Select **Magic WAN** > **Sites**. -3. Select the site you want to configure > **Edit**. -4. Go to **Network**, and scroll down to **LAN configuration**. +2. Select **Magic WAN** > **Connector on-ramps**. +3. Select the Connector you want to configure > **Edit**. +4. Go to **Network Configuration**, and scroll down to **LAN configuration**. 5. Select **LAN policies** > **Create Policy**. 6. In **Policy name**, enter a descriptive name for the policy you are creating. 7. From the drop-down menu **LAN 1**, select your origin LAN. @@ -142,9 +142,9 @@ The new policy will ensure that traffic between the specified LANs flows locally 1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/login), and select your account. -2. Select **Magic WAN** > **Sites**. -3. Select the site you want to configure > **Edit**. -4. Go to **Network**, and scroll down to **LAN configuration**. +2. Select **Magic WAN** > **Connector on-ramps**. +3. Select the Connector you want to configure > **Edit**. +4. Go to **Network Configuration**, and scroll down to **LAN configuration**. 5. Select **LAN policies**. 6. Select the policy you need to edit > **Edit**. 7. Make your changes, and select **Update policy**. @@ -202,9 +202,9 @@ https://api.cloudflare.com/client/v4/accounts/{account_id}/magic/sites/{site_id} 1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/login), and select your account. -2. Select **Magic WAN** > **Sites**. -3. Select the site you want to configure > **Edit**. -4. Go to **Network**, and scroll down to **LAN configuration**. +2. Select **Magic WAN** > **Connector on-ramps**. +3. Select the Connector you want to configure > **Edit**. +4. Go to **Network Configuration**, and scroll down to **LAN configuration**. 5. Select **LAN policies**. 6. Select the policy you need to edit > **Edit**. 7. Select **Delete**. From 761de72ab9035b6749bbda8c18124d0c86689e59 Mon Sep 17 00:00:00 2001 From: marciocloudflare Date: Thu, 16 Jan 2025 12:01:04 +0000 Subject: [PATCH 25/41] corrected interface address name tunnels --- .../partials/magic-transit/tunnel-endpoints/add-tunnels.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/content/partials/magic-transit/tunnel-endpoints/add-tunnels.mdx b/src/content/partials/magic-transit/tunnel-endpoints/add-tunnels.mdx index 163ca2efc85fb48..19a83ce507a3142 100644 --- a/src/content/partials/magic-transit/tunnel-endpoints/add-tunnels.mdx +++ b/src/content/partials/magic-transit/tunnel-endpoints/add-tunnels.mdx @@ -24,7 +24,7 @@ import { Details, Markdown, Render, TabItem, Tabs } from "~/components"; 5. In **Name**, give your tunnel a descriptive name. This name must be unique, must not contain spaces or special characters, and must be 15 or fewer characters. Hover the mouse over `i` in the dashboard for more information. 6. Give your tunnel a description in **Description**. You do not have character restrictions here. -7. In **Interface address**, enter the internal IP address for your tunnel along with the interface's prefix length (either `/31` or `/30`). This is used to route traffic through the tunnel on the Cloudflare side. We recommend using an RFC1918 address scheme with a `/31` netmask, as it provides the most efficient use of IP address space. +7. In **IPv4 Interface address**, enter the internal IP address for your tunnel along with the interface's prefix length (either `/31` or `/30`). This is used to route traffic through the tunnel on the Cloudflare side. We recommend using an RFC1918 address scheme with a `/31` netmask, as it provides the most efficient use of IP address space. 8. In **Customer GRE endpoint**, enter your router's public IP address. This value is not needed if you intend to use a physical or virtual connection like Cloudflare Network Interconnect because Cloudflare will provide it. 9. In **Cloudflare GRE endpoint**, enter the anycast address you received from your account team. 10. Leave the default values for **TTL** and **MTU**. @@ -43,7 +43,7 @@ import { Details, Markdown, Render, TabItem, Tabs } from "~/components"; 5. In **Name**, give your tunnel a descriptive name. This name must be unique, must not contain spaces or special characters, and must be 15 or fewer characters. Hover the mouse over `i` in the dashboard for more information. 6. Give your tunnel a description in **Description**. You do not have character restrictions here. -7. In **Interface address**, enter the internal IP address for your tunnel along with the interface's prefix length (either `/31` or `/30`). This is used to route traffic through the tunnel on the Cloudflare side. We recommend using an RFC1918 address scheme with a `/31` netmask, as it provides the most efficient use of IP address space. +7. In **IPv4 Interface address**, enter the internal IP address for your tunnel along with the interface's prefix length (either `/31` or `/30`). This is used to route traffic through the tunnel on the Cloudflare side. We recommend using an RFC1918 address scheme with a `/31` netmask, as it provides the most efficient use of IP address space. 8. In **Customer endpoint**, enter your router's public IP address. This value is only required if your router is using an IKE ID of type `ID_IPV4_ADDR`. 9. In **Cloudflare endpoint**, enter the anycast address you received from your account team. 10. _(Optional)_ **Tunnel health checks** are enabled by default. If you disable Tunnel health checks,, your tunnels will appear 100% down in your tunnel health dashboard even when working. Cloudflare will keep sending traffic through the tunnel, without the means to detect if the tunnel goes down. You will have to set up your own system to detect down tunnels, as Cloudflare will not be able to warn you about down tunnels. Refer to Tunnel health checks for more information. From ed6bdfbbed3c6e72dadece997a7a64e63984838e Mon Sep 17 00:00:00 2001 From: marciocloudflare Date: Thu, 16 Jan 2025 14:22:37 +0000 Subject: [PATCH 26/41] refined text --- .../magic-wan/configuration/common-settings/sites.mdx | 8 ++++++-- src/content/partials/magic-wan/sites-brief.mdx | 2 +- 2 files changed, 7 insertions(+), 3 deletions(-) diff --git a/src/content/docs/magic-wan/configuration/common-settings/sites.mdx b/src/content/docs/magic-wan/configuration/common-settings/sites.mdx index 01d3c47b541a5df..6a1517791726662 100644 --- a/src/content/docs/magic-wan/configuration/common-settings/sites.mdx +++ b/src/content/docs/magic-wan/configuration/common-settings/sites.mdx @@ -5,9 +5,13 @@ sidebar: order: 2 --- -Sites represent the local network of a data center, office or other physical location that combine all on-ramps used by your account. Sites also allow you to check, at a glance, the state of your on-ramps and set up health alert settings so that you get notified when there are issues with the site's on-ramps. +Sites represent the local network of a data center, office or other physical location, and combine all on-ramps available there. Sites also allow you to check, at a glance, the state of your on-ramps and set up health alert settings so that you get notified when there are issues with the site's on-ramps. To use a site, start by setting up your on-ramps. These can be [GRE or IPsec tunnels](/magic-wan/configuration/manually/how-to/configure-tunnels/), a [Magic WAN Connector](/magic-wan/configuration/connector/), or a direct [CNI link](/magic-wan/network-interconnect/). When you are finished setting these up, refer to the steps below to learn how to set up a site. 1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/) and select your account. -2. 2. Go to **Magic WAN** > **Network overview**. \ No newline at end of file +2. Go to **Magic WAN** > **Network overview**. +3. Select **Create site**. If this is not the first time you are adding a site, you will have the option **Add site** instead. +4. Add a name and description for your new site. Optionally, you can also add the geographical coordinates for your site in **Latitude** and **Longitude**. If you add geographical coordinates, once created your site's location will show in the map. +5. Select **Create and continue**. +6. Choose one or more on-ramps for your site from the list. \ No newline at end of file diff --git a/src/content/partials/magic-wan/sites-brief.mdx b/src/content/partials/magic-wan/sites-brief.mdx index 7b0bc0b5d29ce8a..15de422aac2c7aa 100644 --- a/src/content/partials/magic-wan/sites-brief.mdx +++ b/src/content/partials/magic-wan/sites-brief.mdx @@ -2,6 +2,6 @@ {} --- -Sites represent the local network of a data center, office or other physical location that combine all on-ramps used by your account. Sites also allow you to check, at a glance, the state of your on-ramps and set up health alert settings so that you get notified when there are issues with the site's on-ramps. +Sites represent the local network of a data center, office or other physical location, and combine all on-ramps available there. Sites also allow you to check, at a glance, the state of your on-ramps and set up health alert settings so that you get notified when there are issues with the site's on-ramps. Refer to [Set up a site](#) for more information. \ No newline at end of file From d6e173ce26d838fcc13b733a00aa550decc846c5 Mon Sep 17 00:00:00 2001 From: marciocloudflare Date: Thu, 16 Jan 2025 14:32:46 +0000 Subject: [PATCH 27/41] steps to add a site --- .../magic-wan/configuration/common-settings/sites.mdx | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) diff --git a/src/content/docs/magic-wan/configuration/common-settings/sites.mdx b/src/content/docs/magic-wan/configuration/common-settings/sites.mdx index 6a1517791726662..d5d3356ec6cdbe9 100644 --- a/src/content/docs/magic-wan/configuration/common-settings/sites.mdx +++ b/src/content/docs/magic-wan/configuration/common-settings/sites.mdx @@ -9,9 +9,18 @@ Sites represent the local network of a data center, office or other physical loc To use a site, start by setting up your on-ramps. These can be [GRE or IPsec tunnels](/magic-wan/configuration/manually/how-to/configure-tunnels/), a [Magic WAN Connector](/magic-wan/configuration/connector/), or a direct [CNI link](/magic-wan/network-interconnect/). When you are finished setting these up, refer to the steps below to learn how to set up a site. +## Add a site + 1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/) and select your account. 2. Go to **Magic WAN** > **Network overview**. 3. Select **Create site**. If this is not the first time you are adding a site, you will have the option **Add site** instead. 4. Add a name and description for your new site. Optionally, you can also add the geographical coordinates for your site in **Latitude** and **Longitude**. If you add geographical coordinates, once created your site's location will show in the map. 5. Select **Create and continue**. -6. Choose one or more on-ramps for your site from the list. \ No newline at end of file +6. Choose one or more on-ramps for your site from the list. Remember to only choose the on-ramps available to that particular site, as the list might show on-ramps available on other locations. +7. Select **Continue**. +8. In **Magic WAN Health Check Alert** > **Notification name**, enter a name for the site's alert. Health alerts notify you when there are issues with your site's on-ramps. +9. Under **Alert settings**, choose how you want to be notified when there is an issue. You can add webhooks as well as email addresses. +10. In **Alert sensitivity level** define the threshold for MAgic Tunnel health alerts to be fired. Available options are Low, Medium, and High. Refer to [Magic Tunnels background information](/magic-wan/reference/magic-tunnels/) for more information. +11. Select **Complete setup** to finish setting up your site. + +Your site is now set up. You should create new sites for every location you have, adding to it its respective on-ramps. \ No newline at end of file From c21ec93d8b39f3ea9788737efd9b0b4b6f488939 Mon Sep 17 00:00:00 2001 From: marciocloudflare Date: Thu, 16 Jan 2025 15:34:57 +0000 Subject: [PATCH 28/41] deleted old content --- .../magic-wan/analytics/site-analytics.mdx | 91 +------------------ 1 file changed, 4 insertions(+), 87 deletions(-) diff --git a/src/content/docs/magic-wan/analytics/site-analytics.mdx b/src/content/docs/magic-wan/analytics/site-analytics.mdx index 1c7f39f3d880150..d0720180178bfcd 100644 --- a/src/content/docs/magic-wan/analytics/site-analytics.mdx +++ b/src/content/docs/magic-wan/analytics/site-analytics.mdx @@ -1,98 +1,15 @@ --- -title: Site Analytics +title: Site analytics pcx_content_type: how-to sidebar: order: 1 head: - tag: title - content: Magic WAN Site Analytics + content: Magic WAN site analytics --- -import { Details } from "~/components" +After adding sites to your Magic WAN, the Network overview section of the dash provides you a summary of the connectivity status and traffic analytics for all your sites. This is a great place to start if you receive a Magic WAN alert, need to begin the troubleshooting process, or are performing routine monitoring. -Magic WAN Site Analytics provides an overview of the connectivity status and traffic analytics of all Magic WAN Connector sites. Magic WAN Site Analytics is a great place to start if you receive a Magic WAN alert, need to begin the Magic WAN Connector troubleshooting process, or are performing routine monitoring. +Refer to [Sites](#) for more information. -Magic WAN Site Analytics has the following data types available: - -
- - [Aggregate Magic WAN site health](#site-health) - - [Magic WAN availability status for sites](#no-status-available) - - [Magic WAN site geographic location](#no-location-available) -
- -
- - Site Name - - Site Health - - Site Tunnel Names - - Site Tunnel Statuses - - Site Traffic Sent - - Site Traffic Received -
- -
- - Traffic Sent by Tunnel - - Traffic Received by Tunnel -
- -To start using Magic WAN Site Analytics: - -1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/) and select your account. -2. Select **Magic WAN** > **Overview**. - -You will have access to an overview map with all your active sites, and any alerts for sites that are unhealthy or have no status available to them. - -Review the topics below to learn more about the options available to you. - -### All sites - -This section shows all the sites you configured with Magic WAN. At a glance, you can check: - -- How many active sites you have -- Sites that are healthy or unhealthy -- Sites that have no status available -- Sites that have no location set - -#### Site health - -Sites can be healthy or unhealthy, and Magic WAN uses this information to route traffic. Refer to [Set thresholds for Magic WAN site health](#set-thresholds-for-magic-wan-site-health) to learn more about this topic. - -#### No status available - -The status of a site refers to its health. If your sites show a **No status available** message, this means you did not configure your [Tunnel health check alerts](/magic-wan/configuration/common-settings/configure-magic-tunnel-alerts/). - -#### No location available - -The dashboard shows you the number of sites with no location set, meaning sites for which you did not set up a geographic location. To add a location to a site, find the site you want to add location to, and select **no location set** to edit its location settings. Refer to [Set geographic coordinates](#set-geographic-coordinates) for more information. - - -### Traffic overview - -Traffic overview aggregates all Magic WAN sites configured in your account. Here, you can check at-a-glance information about each site like: - -- Site status -- Traffic sent and received - -Select one of your sites to have access to a more detailed view of its traffic, including traffic by tunnel. - ---- - -## Configure Magic WAN Site Analytics - -### Set geographic coordinates - -When you create a site, you can set geographic coordinates in order for it to show on the Overview map. You can also add this information to sites you have already created. To add a Magic WAN site to the geographic map in the Overview page: - -1. Go to **Magic WAN** > **Sites**. -2. Select a specific site > **Edit**. -3. Scroll to **Site Location**. -4. Set the **latitude** and **longitude** coordinates of the Magic WAN Site. -5. Scroll down and select **Save**. -6. The Magic WAN Site will now appear on the geographic map in the Overview page. - -### Set thresholds for Magic WAN site health - -You can set Magic Tunnel health alerts to receive alerts when the percentage of successful health checks for a Magic Tunnel drops below the selected service-level objective (SLO). Setting health alerts will also show unhealthy tunnels in the Overview map: - -1. Configure [Magic Tunnel health alerts](/magic-wan/configuration/common-settings/configure-magic-tunnel-alerts/) across all of the Magic Tunnels associated with each Magic WAN Site. -2. After configuring Magic Tunnel health alerts, any Magic WAN Site with a Magic Tunnel that is outside of its SLO threshold will be labeled unhealthy in the Overview map. From b7c8cc76722c6e24a726beb792c56b6a5d534eb7 Mon Sep 17 00:00:00 2001 From: marciocloudflare Date: Thu, 16 Jan 2025 15:35:03 +0000 Subject: [PATCH 29/41] added site analytics info --- .../configuration/common-settings/sites.mdx | 111 +++++++++++++++++- 1 file changed, 108 insertions(+), 3 deletions(-) diff --git a/src/content/docs/magic-wan/configuration/common-settings/sites.mdx b/src/content/docs/magic-wan/configuration/common-settings/sites.mdx index d5d3356ec6cdbe9..bf886981951ebd5 100644 --- a/src/content/docs/magic-wan/configuration/common-settings/sites.mdx +++ b/src/content/docs/magic-wan/configuration/common-settings/sites.mdx @@ -5,6 +5,8 @@ sidebar: order: 2 --- +import { Details } from "~/components" + Sites represent the local network of a data center, office or other physical location, and combine all on-ramps available there. Sites also allow you to check, at a glance, the state of your on-ramps and set up health alert settings so that you get notified when there are issues with the site's on-ramps. To use a site, start by setting up your on-ramps. These can be [GRE or IPsec tunnels](/magic-wan/configuration/manually/how-to/configure-tunnels/), a [Magic WAN Connector](/magic-wan/configuration/connector/), or a direct [CNI link](/magic-wan/network-interconnect/). When you are finished setting these up, refer to the steps below to learn how to set up a site. @@ -18,9 +20,112 @@ To use a site, start by setting up your on-ramps. These can be [GRE or IPsec tun 5. Select **Create and continue**. 6. Choose one or more on-ramps for your site from the list. Remember to only choose the on-ramps available to that particular site, as the list might show on-ramps available on other locations. 7. Select **Continue**. -8. In **Magic WAN Health Check Alert** > **Notification name**, enter a name for the site's alert. Health alerts notify you when there are issues with your site's on-ramps. +8. In **Define alert settings** you set up alerts to notify you when there are issues with your site's on-ramps. If you want to set up alerts later, select **Skip this for now** to complete your setup. Otherwise, continue reading. +9. In **Magic WAN Health Check Alert** > **Notification name**, enter a name for the site's alert. Health. 9. Under **Alert settings**, choose how you want to be notified when there is an issue. You can add webhooks as well as email addresses. -10. In **Alert sensitivity level** define the threshold for MAgic Tunnel health alerts to be fired. Available options are Low, Medium, and High. Refer to [Magic Tunnels background information](/magic-wan/reference/magic-tunnels/) for more information. +10. In **Alert sensitivity level** define the threshold for Magic Tunnel health alerts to be fired. Available options are _Low_, _Medium_, and _High_. Refer to [Magic Tunnels background information](/magic-wan/reference/magic-tunnels/) for more information. 11. Select **Complete setup** to finish setting up your site. -Your site is now set up. You should create new sites for every location you have, adding to it its respective on-ramps. \ No newline at end of file +Your site is now set up. If you have other sites you need to set up, repeat the steps above. If you did not set up alerts, we strongly recommend that you do it. Otherwise you will not be notified when there is a problem with one of your on-ramps. + +--- + +## Site analytics + +After adding your sites, the Network overview section of the dash provides a summary of the connectivity status and traffic analytics for all your sites. This is a great place to start if you receive a Magic WAN alert, need to begin the troubleshooting process, or are performing routine monitoring. + +Network overview has the following data types available: + +
+ - [Aggregate Magic WAN site health](#site-health) + - [Magic WAN availability status for sites](#no-status-available) + - [Magic WAN site geographic location](#no-location-available) +
+ +
+ - Site Name + - Site Health + - Site Tunnel Names + - Site Tunnel Statuses + - Site Traffic Sent + - Site Traffic Received +
+ +
+ - Traffic Sent by Tunnel + - Traffic Received by Tunnel +
+ +To start using Magic WAN site analytics: + +1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/) and select your account. +2. Select **Magic WAN** > **Network overview**. + +You will have access to an overview map with all your active sites, and any alerts for sites that are unhealthy or have no status available to them. + +Review the topics below to learn more about the options available to you. + +### Network map and traffic overview + +The network map section shows all the sites configured with Magic WAN. At a glance, you can check: + +- How many active sites you have +- Location for sites in a map (if you set up their geographic location) +- Sites that are healthy or unhealthy +- Sites that have no status available +- Sites that have no location set + +Just below the map, Traffic overview shows a more granular list of your sites and their status. + +#### Site health + +Sites can be healthy or unhealthy, and Magic WAN uses this information to route traffic. Refer to [Set thresholds for Magic WAN site health](#set-thresholds-for-magic-wan-site-health) to learn more about this topic. + +#### No status available + +The status of a site refers to its health. If your sites show a **No status available** message, this means you did not configure your alert settings when creating your site. Refer to [Tunnel health check alerts](/magic-wan/configuration/common-settings/configure-magic-tunnel-alerts/) to learn how to create an alert for your site. + +#### No location set + +The dashboard shows you the number of sites with no location set, meaning sites for which you did not set up a geographic location. To add a location to a site, find the site you want to add location to, and select **no location set** to edit its location settings. Refer to [Set geographic coordinates](#set-geographic-coordinates) for more information. + + +### Traffic overview + +Traffic overview aggregates all Magic WAN sites configured in your account. Here, you can check at-a-glance information about each site like: + +- Site status +- Traffic sent and received + +Select one of your sites to have access to a more detailed view of its traffic, including traffic by tunnel. + +--- + +## Edit a site + +## Add or remove on-ramps + +1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/) and select your account. +2. Go to **Magic WAN** > **Network overview**. +3. Find your site in **Traffic overview** > select the three dots in front of it > **Edit**. +4. Select **On-ramps**. +5. Select **Add** to add a new on-ramp. +6. If you want to remove an on-ramp, select the three dots in front of your on-ramp > **Remove**. + +### Set geographic coordinates + +If you add geographic coordinates to your site, it will show up in the Network map. To set up or edit geographic coordinates to an existing site: + +1. Go to **Magic WAN** > **Network overview**. +2. Find your site in **Traffic overview** > select the three dots in front of it > **Edit**. +3. In **Basic information**, edit your site's **Latitude** and **Longitude** coordinates. +4. Select **Save**. + +### Set thresholds for Magic WAN site health + +When you set up an alert for your site, you will be notified when there is an issue with one or more on-ramps. These alerts are sent when the percentage of successful health checks for a Magic WAN on-ramp drops below the selected service-level objective (SLO). Setting health alerts will also show unhealthy tunnels in the Network map and in the Traffic overview sections. + +To set up health alerts: + +1. Configure [Magic Tunnel health alerts](/magic-wan/configuration/common-settings/configure-magic-tunnel-alerts/) across all of the Magic Tunnels associated with each Magic WAN site. +2. After configuring Magic Tunnel health alerts, any Magic WAN site with a Magic Tunnel (on-ramp) that is outside of its SLO threshold will be labeled unhealthy in Network map and Traffic overview. From 5151124168477b9e4d73d9591c759b7c52a29c6f Mon Sep 17 00:00:00 2001 From: marciocloudflare Date: Thu, 16 Jan 2025 15:46:42 +0000 Subject: [PATCH 30/41] link to sites --- src/content/docs/magic-wan/analytics/site-analytics.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/magic-wan/analytics/site-analytics.mdx b/src/content/docs/magic-wan/analytics/site-analytics.mdx index d0720180178bfcd..c61cdf5ae99e969 100644 --- a/src/content/docs/magic-wan/analytics/site-analytics.mdx +++ b/src/content/docs/magic-wan/analytics/site-analytics.mdx @@ -11,5 +11,5 @@ head: After adding sites to your Magic WAN, the Network overview section of the dash provides you a summary of the connectivity status and traffic analytics for all your sites. This is a great place to start if you receive a Magic WAN alert, need to begin the troubleshooting process, or are performing routine monitoring. -Refer to [Sites](#) for more information. +Refer to [Set up a site](/magic-wan/configuration/common-settings/sites/) for more information. From c25aa1fed9856033610393d2fdc964022f2f4f21 Mon Sep 17 00:00:00 2001 From: marciocloudflare Date: Thu, 16 Jan 2025 15:46:49 +0000 Subject: [PATCH 31/41] link to sites --- src/content/partials/magic-wan/sites-brief.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/partials/magic-wan/sites-brief.mdx b/src/content/partials/magic-wan/sites-brief.mdx index 15de422aac2c7aa..c7de8a0498a70e9 100644 --- a/src/content/partials/magic-wan/sites-brief.mdx +++ b/src/content/partials/magic-wan/sites-brief.mdx @@ -4,4 +4,4 @@ Sites represent the local network of a data center, office or other physical location, and combine all on-ramps available there. Sites also allow you to check, at a glance, the state of your on-ramps and set up health alert settings so that you get notified when there are issues with the site's on-ramps. -Refer to [Set up a site](#) for more information. \ No newline at end of file +Refer to [Set up a site](/magic-wan/configuration/common-settings/sites/) for more information. \ No newline at end of file From 17a452b2bfe4340a4ab4d9a5043f43a7d23d9c8a Mon Sep 17 00:00:00 2001 From: marciocloudflare Date: Thu, 16 Jan 2025 15:46:58 +0000 Subject: [PATCH 32/41] added beta to network overview --- .../configuration/common-settings/sites.mdx | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/src/content/docs/magic-wan/configuration/common-settings/sites.mdx b/src/content/docs/magic-wan/configuration/common-settings/sites.mdx index bf886981951ebd5..78c3a75e5e27cfd 100644 --- a/src/content/docs/magic-wan/configuration/common-settings/sites.mdx +++ b/src/content/docs/magic-wan/configuration/common-settings/sites.mdx @@ -1,5 +1,5 @@ --- -title: Sites +title: Set up a site pcx_content_type: how-to sidebar: order: 2 @@ -14,7 +14,7 @@ To use a site, start by setting up your on-ramps. These can be [GRE or IPsec tun ## Add a site 1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/) and select your account. -2. Go to **Magic WAN** > **Network overview**. +2. Go to **Magic WAN** > **Network overview (beta)**. 3. Select **Create site**. If this is not the first time you are adding a site, you will have the option **Add site** instead. 4. Add a name and description for your new site. Optionally, you can also add the geographical coordinates for your site in **Latitude** and **Longitude**. If you add geographical coordinates, once created your site's location will show in the map. 5. Select **Create and continue**. @@ -32,9 +32,9 @@ Your site is now set up. If you have other sites you need to set up, repeat the ## Site analytics -After adding your sites, the Network overview section of the dash provides a summary of the connectivity status and traffic analytics for all your sites. This is a great place to start if you receive a Magic WAN alert, need to begin the troubleshooting process, or are performing routine monitoring. +After adding your sites, the Network overview (beta) section of the dash provides a summary of the connectivity status and traffic analytics for all your sites. This is a great place to start if you receive a Magic WAN alert, need to begin the troubleshooting process, or are performing routine monitoring. -Network overview has the following data types available: +Network overview (beta) has the following data types available:
- [Aggregate Magic WAN site health](#site-health) @@ -59,7 +59,7 @@ Network overview has the following data types available: To start using Magic WAN site analytics: 1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/) and select your account. -2. Select **Magic WAN** > **Network overview**. +2. Select **Magic WAN** > **Network overview (beta)**. You will have access to an overview map with all your active sites, and any alerts for sites that are unhealthy or have no status available to them. @@ -106,7 +106,7 @@ Select one of your sites to have access to a more detailed view of its traffic, ## Add or remove on-ramps 1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/) and select your account. -2. Go to **Magic WAN** > **Network overview**. +2. Go to **Magic WAN** > **Network overview (beta)**. 3. Find your site in **Traffic overview** > select the three dots in front of it > **Edit**. 4. Select **On-ramps**. 5. Select **Add** to add a new on-ramp. @@ -116,7 +116,7 @@ Select one of your sites to have access to a more detailed view of its traffic, If you add geographic coordinates to your site, it will show up in the Network map. To set up or edit geographic coordinates to an existing site: -1. Go to **Magic WAN** > **Network overview**. +1. Go to **Magic WAN** > **Network overview (beta)**. 2. Find your site in **Traffic overview** > select the three dots in front of it > **Edit**. 3. In **Basic information**, edit your site's **Latitude** and **Longitude** coordinates. 4. Select **Save**. From b275aea107d10a7c765661c6272fa781c6d0c1bc Mon Sep 17 00:00:00 2001 From: marciocloudflare Date: Thu, 16 Jan 2025 15:49:28 +0000 Subject: [PATCH 33/41] added beta to connector on-ramps --- .../connector/network-options/dhcp/dhcp-relay.mdx | 2 +- .../connector/network-options/dhcp/dhcp-server.mdx | 2 +- .../connector/network-options/network-segmentation.mdx | 6 +++--- .../magic-wan/connector/app-aware-policies/add-app.mdx | 2 +- .../magic-wan/connector/app-aware-policies/delete-app.mdx | 2 +- .../partials/magic-wan/connector/connector-onramps.mdx | 2 +- 6 files changed, 8 insertions(+), 8 deletions(-) diff --git a/src/content/docs/magic-wan/configuration/connector/network-options/dhcp/dhcp-relay.mdx b/src/content/docs/magic-wan/configuration/connector/network-options/dhcp/dhcp-relay.mdx index 62656bf09b5d8ea..6c915387911f06b 100644 --- a/src/content/docs/magic-wan/configuration/connector/network-options/dhcp/dhcp-relay.mdx +++ b/src/content/docs/magic-wan/configuration/connector/network-options/dhcp/dhcp-relay.mdx @@ -29,7 +29,7 @@ To configure DHCP relay: 1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/) and select your account. -2. Go to **Magic WAN** > **Connector on-ramps**. +2. Go to **Magic WAN** > **Connector on-ramps (beta)**. 3. Select your Connector > **Edit**. 4. Select **Network Configuration**. 5. In **LAN configuration**, select the LAN where you need to configure DHCP relay. diff --git a/src/content/docs/magic-wan/configuration/connector/network-options/dhcp/dhcp-server.mdx b/src/content/docs/magic-wan/configuration/connector/network-options/dhcp/dhcp-server.mdx index 172e1eff7cdb26f..00999b28b2e45d1 100644 --- a/src/content/docs/magic-wan/configuration/connector/network-options/dhcp/dhcp-server.mdx +++ b/src/content/docs/magic-wan/configuration/connector/network-options/dhcp/dhcp-server.mdx @@ -10,7 +10,7 @@ When you use a static IP address, Magic WAN Connector can also act as a DHCP ser 1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/) and select your account. -2. Go to **Magic WAN** > **Connector on-ramps**. +2. Go to **Magic WAN** > **Connector on-ramps (beta)**. 3. Select your Connector > **Edit**. 4. Select **Network Configuration**. 5. In **LAN configuration**, select the LAN where you want to enable DHCP server. diff --git a/src/content/docs/magic-wan/configuration/connector/network-options/network-segmentation.mdx b/src/content/docs/magic-wan/configuration/connector/network-options/network-segmentation.mdx index cfd7bbd58d7037f..3748b9c4f4cd0eb 100644 --- a/src/content/docs/magic-wan/configuration/connector/network-options/network-segmentation.mdx +++ b/src/content/docs/magic-wan/configuration/connector/network-options/network-segmentation.mdx @@ -42,7 +42,7 @@ The following guide assumes you have already created a site and configured your Follow the steps below to create a new LAN policy to segment your network. Only the fields marked **required** are mandatory. 1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/login), and select your account. -2. Select **Magic WAN** > **Connector on-ramps**. +2. Select **Magic WAN** > **Connector on-ramps (beta)**. 3. Select the Connector you want to configure > **Edit**. 4. Go to **Network Configuration**, and scroll down to **LAN configuration**. 5. Select **LAN policies** > **Create Policy**. @@ -142,7 +142,7 @@ The new policy will ensure that traffic between the specified LANs flows locally 1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/login), and select your account. -2. Select **Magic WAN** > **Connector on-ramps**. +2. Select **Magic WAN** > **Connector on-ramps (beta)**. 3. Select the Connector you want to configure > **Edit**. 4. Go to **Network Configuration**, and scroll down to **LAN configuration**. 5. Select **LAN policies**. @@ -202,7 +202,7 @@ https://api.cloudflare.com/client/v4/accounts/{account_id}/magic/sites/{site_id} 1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/login), and select your account. -2. Select **Magic WAN** > **Connector on-ramps**. +2. Select **Magic WAN** > **Connector on-ramps (beta)**. 3. Select the Connector you want to configure > **Edit**. 4. Go to **Network Configuration**, and scroll down to **LAN configuration**. 5. Select **LAN policies**. diff --git a/src/content/partials/magic-wan/connector/app-aware-policies/add-app.mdx b/src/content/partials/magic-wan/connector/app-aware-policies/add-app.mdx index 7acae29e2df3d6e..fe74094de03b259 100644 --- a/src/content/partials/magic-wan/connector/app-aware-policies/add-app.mdx +++ b/src/content/partials/magic-wan/connector/app-aware-policies/add-app.mdx @@ -6,7 +6,7 @@ params: import { Markdown } from "~/components"; 1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/login), and select your account. -2. Select **Magic WAN** > **Connector on-ramps**. +2. Select **Magic WAN** > **Connector on-ramps (beta)**. 3. Select the Connector you want to configure > **Edit**. 4. Select **Traffic Steering**. 5. In **{props.featureName}**, select **Add**. \ No newline at end of file diff --git a/src/content/partials/magic-wan/connector/app-aware-policies/delete-app.mdx b/src/content/partials/magic-wan/connector/app-aware-policies/delete-app.mdx index c4b957ee08bf869..cd3fed14cfa4229 100644 --- a/src/content/partials/magic-wan/connector/app-aware-policies/delete-app.mdx +++ b/src/content/partials/magic-wan/connector/app-aware-policies/delete-app.mdx @@ -6,7 +6,7 @@ params: import { Markdown } from "~/components"; 1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/login), and select your account. -2. Select **Magic WAN** > **Connector on-ramps**. +2. Select **Magic WAN** > **Connector on-ramps (beta)**. 3. Select the Connector you want to configure > **Edit**. 4. Select **Traffic Steering**. 5. In **{props.featureName}**, find the application you want to delete, and select the **three dots** next to it. diff --git a/src/content/partials/magic-wan/connector/connector-onramps.mdx b/src/content/partials/magic-wan/connector/connector-onramps.mdx index 22a31e978e0521e..dda2d537d0e1c3b 100644 --- a/src/content/partials/magic-wan/connector/connector-onramps.mdx +++ b/src/content/partials/magic-wan/connector/connector-onramps.mdx @@ -14,7 +14,7 @@ You need to add your Connector to your Cloudflare dashboard and configure its se To add a Connector on-ramp: 1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/) and select your account. -2. Go to **Magic WAN** > **Connector on-ramps**. +2. Go to **Magic WAN** > **Connector on-ramps (beta)**. 3. Select **Add**. 4. In **Name**, enter a descriptive name for your Connector. Optionally, you can also add a description for it. 5. You need to decide if you want to turn on high availability for the Connector. Refer to [About high availability configurations](#about-high-availability-configurations) for more information. From 227301606680735412cc10d6082240388df4c235 Mon Sep 17 00:00:00 2001 From: marciocloudflare Date: Fri, 31 Jan 2025 11:17:51 +0000 Subject: [PATCH 34/41] added sites to flow --- .../configuration/manually/how-to/configure-tunnels.mdx | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/src/content/docs/magic-wan/configuration/manually/how-to/configure-tunnels.mdx b/src/content/docs/magic-wan/configuration/manually/how-to/configure-tunnels.mdx index 638d0d0cfbdc633..52280290c1c54f4 100644 --- a/src/content/docs/magic-wan/configuration/manually/how-to/configure-tunnels.mdx +++ b/src/content/docs/magic-wan/configuration/manually/how-to/configure-tunnels.mdx @@ -73,6 +73,10 @@ import { GlossaryTooltip, Render } from "~/components"; }} /> +## Add a site + +Now that you have configured your tunnels, the next step is to create a site. + ## Bidirectional vs unidirectional health checks Date: Fri, 31 Jan 2025 11:25:09 +0000 Subject: [PATCH 35/41] refined text --- .../configuration/manually/how-to/configure-tunnels.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/content/docs/magic-wan/configuration/manually/how-to/configure-tunnels.mdx b/src/content/docs/magic-wan/configuration/manually/how-to/configure-tunnels.mdx index 52280290c1c54f4..a2743de4784f523 100644 --- a/src/content/docs/magic-wan/configuration/manually/how-to/configure-tunnels.mdx +++ b/src/content/docs/magic-wan/configuration/manually/how-to/configure-tunnels.mdx @@ -91,6 +91,6 @@ Now that you have configured your tunnels, the next step is to create a site. static routes to route your traffic through Cloudflare. +- Now that you have set up your tunnel endpoints, you need to configure static routes to route your traffic through Cloudflare.
If you are connecting to Cloudflare through a [Direct CNI connection](/network-interconnect/express-cni/), you can [configure BGP routing](/magic-wan/configuration/manually/how-to/bgp-peering/) instead. -If you are connecting to Cloudflare through a [Direct CNI connection](/network-interconnect/express-cni/), you can [configure BGP routing](/magic-wan/configuration/manually/how-to/bgp-peering/) instead. +- After configuring either static routes or BGP routing, you will have to [set up a site](/magic-wan/configuration/common-settings/sites/). From cb1dc5c7cd14007c62078939317072f8512c2be5 Mon Sep 17 00:00:00 2001 From: marciocloudflare Date: Fri, 31 Jan 2025 11:25:36 +0000 Subject: [PATCH 36/41] removed site from workflow --- .../configuration/manually/how-to/configure-tunnels.mdx | 4 ---- 1 file changed, 4 deletions(-) diff --git a/src/content/docs/magic-wan/configuration/manually/how-to/configure-tunnels.mdx b/src/content/docs/magic-wan/configuration/manually/how-to/configure-tunnels.mdx index a2743de4784f523..debfd6f9398377f 100644 --- a/src/content/docs/magic-wan/configuration/manually/how-to/configure-tunnels.mdx +++ b/src/content/docs/magic-wan/configuration/manually/how-to/configure-tunnels.mdx @@ -73,10 +73,6 @@ import { GlossaryTooltip, Render } from "~/components"; }} /> -## Add a site - -Now that you have configured your tunnels, the next step is to create a site. - ## Bidirectional vs unidirectional health checks Date: Fri, 31 Jan 2025 11:29:01 +0000 Subject: [PATCH 37/41] refined step number --- src/content/partials/magic-wan/connector/connector-onramps.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/partials/magic-wan/connector/connector-onramps.mdx b/src/content/partials/magic-wan/connector/connector-onramps.mdx index dda2d537d0e1c3b..a1b6be736572852 100644 --- a/src/content/partials/magic-wan/connector/connector-onramps.mdx +++ b/src/content/partials/magic-wan/connector/connector-onramps.mdx @@ -130,6 +130,6 @@ Magic WAN Connector supports different types of DHCP configurations. Connector c Refer to [DHCP options](/magic-wan/configuration/connector/network-options/dhcp/) to learn more. -### 4 Add your Connector to a site +### 4. Add your Connector to a site After finishing your Connector configuration, you need to add it to a site. \ No newline at end of file From 4874ecde8a1be36fea348c01d14b3abbc003b89b Mon Sep 17 00:00:00 2001 From: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com> Date: Tue, 11 Feb 2025 12:50:42 +0000 Subject: [PATCH 38/41] Apply suggestions from code review Co-authored-by: Pedro Sousa <680496+pedrosousa@users.noreply.github.com> --- .../docs/magic-wan/analytics/site-analytics.mdx | 2 +- .../magic-wan/configuration/common-settings/sites.mdx | 10 +++++----- .../connector/configure-hardware-connector/index.mdx | 2 +- .../connector/configure-virtual-connector.mdx | 2 +- .../connector/network-options/dhcp/dhcp-server.mdx | 2 +- .../partials/magic-wan/connector/before-you-begin.mdx | 2 +- src/content/partials/magic-wan/sites-brief.mdx | 2 +- 7 files changed, 11 insertions(+), 11 deletions(-) diff --git a/src/content/docs/magic-wan/analytics/site-analytics.mdx b/src/content/docs/magic-wan/analytics/site-analytics.mdx index c61cdf5ae99e969..ab69a383ebe2c62 100644 --- a/src/content/docs/magic-wan/analytics/site-analytics.mdx +++ b/src/content/docs/magic-wan/analytics/site-analytics.mdx @@ -9,7 +9,7 @@ head: --- -After adding sites to your Magic WAN, the Network overview section of the dash provides you a summary of the connectivity status and traffic analytics for all your sites. This is a great place to start if you receive a Magic WAN alert, need to begin the troubleshooting process, or are performing routine monitoring. +After adding sites to your Magic WAN, the Network overview section of the dashboard provides you a summary of the connectivity status and traffic analytics for all your sites. This is a great place to start if you receive a Magic WAN alert, need to begin the troubleshooting process, or are performing routine monitoring. Refer to [Set up a site](/magic-wan/configuration/common-settings/sites/) for more information. diff --git a/src/content/docs/magic-wan/configuration/common-settings/sites.mdx b/src/content/docs/magic-wan/configuration/common-settings/sites.mdx index 78c3a75e5e27cfd..07d7dd06fdf334d 100644 --- a/src/content/docs/magic-wan/configuration/common-settings/sites.mdx +++ b/src/content/docs/magic-wan/configuration/common-settings/sites.mdx @@ -7,7 +7,7 @@ sidebar: import { Details } from "~/components" -Sites represent the local network of a data center, office or other physical location, and combine all on-ramps available there. Sites also allow you to check, at a glance, the state of your on-ramps and set up health alert settings so that you get notified when there are issues with the site's on-ramps. +Sites represent the local network of a data center, office, or other physical location, and combine all on-ramps available there. Sites also allow you to check, at a glance, the state of your on-ramps and set up health alert settings so that you get notified when there are issues with the site's on-ramps. To use a site, start by setting up your on-ramps. These can be [GRE or IPsec tunnels](/magic-wan/configuration/manually/how-to/configure-tunnels/), a [Magic WAN Connector](/magic-wan/configuration/connector/), or a direct [CNI link](/magic-wan/network-interconnect/). When you are finished setting these up, refer to the steps below to learn how to set up a site. @@ -21,7 +21,7 @@ To use a site, start by setting up your on-ramps. These can be [GRE or IPsec tun 6. Choose one or more on-ramps for your site from the list. Remember to only choose the on-ramps available to that particular site, as the list might show on-ramps available on other locations. 7. Select **Continue**. 8. In **Define alert settings** you set up alerts to notify you when there are issues with your site's on-ramps. If you want to set up alerts later, select **Skip this for now** to complete your setup. Otherwise, continue reading. -9. In **Magic WAN Health Check Alert** > **Notification name**, enter a name for the site's alert. Health. +9. In **Magic WAN Health Check Alert** > **Notification name**, enter a name for the site's alert. 9. Under **Alert settings**, choose how you want to be notified when there is an issue. You can add webhooks as well as email addresses. 10. In **Alert sensitivity level** define the threshold for Magic Tunnel health alerts to be fired. Available options are _Low_, _Medium_, and _High_. Refer to [Magic Tunnels background information](/magic-wan/reference/magic-tunnels/) for more information. 11. Select **Complete setup** to finish setting up your site. @@ -32,14 +32,14 @@ Your site is now set up. If you have other sites you need to set up, repeat the ## Site analytics -After adding your sites, the Network overview (beta) section of the dash provides a summary of the connectivity status and traffic analytics for all your sites. This is a great place to start if you receive a Magic WAN alert, need to begin the troubleshooting process, or are performing routine monitoring. +After adding your sites, the Network overview (beta) section of the dashboard provides a summary of the connectivity status and traffic analytics for all your sites. This is a great place to start if you receive a Magic WAN alert, need to begin the troubleshooting process, or are performing routine monitoring. Network overview (beta) has the following data types available:
- [Aggregate Magic WAN site health](#site-health) - [Magic WAN availability status for sites](#no-status-available) - - [Magic WAN site geographic location](#no-location-available) + - [Magic WAN site geographic location](#no-location-set)
@@ -83,7 +83,7 @@ Sites can be healthy or unhealthy, and Magic WAN uses this information to route #### No status available -The status of a site refers to its health. If your sites show a **No status available** message, this means you did not configure your alert settings when creating your site. Refer to [Tunnel health check alerts](/magic-wan/configuration/common-settings/configure-magic-tunnel-alerts/) to learn how to create an alert for your site. +The status of a site refers to its health. If your sites show a **No status available** message, this means you did not configure your alert settings when creating your site. Refer to [Configure Magic Tunnel health alerts](/magic-wan/configuration/common-settings/configure-magic-tunnel-alerts/) to learn how to create an alert for your site. #### No location set diff --git a/src/content/docs/magic-wan/configuration/connector/configure-hardware-connector/index.mdx b/src/content/docs/magic-wan/configuration/connector/configure-hardware-connector/index.mdx index d8f423ee1cfb5da..3f7ab16b54776cf 100644 --- a/src/content/docs/magic-wan/configuration/connector/configure-hardware-connector/index.mdx +++ b/src/content/docs/magic-wan/configuration/connector/configure-hardware-connector/index.mdx @@ -135,7 +135,7 @@ Make sure you complete the setup workflow and activate your Magic WAN Connector 1. Connect Magic WAN Connector to a DHCP port with access to the Internet. 2. [Add a Connector on-ramp](#1-add-a-connector-on-ramp) in the Cloudflare dashboard. 3. Create a [DHCP WAN](#2-create-a-wan). -4. [Active](#activate-connector) and power on your Connector. +4. [Activate](#activate-connector) and power on your Connector. 5. Wait 60 seconds. 6. Make changes to the [WAN settings](#2-create-a-wan) in the Cloudflare dashboard to a static IP set up. 7. Wait 60 seconds again. diff --git a/src/content/docs/magic-wan/configuration/connector/configure-virtual-connector.mdx b/src/content/docs/magic-wan/configuration/connector/configure-virtual-connector.mdx index e21a3d2511476c3..c43ed53ca365329 100644 --- a/src/content/docs/magic-wan/configuration/connector/configure-virtual-connector.mdx +++ b/src/content/docs/magic-wan/configuration/connector/configure-virtual-connector.mdx @@ -144,7 +144,7 @@ Make sure you complete the setup workflow and activate your Virtual Connector be 1. Connect the machine where you installed the VM with Virtual Connector to a DHCP port with access to the Internet. 2. [Add a Connector on-ramp](#1-add-a-connector-on-ramp) in the Cloudflare dashboard. 3. Create a [DHCP WAN](#2-create-a-wan). -4. [Active](#activate-connector) and boot your Virtual Connector. +4. [Activate](#activate-connector) and boot your Virtual Connector. 5. Wait 60 seconds. 6. Make changes to the [WAN settings](#2-create-a-wan) in the Cloudflare dashboard to a static IP set up. 7. Wait 60 seconds again. diff --git a/src/content/docs/magic-wan/configuration/connector/network-options/dhcp/dhcp-server.mdx b/src/content/docs/magic-wan/configuration/connector/network-options/dhcp/dhcp-server.mdx index 00999b28b2e45d1..64c889d6d8bb564 100644 --- a/src/content/docs/magic-wan/configuration/connector/network-options/dhcp/dhcp-server.mdx +++ b/src/content/docs/magic-wan/configuration/connector/network-options/dhcp/dhcp-server.mdx @@ -11,7 +11,7 @@ When you use a static IP address, Magic WAN Connector can also act as a DHCP ser 1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/) and select your account. 2. Go to **Magic WAN** > **Connector on-ramps (beta)**. -3. Select your Connector > **Edit**. +3. Select the Connector you want to configure > **Edit**. 4. Select **Network Configuration**. 5. In **LAN configuration**, select the LAN where you want to enable DHCP server. 6. Select **Edit**. diff --git a/src/content/partials/magic-wan/connector/before-you-begin.mdx b/src/content/partials/magic-wan/connector/before-you-begin.mdx index 907d2d0a02955d2..fe8cbe3f604700e 100644 --- a/src/content/partials/magic-wan/connector/before-you-begin.mdx +++ b/src/content/partials/magic-wan/connector/before-you-begin.mdx @@ -21,5 +21,5 @@ You must decide the type of configuration you want for your site from the beginn :::caution -You cannot enable high availability for an existing Connector on-rap. To add high availability to an existing Connector on-ramp in the Cloudflare dashboard, you need to delete the on-ramp and start again. Plan accordingly to create a high availability configuration from the start if needed. +You cannot enable high availability for an existing Connector on-ramp. To add high availability to an existing Connector on-ramp in the Cloudflare dashboard, you need to delete the on-ramp and start again. Plan accordingly to create a high availability configuration from the start if needed. ::: diff --git a/src/content/partials/magic-wan/sites-brief.mdx b/src/content/partials/magic-wan/sites-brief.mdx index c7de8a0498a70e9..438f10623c90a6a 100644 --- a/src/content/partials/magic-wan/sites-brief.mdx +++ b/src/content/partials/magic-wan/sites-brief.mdx @@ -2,6 +2,6 @@ {} --- -Sites represent the local network of a data center, office or other physical location, and combine all on-ramps available there. Sites also allow you to check, at a glance, the state of your on-ramps and set up health alert settings so that you get notified when there are issues with the site's on-ramps. +Sites represent the local network of a data center, office, or other physical location, and combine all on-ramps available there. Sites also allow you to check, at a glance, the state of your on-ramps and set up health alert settings so that you get notified when there are issues with the site's on-ramps. Refer to [Set up a site](/magic-wan/configuration/common-settings/sites/) for more information. \ No newline at end of file From 0034e71a5c70de2a9f0b05968fffcde27ca1d8db Mon Sep 17 00:00:00 2001 From: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com> Date: Tue, 11 Feb 2025 12:52:37 +0000 Subject: [PATCH 39/41] Update src/content/docs/magic-wan/configuration/common-settings/sites.mdx Co-authored-by: Pedro Sousa <680496+pedrosousa@users.noreply.github.com> --- .../docs/magic-wan/configuration/common-settings/sites.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/magic-wan/configuration/common-settings/sites.mdx b/src/content/docs/magic-wan/configuration/common-settings/sites.mdx index 07d7dd06fdf334d..ad1934cfc7592eb 100644 --- a/src/content/docs/magic-wan/configuration/common-settings/sites.mdx +++ b/src/content/docs/magic-wan/configuration/common-settings/sites.mdx @@ -103,7 +103,7 @@ Select one of your sites to have access to a more detailed view of its traffic, ## Edit a site -## Add or remove on-ramps +### Add or remove on-ramps 1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/) and select your account. 2. Go to **Magic WAN** > **Network overview (beta)**. From dbfc947fec5fbace747045e261ee0bf0f571cd72 Mon Sep 17 00:00:00 2001 From: marciocloudflare Date: Tue, 11 Feb 2025 12:59:31 +0000 Subject: [PATCH 40/41] step consistent with network segmentation --- .../connector/network-options/dhcp/dhcp-server.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/magic-wan/configuration/connector/network-options/dhcp/dhcp-server.mdx b/src/content/docs/magic-wan/configuration/connector/network-options/dhcp/dhcp-server.mdx index 64c889d6d8bb564..fd0da78a43083cb 100644 --- a/src/content/docs/magic-wan/configuration/connector/network-options/dhcp/dhcp-server.mdx +++ b/src/content/docs/magic-wan/configuration/connector/network-options/dhcp/dhcp-server.mdx @@ -12,7 +12,7 @@ When you use a static IP address, Magic WAN Connector can also act as a DHCP ser 1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/) and select your account. 2. Go to **Magic WAN** > **Connector on-ramps (beta)**. 3. Select the Connector you want to configure > **Edit**. -4. Select **Network Configuration**. +4. Select **Network Configuration**, and scroll down to **LAN configuration**. 5. In **LAN configuration**, select the LAN where you want to enable DHCP server. 6. Select **Edit**. 7. Under **Static addressing**, select **This is a DHCP Server**. You also have to specify: From a9e7472f762e40cc4d5297f0f5e82574a1849a35 Mon Sep 17 00:00:00 2001 From: marciocloudflare Date: Tue, 11 Feb 2025 13:00:36 +0000 Subject: [PATCH 41/41] added beta --- src/content/docs/magic-wan/analytics/site-analytics.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/magic-wan/analytics/site-analytics.mdx b/src/content/docs/magic-wan/analytics/site-analytics.mdx index ab69a383ebe2c62..95c377d9fd37f75 100644 --- a/src/content/docs/magic-wan/analytics/site-analytics.mdx +++ b/src/content/docs/magic-wan/analytics/site-analytics.mdx @@ -9,7 +9,7 @@ head: --- -After adding sites to your Magic WAN, the Network overview section of the dashboard provides you a summary of the connectivity status and traffic analytics for all your sites. This is a great place to start if you receive a Magic WAN alert, need to begin the troubleshooting process, or are performing routine monitoring. +After adding sites to your Magic WAN, the Network overview (beta) section of the dashboard provides you a summary of the connectivity status and traffic analytics for all your sites. This is a great place to start if you receive a Magic WAN alert, need to begin the troubleshooting process, or are performing routine monitoring. Refer to [Set up a site](/magic-wan/configuration/common-settings/sites/) for more information.