From fecb64524b7cdb6c561d0462f39b670d9717a88a Mon Sep 17 00:00:00 2001 From: marciocloudflare Date: Thu, 5 Dec 2024 09:47:43 +0000 Subject: [PATCH 01/22] moved prereqs to top --- .../connector/configure-hardware-connector/index.mdx | 12 ++++++------ .../connector/configure-virtual-connector.mdx | 12 ++++++++---- 2 files changed, 14 insertions(+), 10 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 6084dadae15f3e9..6a74db211a8d8bc 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 @@ -8,12 +8,6 @@ sidebar: import { GlossaryTooltip, Render, Card } from "~/components"; -## Before you begin - - - ---- - ## Prerequisites You need to purchase [Magic WAN](https://www.cloudflare.com/magic-wan/) before you can purchase and use the Magic WAN Connector. The Magic WAN Connector can function as your primary edge device for your network, or be deployed in-line with existing network gear. @@ -24,6 +18,12 @@ Contact your account representative to learn more about purchasing options for t --- +## Before you begin + + + +--- + ## Port speeds The hardware version of the Magic WAN connector includes two [SFP+ ports](https://en.wikipedia.org/wiki/Small_Form-factor_Pluggable) that support 10G throughput, as well as six RJ45 ports that support 1G throughput. 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 0f8f35add75b9a7..6a47e4cd9758cd6 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 @@ -9,10 +9,6 @@ import { Render } from "~/components"; Virtual Magic WAN Connector (Virtual Connector) is a virtual appliance alternative to the hardware based Magic WAN Connector appliance. These two versions of Connector are identical otherwise. -## Before you begin - - - ## Prerequisites Before you can install Virtual Connector, you need an Enterprise account with Magic WAN enabled. Additionally, you need to have a VMware host with sufficient compute, memory, and storage to run the virtual machine with Virtual Connector. This includes: @@ -27,6 +23,14 @@ Before you can install Virtual Connector, you need an Enterprise account with Ma Refer to [VMware's documentation](https://docs.vmware.com/en/VMware-vSphere/7.0/com.vmware.esxi.install.doc/GUID-B2F01BF5-078A-4C7E-B505-5DFFED0B8C38.html) for more information on how to install ESXi and configure a virtual machine. +--- + +## Before you begin + + + +--- + ## Obtain the Virtual Connector image Contact your account team at Cloudflare to obtain the Virtual Connector [OVA package](https://docs.vmware.com/en/VMware-vSphere/7.0/com.vmware.vsphere.vm_admin.doc/GUID-AE61948B-C2EE-436E-BAFB-3C7209088552.html) and license keys. The OVA image includes the files required to install and configure the virtual machine (VM) for Virtual Connector with the appropriate settings. From f4e1c7708e3e3051fe37b3225389b8807c31c076 Mon Sep 17 00:00:00 2001 From: marciocloudflare Date: Thu, 5 Dec 2024 09:59:39 +0000 Subject: [PATCH 02/22] added h2 with static ip info --- .../configure-hardware-connector/index.mdx | 15 +++++++++++++++ 1 file changed, 15 insertions(+) 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 6a74db211a8d8bc..0a45dc2f4c258db 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 @@ -24,6 +24,21 @@ Contact your account representative to learn more about purchasing options for t --- +## DHCP vs static IP connections + +Magic WAN Connector uses a DHCP connection at first boot to download your settings and go through the activation process. If you need to use a static IP in your Connector, and this is a fresh install: +- Connect Magic WAN Connector to a DHCP port with access to the Internet +- Go through the setup flow below +- Activate your Connector +- Wait 60 seconds after activating +- Edit your WAN IP settings in the dashboard +- Wait 60 seconds again +- Adjust your physical connections as required to match the static IP configuration + +Fore more information, read the setup flow below. + +--- + ## Port speeds The hardware version of the Magic WAN connector includes two [SFP+ ports](https://en.wikipedia.org/wiki/Small_Form-factor_Pluggable) that support 10G throughput, as well as six RJ45 ports that support 1G throughput. From 488494af3d764cb19d157351e41e6111c26dd9b2 Mon Sep 17 00:00:00 2001 From: marciocloudflare Date: Thu, 5 Dec 2024 10:09:30 +0000 Subject: [PATCH 03/22] changed to ordered list --- .../configure-hardware-connector/index.mdx | 14 +++++++------- 1 file changed, 7 insertions(+), 7 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 0a45dc2f4c258db..61adbc8e632c0d1 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 @@ -27,13 +27,13 @@ Contact your account representative to learn more about purchasing options for t ## DHCP vs static IP connections Magic WAN Connector uses a DHCP connection at first boot to download your settings and go through the activation process. If you need to use a static IP in your Connector, and this is a fresh install: -- Connect Magic WAN Connector to a DHCP port with access to the Internet -- Go through the setup flow below -- Activate your Connector -- Wait 60 seconds after activating -- Edit your WAN IP settings in the dashboard -- Wait 60 seconds again -- Adjust your physical connections as required to match the static IP configuration +1. Connect Magic WAN Connector to a DHCP port with access to the Internet +2. Go through the setup flow below +3. Activate your Connector +4. Wait 60 seconds after activating +5. Edit your WAN IP settings in the dashboard +6. Wait 60 seconds again +7. Adjust your physical connections as required to match the static IP configuration Fore more information, read the setup flow below. From 2d1c33b5bddc5e731ba3f2df6ca4f131778066ad Mon Sep 17 00:00:00 2001 From: marciocloudflare Date: Thu, 5 Dec 2024 10:09:38 +0000 Subject: [PATCH 04/22] updated WAN language --- src/content/partials/magic-wan/connector/create-site.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/partials/magic-wan/connector/create-site.mdx b/src/content/partials/magic-wan/connector/create-site.mdx index d485dc81468c61a..370b3fcf630ca8d 100644 --- a/src/content/partials/magic-wan/connector/create-site.mdx +++ b/src/content/partials/magic-wan/connector/create-site.mdx @@ -77,7 +77,7 @@ Take note of the site `id` parameter, as you will need it to create WANs and LAN 3. **Interface number** 4. In **VLAN ID**, enter a number between `0` and `4094` to specify a [VLAN ID](/magic-wan/configuration/connector/reference/#vlan-id). 5. In **Priority**, choose the priority for your WAN. Lower numbers have higher priority. Refer to Traffic steering to learn more about how Cloudflare calculates priorities. -6. **Addressing**: If this is the first time you are setting up your Magic WAN Connector, select **DHCP**. After you activate your Connector, you can then choose to continue fetching the WAN IP address from a DHCP server, or change it to a static IP. If you choose a static IP, you also need to specify the static IP and gateway addresses. +6. **Addressing**: Select **DHCP**. This is needed the first time you set up your Connector to successfully download all settings to the machine and activate it. If you need a static IP address in your network environment, refer to [WAN with a static IP address](#wan-with-a-static-ip-address) **after you activate your Connector**.
If you choose a static IP, you also need to specify the static IP and gateway addresses.
From bc00230be106143ce17e7365513decf29582c842 Mon Sep 17 00:00:00 2001 From: marciocloudflare Date: Thu, 5 Dec 2024 10:29:33 +0000 Subject: [PATCH 05/22] refined info --- .../configure-hardware-connector/index.mdx | 23 +++++++++++++------ 1 file changed, 16 insertions(+), 7 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 61adbc8e632c0d1..447185dfc207638 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 @@ -35,7 +35,7 @@ Magic WAN Connector uses a DHCP connection at first boot to download your settin 6. Wait 60 seconds again 7. Adjust your physical connections as required to match the static IP configuration -Fore more information, read the setup flow below. +Fore more information, read the [Set up Cloudflare dashboard](#set-up-cloudflare-dashboard) flow below. --- @@ -130,14 +130,23 @@ If there is a firewall deployed upstream of the Magic WAN Connector, configure t ### WAN with a static IP address -After activating your Connector, you can use it in a network configuration with the WAN interface set to a static IP address - that is, an Internet configuration that is not automatically set by DHCP. +After activating your Connector, you can use it in a network configuration with the WAN interface set to a static IP address — that is, an Internet configuration that is not automatically set by DHCP. To use your Connector on a network configuration with a static IP, follow the steps below. -To use your Connector on a network configuration with a static IP: +:::caution +Before proceeding, make sure that you went through the setup workflow and activated your Magic WAN Connector. +::: -1. Wait 60 seconds after activating your Connector. -2. Unplug the physical connection to the Internet-connected device which provides DHCP. -3. Adjust your physical connections as required to match the static configuration, and make changes to the [WAN settings](#2-create-a-wan) in the Cloudflare dashboard to reflect the static IP address configuration. -4. Power cycle the Connector. +1. Connect Magic WAN Connector to a DHCP port with access to the Internet +2. [Add 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 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 --- From 60a13aa8be3e4e79ab93ba1b2ac138fb0dbd3a12 Mon Sep 17 00:00:00 2001 From: marciocloudflare Date: Thu, 5 Dec 2024 10:29:40 +0000 Subject: [PATCH 06/22] refined wan steps --- src/content/partials/magic-wan/connector/create-site.mdx | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/src/content/partials/magic-wan/connector/create-site.mdx b/src/content/partials/magic-wan/connector/create-site.mdx index 370b3fcf630ca8d..c417ce093ad0d31 100644 --- a/src/content/partials/magic-wan/connector/create-site.mdx +++ b/src/content/partials/magic-wan/connector/create-site.mdx @@ -77,7 +77,9 @@ Take note of the site `id` parameter, as you will need it to create WANs and LAN 3. **Interface number** 4. In **VLAN ID**, enter a number between `0` and `4094` to specify a [VLAN ID](/magic-wan/configuration/connector/reference/#vlan-id). 5. In **Priority**, choose the priority for your WAN. Lower numbers have higher priority. Refer to Traffic steering to learn more about how Cloudflare calculates priorities. -6. **Addressing**: Select **DHCP**. This is needed the first time you set up your Connector to successfully download all settings to the machine and activate it. If you need a static IP address in your network environment, refer to [WAN with a static IP address](#wan-with-a-static-ip-address) **after you activate your Connector**.
If you choose a static IP, you also need to specify the static IP and gateway addresses. +6. **Addressing**: Select **DHCP**. This is needed the first time you set up your Connector to successfully download all settings to the machine and activate it. If you need a static IP address in your network environment: + 1. Continue the set up flow below to activate your Connector + 2. Refer to [WAN with a static IP address](#wan-with-a-static-ip-address). If you choose a static IP, you also need to specify the static IP and gateway addresses.
From 895f8f3e013e0915d8aca4eee4ed7255b034ed1b Mon Sep 17 00:00:00 2001 From: marciocloudflare Date: Thu, 5 Dec 2024 10:36:35 +0000 Subject: [PATCH 07/22] removed extra spaces --- .../partials/magic-wan/connector/create-site.mdx | 14 +------------- 1 file changed, 1 insertion(+), 13 deletions(-) diff --git a/src/content/partials/magic-wan/connector/create-site.mdx b/src/content/partials/magic-wan/connector/create-site.mdx index c417ce093ad0d31..9965a8de67de106 100644 --- a/src/content/partials/magic-wan/connector/create-site.mdx +++ b/src/content/partials/magic-wan/connector/create-site.mdx @@ -119,30 +119,18 @@ curl https://api.cloudflare.com/client/v4/accounts/{account_id}/magic/sites/{sit 1. In **LAN configuration**, select **Create**. - 2. Enter a descriptive name for your LAN in **Interface name**. - 3. **Interface number** - 4. In **VLAN ID**, specify a [VLAN ID](/magic-wan/configuration/connector/reference/#vlan-id) to create virtual LANs. - 5. In **Static addressing** > **Static address** give your Connector's LAN interface its IP address. You can also enable the following options if they suit your use case: - - **This is a DHCP server**: If your Connector is a [DHCP server](/magic-wan/configuration/connector/network-options/dhcp/dhcp-server/). - **This is a DHCP relay**: If your Connector is a [DHCP relay](/magic-wan/configuration/connector/network-options/dhcp/dhcp-relay/). - 6. (Optional) In **Directly attached subnet** > **Static NAT prefix**, enter a CIDR prefix to enable NAT (network address translation). The prefix you enter here should be the same size as the prefix entered in **Static addressing**. For example, both networks have a subnet mask of `/24`: `192.168.100.0/24` and `10.10.100.0/24`. - 7. (Optional) If your LAN contains additional subnets behind a layer 3 router, select **Add routed subnet** under **Routed subnets** to add them: - - **Prefix**: The CIDR prefix for the subnet behind the L3 router. - **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. - + - **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). From a472cbdeddf690cc7ebe29e254ce041003629ae4 Mon Sep 17 00:00:00 2001 From: marciocloudflare Date: Thu, 5 Dec 2024 10:39:59 +0000 Subject: [PATCH 08/22] created wan static partials --- .../magic-wan/connector/dhcp-vs-static-ip.mdx | 14 +++++++++++++ .../connector/wan-with-static-ip.mdx | 21 +++++++++++++++++++ 2 files changed, 35 insertions(+) create mode 100644 src/content/partials/magic-wan/connector/dhcp-vs-static-ip.mdx create mode 100644 src/content/partials/magic-wan/connector/wan-with-static-ip.mdx diff --git a/src/content/partials/magic-wan/connector/dhcp-vs-static-ip.mdx b/src/content/partials/magic-wan/connector/dhcp-vs-static-ip.mdx new file mode 100644 index 000000000000000..86807980fe38b4a --- /dev/null +++ b/src/content/partials/magic-wan/connector/dhcp-vs-static-ip.mdx @@ -0,0 +1,14 @@ +--- +{} +--- + +Magic WAN Connector uses a DHCP connection at first boot to download your settings and go through the activation process. If you need to use a static IP in your Connector, and this is a fresh install: +1. Connect Magic WAN Connector to a DHCP port with access to the Internet +2. Go through the setup flow below +3. Activate your Connector +4. Wait 60 seconds after activating +5. Edit your WAN IP settings in the dashboard +6. Wait 60 seconds again +7. Adjust your physical connections as required to match the static IP configuration + +Fore more information, read the [Set up Cloudflare dashboard](#set-up-cloudflare-dashboard) flow below. \ No newline at end of file diff --git a/src/content/partials/magic-wan/connector/wan-with-static-ip.mdx b/src/content/partials/magic-wan/connector/wan-with-static-ip.mdx new file mode 100644 index 000000000000000..ff5f24851f6c67d --- /dev/null +++ b/src/content/partials/magic-wan/connector/wan-with-static-ip.mdx @@ -0,0 +1,21 @@ +--- +{} +--- + +After activating your Connector, you can use it in a network configuration with the WAN interface set to a static IP address — that is, an Internet configuration that is not automatically set by DHCP. To use your Connector on a network configuration with a static IP, follow the steps below. + +:::caution +Before proceeding, make sure that you went through the setup workflow and activated your Magic WAN Connector. +::: + +1. Connect Magic WAN Connector to a DHCP port with access to the Internet +2. [Add 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 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 \ No newline at end of file From dc768ad9684ada4a32c1bcbf854bfd90008182af Mon Sep 17 00:00:00 2001 From: marciocloudflare Date: Thu, 5 Dec 2024 10:40:14 +0000 Subject: [PATCH 09/22] updated with wan partials --- .../configure-hardware-connector/index.mdx | 29 ++----------------- 1 file changed, 2 insertions(+), 27 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 447185dfc207638..10053f4ead45e96 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 @@ -26,16 +26,7 @@ Contact your account representative to learn more about purchasing options for t ## DHCP vs static IP connections -Magic WAN Connector uses a DHCP connection at first boot to download your settings and go through the activation process. If you need to use a static IP in your Connector, and this is a fresh install: -1. Connect Magic WAN Connector to a DHCP port with access to the Internet -2. Go through the setup flow below -3. Activate your Connector -4. Wait 60 seconds after activating -5. Edit your WAN IP settings in the dashboard -6. Wait 60 seconds again -7. Adjust your physical connections as required to match the static IP configuration - -Fore more information, read the [Set up Cloudflare dashboard](#set-up-cloudflare-dashboard) flow below. + --- @@ -130,23 +121,7 @@ If there is a firewall deployed upstream of the Magic WAN Connector, configure t ### WAN with a static IP address -After activating your Connector, you can use it in a network configuration with the WAN interface set to a static IP address — that is, an Internet configuration that is not automatically set by DHCP. To use your Connector on a network configuration with a static IP, follow the steps below. - -:::caution -Before proceeding, make sure that you went through the setup workflow and activated your Magic WAN Connector. -::: - -1. Connect Magic WAN Connector to a DHCP port with access to the Internet -2. [Add 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 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 + Date: Thu, 5 Dec 2024 10:40:44 +0000 Subject: [PATCH 10/22] corrected partial --- .../connector/configure-hardware-connector/index.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) 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 10053f4ead45e96..7d9aa6a4c4780ca 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 @@ -121,7 +121,7 @@ If there is a firewall deployed upstream of the Magic WAN Connector, configure t ### WAN with a static IP address - --- From aaa16d2cdcf49c933f45390e147078975c6281bc Mon Sep 17 00:00:00 2001 From: marciocloudflare Date: Thu, 5 Dec 2024 10:42:22 +0000 Subject: [PATCH 11/22] added wan static virtual conn --- .../connector/configure-virtual-connector.mdx | 15 +++++++-------- 1 file changed, 7 insertions(+), 8 deletions(-) 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 6a47e4cd9758cd6..47323334542bb55 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 @@ -31,6 +31,12 @@ Refer to [VMware's documentation](https://docs.vmware.com/en/VMware-vSphere/7.0/ --- +## DHCP vs static IP connections + + + +--- + ## Obtain the Virtual Connector image Contact your account team at Cloudflare to obtain the Virtual Connector [OVA package](https://docs.vmware.com/en/VMware-vSphere/7.0/com.vmware.vsphere.vm_admin.doc/GUID-AE61948B-C2EE-436E-BAFB-3C7209088552.html) and license keys. The OVA image includes the files required to install and configure the virtual machine (VM) for Virtual Connector with the appropriate settings. @@ -127,14 +133,7 @@ You cannot use the same license key twice, or reuse a key once the virtual machi ### WAN with a static IP address -After activating your Virtual Connector, you can use it in a network configuration with the WAN interface set to a static IP address - that is, an Internet configuration that is not automatically set by DHCP. - -To use your Virtual Connector on a network configuration with a static IP: - -1. Wait 60 seconds after activating your Connector. -2. Modify your Port Groups as needed to change the source from which the WAN port obtains its IP address. -3. [Adjust the WAN settings](#2-create-a-wan) in the Cloudflare dashboard to reflect the new static IP address configuration. -4. Reboot your virtual machine. + ## Boot your Virtual Connector From 16ba80a55ffbc1a2728237fe982fa6735efd1c24 Mon Sep 17 00:00:00 2001 From: marciocloudflare Date: Thu, 5 Dec 2024 10:47:47 +0000 Subject: [PATCH 12/22] reverted partial wan with static --- .../configure-hardware-connector/index.mdx | 18 +++++++++++++++- .../connector/configure-virtual-connector.mdx | 17 +++++++-------- .../connector/wan-with-static-ip.mdx | 21 ------------------- 3 files changed, 25 insertions(+), 31 deletions(-) delete mode 100644 src/content/partials/magic-wan/connector/wan-with-static-ip.mdx 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 7d9aa6a4c4780ca..b7da5ab8a94c62b 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 @@ -121,7 +121,23 @@ If there is a firewall deployed upstream of the Magic WAN Connector, configure t ### WAN with a static IP address - +After activating your Connector, you can use it in a network configuration with the WAN interface set to a static IP address — that is, an Internet configuration that is not automatically set by DHCP. To use your Connector on a network configuration with a static IP, follow the steps below. + +:::caution +Before proceeding, make sure that you went through the setup workflow and activated your Magic WAN Connector. +::: + +1. Connect Magic WAN Connector to a DHCP port with access to the Internet +2. [Add 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 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 --- 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 47323334542bb55..c5a7ac3dab67132 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 @@ -29,14 +29,6 @@ Refer to [VMware's documentation](https://docs.vmware.com/en/VMware-vSphere/7.0/ ---- - -## DHCP vs static IP connections - - - ---- - ## Obtain the Virtual Connector image Contact your account team at Cloudflare to obtain the Virtual Connector [OVA package](https://docs.vmware.com/en/VMware-vSphere/7.0/com.vmware.vsphere.vm_admin.doc/GUID-AE61948B-C2EE-436E-BAFB-3C7209088552.html) and license keys. The OVA image includes the files required to install and configure the virtual machine (VM) for Virtual Connector with the appropriate settings. @@ -133,7 +125,14 @@ You cannot use the same license key twice, or reuse a key once the virtual machi ### WAN with a static IP address - +After activating your Virtual Connector, you can use it in a network configuration with the WAN interface set to a static IP address - that is, an Internet configuration that is not automatically set by DHCP. + +To use your Virtual Connector on a network configuration with a static IP: + +1. Wait 60 seconds after activating your Connector. +2. Modify your Port Groups as needed to change the source from which the WAN port obtains its IP address. +3. [Adjust the WAN settings](#2-create-a-wan) in the Cloudflare dashboard to reflect the new static IP address configuration. +4. Reboot your virtual machine. ## Boot your Virtual Connector diff --git a/src/content/partials/magic-wan/connector/wan-with-static-ip.mdx b/src/content/partials/magic-wan/connector/wan-with-static-ip.mdx deleted file mode 100644 index ff5f24851f6c67d..000000000000000 --- a/src/content/partials/magic-wan/connector/wan-with-static-ip.mdx +++ /dev/null @@ -1,21 +0,0 @@ ---- -{} ---- - -After activating your Connector, you can use it in a network configuration with the WAN interface set to a static IP address — that is, an Internet configuration that is not automatically set by DHCP. To use your Connector on a network configuration with a static IP, follow the steps below. - -:::caution -Before proceeding, make sure that you went through the setup workflow and activated your Magic WAN Connector. -::: - -1. Connect Magic WAN Connector to a DHCP port with access to the Internet -2. [Add 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 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 \ No newline at end of file From 73df056edcab2beb51cd521868ebbf128ec9e359 Mon Sep 17 00:00:00 2001 From: marciocloudflare Date: Thu, 5 Dec 2024 10:52:41 +0000 Subject: [PATCH 13/22] removed partial --- .../configure-hardware-connector/index.mdx | 11 ++++++++++- .../connector/configure-virtual-connector.mdx | 11 +++++++++++ .../magic-wan/connector/dhcp-vs-static-ip.mdx | 14 -------------- 3 files changed, 21 insertions(+), 15 deletions(-) delete mode 100644 src/content/partials/magic-wan/connector/dhcp-vs-static-ip.mdx 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 b7da5ab8a94c62b..4c1b4a7100f02ad 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 @@ -20,7 +20,16 @@ Contact your account representative to learn more about purchasing options for t ## Before you begin - +Magic WAN Connector uses a DHCP connection at first boot to download your settings and go through the activation process. If you need to use a static IP in your Connector, and this is a fresh install: +1. Connect Magic WAN Connector to a DHCP port with access to the Internet +2. Go through the setup flow below +3. Activate your Connector +4. Wait 60 seconds after activating +5. Edit your WAN IP settings in the dashboard +6. Wait 60 seconds again +7. Adjust your physical connections as required to match the static IP configuration + +Fore more information, read the [Set up Cloudflare dashboard](#set-up-cloudflare-dashboard) flow below. --- 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 c5a7ac3dab67132..022e33e31899cd8 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 @@ -29,6 +29,17 @@ Refer to [VMware's documentation](https://docs.vmware.com/en/VMware-vSphere/7.0/ +--- + +## DHCP vs static IP connections + + + ## Obtain the Virtual Connector image Contact your account team at Cloudflare to obtain the Virtual Connector [OVA package](https://docs.vmware.com/en/VMware-vSphere/7.0/com.vmware.vsphere.vm_admin.doc/GUID-AE61948B-C2EE-436E-BAFB-3C7209088552.html) and license keys. The OVA image includes the files required to install and configure the virtual machine (VM) for Virtual Connector with the appropriate settings. diff --git a/src/content/partials/magic-wan/connector/dhcp-vs-static-ip.mdx b/src/content/partials/magic-wan/connector/dhcp-vs-static-ip.mdx deleted file mode 100644 index 86807980fe38b4a..000000000000000 --- a/src/content/partials/magic-wan/connector/dhcp-vs-static-ip.mdx +++ /dev/null @@ -1,14 +0,0 @@ ---- -{} ---- - -Magic WAN Connector uses a DHCP connection at first boot to download your settings and go through the activation process. If you need to use a static IP in your Connector, and this is a fresh install: -1. Connect Magic WAN Connector to a DHCP port with access to the Internet -2. Go through the setup flow below -3. Activate your Connector -4. Wait 60 seconds after activating -5. Edit your WAN IP settings in the dashboard -6. Wait 60 seconds again -7. Adjust your physical connections as required to match the static IP configuration - -Fore more information, read the [Set up Cloudflare dashboard](#set-up-cloudflare-dashboard) flow below. \ No newline at end of file From f179bb8eea5522b6d71da6e493ed5cf04411be32 Mon Sep 17 00:00:00 2001 From: marciocloudflare Date: Thu, 5 Dec 2024 10:53:26 +0000 Subject: [PATCH 14/22] corrected text --- .../configure-hardware-connector/index.mdx | 12 +++++------ .../magic-wan/connector/dhcp-vs-static-ip.mdx | 5 +++++ .../connector/wan-with-static-ip.mdx | 21 +++++++++++++++++++ 3 files changed, 32 insertions(+), 6 deletions(-) create mode 100644 src/content/partials/magic-wan/connector/dhcp-vs-static-ip.mdx create mode 100644 src/content/partials/magic-wan/connector/wan-with-static-ip.mdx 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 4c1b4a7100f02ad..447185dfc207638 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 @@ -20,6 +20,12 @@ Contact your account representative to learn more about purchasing options for t ## Before you begin + + +--- + +## DHCP vs static IP connections + Magic WAN Connector uses a DHCP connection at first boot to download your settings and go through the activation process. If you need to use a static IP in your Connector, and this is a fresh install: 1. Connect Magic WAN Connector to a DHCP port with access to the Internet 2. Go through the setup flow below @@ -33,12 +39,6 @@ Fore more information, read the [Set up Cloudflare dashboard](#set-up-cloudflare --- -## DHCP vs static IP connections - - - ---- - ## Port speeds The hardware version of the Magic WAN connector includes two [SFP+ ports](https://en.wikipedia.org/wiki/Small_Form-factor_Pluggable) that support 10G throughput, as well as six RJ45 ports that support 1G throughput. diff --git a/src/content/partials/magic-wan/connector/dhcp-vs-static-ip.mdx b/src/content/partials/magic-wan/connector/dhcp-vs-static-ip.mdx new file mode 100644 index 000000000000000..28839ad6c8c4f46 --- /dev/null +++ b/src/content/partials/magic-wan/connector/dhcp-vs-static-ip.mdx @@ -0,0 +1,5 @@ +--- +params: + - name +--- + diff --git a/src/content/partials/magic-wan/connector/wan-with-static-ip.mdx b/src/content/partials/magic-wan/connector/wan-with-static-ip.mdx new file mode 100644 index 000000000000000..ff5f24851f6c67d --- /dev/null +++ b/src/content/partials/magic-wan/connector/wan-with-static-ip.mdx @@ -0,0 +1,21 @@ +--- +{} +--- + +After activating your Connector, you can use it in a network configuration with the WAN interface set to a static IP address — that is, an Internet configuration that is not automatically set by DHCP. To use your Connector on a network configuration with a static IP, follow the steps below. + +:::caution +Before proceeding, make sure that you went through the setup workflow and activated your Magic WAN Connector. +::: + +1. Connect Magic WAN Connector to a DHCP port with access to the Internet +2. [Add 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 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 \ No newline at end of file From 75fbb77a42b504deb1697413d051df9cc8d53736 Mon Sep 17 00:00:00 2001 From: marciocloudflare Date: Thu, 5 Dec 2024 10:59:54 +0000 Subject: [PATCH 15/22] reworked dhcp vs static ip --- .../connector/configure-hardware-connector/index.mdx | 10 ++-------- .../connector/configure-virtual-connector.mdx | 11 +++++------ 2 files changed, 7 insertions(+), 14 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 447185dfc207638..589827d89766463 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 @@ -28,14 +28,8 @@ Contact your account representative to learn more about purchasing options for t Magic WAN Connector uses a DHCP connection at first boot to download your settings and go through the activation process. If you need to use a static IP in your Connector, and this is a fresh install: 1. Connect Magic WAN Connector to a DHCP port with access to the Internet -2. Go through the setup flow below -3. Activate your Connector -4. Wait 60 seconds after activating -5. Edit your WAN IP settings in the dashboard -6. Wait 60 seconds again -7. Adjust your physical connections as required to match the static IP configuration - -Fore more information, read the [Set up Cloudflare dashboard](#set-up-cloudflare-dashboard) flow below. +2. Go through the [setup flow](#set-up-cloudflare-dashboard) below and activate your Connector +3. Refer to [WAN with a static IP address](#wan-with-a-static-ip-address) --- 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 022e33e31899cd8..828661e05d47722 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 @@ -33,12 +33,11 @@ Refer to [VMware's documentation](https://docs.vmware.com/en/VMware-vSphere/7.0/ ## DHCP vs static IP connections - +Virtual Connector uses a DHCP connection at first boot to download your settings and go through the activation process. If you need to use a static IP in your Virtual Connector, and this is a fresh install: +1. Connect the machine with your Virtual Connector VM to a DHCP port with access to the Internet +2. Go through the [setup flow](#set-up-cloudflare-dashboard) below and activate your Connector +3. Refer to [WAN with a static IP address](#wan-with-a-static-ip-address) + ## Obtain the Virtual Connector image From 1dee5761ab366eb22c3afa072b740221a90cf0b0 Mon Sep 17 00:00:00 2001 From: marciocloudflare Date: Thu, 5 Dec 2024 11:42:47 +0000 Subject: [PATCH 16/22] refined text and steps --- .../connector/configure-virtual-connector.mdx | 34 ++++++++++++------- 1 file changed, 22 insertions(+), 12 deletions(-) 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 828661e05d47722..8399ea2fb8e287f 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 @@ -33,7 +33,7 @@ Refer to [VMware's documentation](https://docs.vmware.com/en/VMware-vSphere/7.0/ ## DHCP vs static IP connections -Virtual Connector uses a DHCP connection at first boot to download your settings and go through the activation process. If you need to use a static IP in your Virtual Connector, and this is a fresh install: +Virtual Connector uses a DHCP connection at first boot to download your settings and go through the activation process. If you need to use a static IP in your Virtual Connector, however, and this is a fresh install: 1. Connect the machine with your Virtual Connector VM to a DHCP port with access to the Internet 2. Go through the [setup flow](#set-up-cloudflare-dashboard) below and activate your Connector 3. Refer to [WAN with a static IP address](#wan-with-a-static-ip-address) @@ -133,17 +133,6 @@ You cannot use the same license key twice, or reuse a key once the virtual machi }} /> -### WAN with a static IP address - -After activating your Virtual Connector, you can use it in a network configuration with the WAN interface set to a static IP address - that is, an Internet configuration that is not automatically set by DHCP. - -To use your Virtual Connector on a network configuration with a static IP: - -1. Wait 60 seconds after activating your Connector. -2. Modify your Port Groups as needed to change the source from which the WAN port obtains its IP address. -3. [Adjust the WAN settings](#2-create-a-wan) in the Cloudflare dashboard to reflect the new static IP address configuration. -4. Reboot your virtual machine. - ## Boot your Virtual Connector 1. Go to **Virtual Machines** in VMware, and boot up Virtual Connector's VM. @@ -154,6 +143,27 @@ To use your Virtual Connector on a network configuration with a static IP: --- +## WAN with a static IP address + +After activating your Virtual Connector, you can use it in a network configuration with the WAN interface set to a static IP address - that is, an Internet configuration that is not automatically set by DHCP. To use your Virtual Connector on a network configuration with a static IP follow the steps below. + +:::caution +Before proceeding, make sure that you went through the setup workflow and activated your Virtual Connector. +::: + +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. + +--- + Date: Thu, 5 Dec 2024 11:42:59 +0000 Subject: [PATCH 17/22] refined text and steps --- .../configure-hardware-connector/index.mdx | 26 +++++++++---------- 1 file changed, 13 insertions(+), 13 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 589827d89766463..33df6ab7e76f4b9 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 @@ -26,7 +26,7 @@ Contact your account representative to learn more about purchasing options for t ## DHCP vs static IP connections -Magic WAN Connector uses a DHCP connection at first boot to download your settings and go through the activation process. If you need to use a static IP in your Connector, and this is a fresh install: +Magic WAN Connector uses a DHCP connection at first boot to download your settings and go through the activation process. If you need to use a static IP in your Connector, however, and this is a fresh install: 1. Connect Magic WAN Connector to a DHCP port with access to the Internet 2. Go through the [setup flow](#set-up-cloudflare-dashboard) below and activate your Connector 3. Refer to [WAN with a static IP address](#wan-with-a-static-ip-address) @@ -124,23 +124,23 @@ If there is a firewall deployed upstream of the Magic WAN Connector, configure t ### WAN with a static IP address -After activating your Connector, you can use it in a network configuration with the WAN interface set to a static IP address — that is, an Internet configuration that is not automatically set by DHCP. To use your Connector on a network configuration with a static IP, follow the steps below. +After activating your Connector, you can use it in a network configuration with the WAN interface set to a static IP address — that is, an Internet configuration that is not automatically set by DHCP. To use your Connector on a network configuration with a static IP follow the steps below. :::caution Before proceeding, make sure that you went through the setup workflow and activated your Magic WAN Connector. ::: -1. Connect Magic WAN Connector to a DHCP port with access to the Internet -2. [Add 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 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 +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. --- From 8274e347a8416e5462ec817cc137a36fb8d78d15 Mon Sep 17 00:00:00 2001 From: marciocloudflare Date: Thu, 5 Dec 2024 11:53:38 +0000 Subject: [PATCH 18/22] removed extra spaces --- .../connector/configure-virtual-connector.mdx | 16 +++------------- 1 file changed, 3 insertions(+), 13 deletions(-) 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 8399ea2fb8e287f..a652d34ab36846c 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 @@ -38,7 +38,6 @@ Virtual Connector uses a DHCP connection at first boot to download your settings 2. Go through the [setup flow](#set-up-cloudflare-dashboard) below and activate your Connector 3. Refer to [WAN with a static IP address](#wan-with-a-static-ip-address) - ## Obtain the Virtual Connector image Contact your account team at Cloudflare to obtain the Virtual Connector [OVA package](https://docs.vmware.com/en/VMware-vSphere/7.0/com.vmware.vsphere.vm_admin.doc/GUID-AE61948B-C2EE-436E-BAFB-3C7209088552.html) and license keys. The OVA image includes the files required to install and configure the virtual machine (VM) for Virtual Connector with the appropriate settings. @@ -52,9 +51,9 @@ You will consume one license key for each instance created. For example, if you The following instructions assume you already have VMware ESXi hypervisor installed with sufficient resources. Refer to [Prerequisites](#prerequisites) for more information. 1. When setting up your VMware ESXi, you need to create port groups for Virtual Connector. Go to **Networking** > **Port groups**, and prepare your vSwitch port groups and/or VLANs for your desired network topology. For example, a simple deployment typically has: - - A WAN port group where the Virtual Connector will get an IP address (static or DHCP) that has access to the Internet. - - A LAN port group, where the Virtual Connector will act as default router, and possibly DHCP server. - - A null, or unused, port group for allocating unused virtual interfaces in the Virtual Connector. You can, for example, create a null port group with the name of `Null port group`, and a **VLAN ID** of `999`. + - A WAN port group where the Virtual Connector will get an IP address (static or DHCP) that has access to the Internet. + - A LAN port group, where the Virtual Connector will act as default router, and possibly DHCP server. + - A null, or unused, port group for allocating unused virtual interfaces in the Virtual Connector. You can, for example, create a null port group with the name of `Null port group`, and a **VLAN ID** of `999`. :::note[VLAN tagging] Virtual Connector supports creating subinterfaces through the use of [802.1Q VLAN tagging](https://en.wikipedia.org/wiki/IEEE_802.1Q). @@ -78,25 +77,16 @@ Refer to [VMWare's documentation](https://kb.vmware.com/s/article/1003825) for m Take note of the folder where you are extracting the files to, as you will need to refer to that folder when creating the VM. 3. Go to **Virtual Machines** > **Create/Register VM** wizard to start deploying the Virtual Connector. - 4. Select **Deploy a virtual machine from an OVF or OVA file** > **Next**. - 5. Choose a descriptive name for your virtual machine. - 6. Upload the files you have extracted from the OVA image. These include `mconn.ovf`, `mconn.nvram`, and `mconn.vmdk`. - 7. Select where you want to save the files extracted from the OVA image > **Next**. - 8. In **Networking mappings**, select assignments for your desired topology according to the port groups you set up previously: - 1. For example, map `eno1` port to `VM Network` to create your WAN, and `eno2` to `LAN0` to act as your LAN port. 2. Allocate any unused ports to the `null` port group. 3. Take note of your configuration. You will need this information to configure your network in the Cloudflare dashboard. - 9. In **Disk provisioning**, select **Thin**. - 10. Before completing the deployment wizard, disable **Power on automatically**. This is important so that you can configure the license key prior to boot. - 11. Configure the virtual machine with the license key your account team provided you: 1. Select the Virtual Connector's VM > **Settings**. 2. Go to **VM Options** > **Advanced** > **Edit Configuration**. From 0df9515600f2be1b81ba58ba19dcdb9b58f3b546 Mon Sep 17 00:00:00 2001 From: marciocloudflare Date: Thu, 5 Dec 2024 11:58:42 +0000 Subject: [PATCH 19/22] replaced spaces by tabs --- .../connector/configure-virtual-connector.mdx | 24 +++++++++---------- 1 file changed, 12 insertions(+), 12 deletions(-) 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 a652d34ab36846c..669c19d4d2ff7cc 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 @@ -70,11 +70,11 @@ Refer to [VMWare's documentation](https://kb.vmware.com/s/article/1003825) for m 2. Extract the files in the OVA image provided by your Cloudflare account team. For example: - ```txt - tar -xvf mconn-2024-1-3.ova - ``` + ```txt + tar -xvf mconn-2024-1-3.ova + ``` - Take note of the folder where you are extracting the files to, as you will need to refer to that folder when creating the VM. + Take note of the folder where you are extracting the files to, as you will need to refer to that folder when creating the VM. 3. Go to **Virtual Machines** > **Create/Register VM** wizard to start deploying the Virtual Connector. 4. Select **Deploy a virtual machine from an OVF or OVA file** > **Next**. @@ -82,17 +82,17 @@ Refer to [VMWare's documentation](https://kb.vmware.com/s/article/1003825) for m 6. Upload the files you have extracted from the OVA image. These include `mconn.ovf`, `mconn.nvram`, and `mconn.vmdk`. 7. Select where you want to save the files extracted from the OVA image > **Next**. 8. In **Networking mappings**, select assignments for your desired topology according to the port groups you set up previously: - 1. For example, map `eno1` port to `VM Network` to create your WAN, and `eno2` to `LAN0` to act as your LAN port. - 2. Allocate any unused ports to the `null` port group. - 3. Take note of your configuration. You will need this information to configure your network in the Cloudflare dashboard. + 1. For example, map `eno1` port to `VM Network` to create your WAN, and `eno2` to `LAN0` to act as your LAN port. + 2. Allocate any unused ports to the `null` port group. + 3. Take note of your configuration. You will need this information to configure your network in the Cloudflare dashboard. 9. In **Disk provisioning**, select **Thin**. 10. Before completing the deployment wizard, disable **Power on automatically**. This is important so that you can configure the license key prior to boot. 11. Configure the virtual machine with the license key your account team provided you: - 1. Select the Virtual Connector's VM > **Settings**. - 2. Go to **VM Options** > **Advanced** > **Edit Configuration**. - 3. Select **Add parameter** to add your license key. Scroll down to the last entry (this is where VMware adds the new parameter), and add the following two new entries: - - **Key**: `guestinfo.cloudflare.identity` - - **Value**: `` + 1. Select the Virtual Connector's VM > **Settings**. + 2. Go to **VM Options** > **Advanced** > **Edit Configuration**. + 3. Select **Add parameter** to add your license key. Scroll down to the last entry (this is where VMware adds the new parameter), and add the following two new entries: + - **Key**: `guestinfo.cloudflare.identity` + - **Value**: `` :::note You cannot use the same license key twice, or reuse a key once the virtual machine has been registered with Cloudflare. You need a new key from your account team for every new Virtual Connector. From e06af4482f28a58da963b97352116545d2d10282 Mon Sep 17 00:00:00 2001 From: marciocloudflare Date: Thu, 5 Dec 2024 12:00:06 +0000 Subject: [PATCH 20/22] refined steps --- .../connector/configure-hardware-connector/index.mdx | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) 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 33df6ab7e76f4b9..524d70120d669b0 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 @@ -122,7 +122,9 @@ If there is a firewall deployed upstream of the Magic WAN Connector, configure t }} /> -### WAN with a static IP address +--- + +## WAN with a static IP address After activating your Connector, you can use it in a network configuration with the WAN interface set to a static IP address — that is, an Internet configuration that is not automatically set by DHCP. To use your Connector on a network configuration with a static IP follow the steps below. From 671d458e909d5b03fdfb21d844b7a40ed21d9f2d Mon Sep 17 00:00:00 2001 From: marciocloudflare Date: Thu, 5 Dec 2024 12:02:46 +0000 Subject: [PATCH 21/22] deleted unnecessary partials --- .../magic-wan/connector/dhcp-vs-static-ip.mdx | 5 ----- .../connector/wan-with-static-ip.mdx | 21 ------------------- 2 files changed, 26 deletions(-) delete mode 100644 src/content/partials/magic-wan/connector/dhcp-vs-static-ip.mdx delete mode 100644 src/content/partials/magic-wan/connector/wan-with-static-ip.mdx diff --git a/src/content/partials/magic-wan/connector/dhcp-vs-static-ip.mdx b/src/content/partials/magic-wan/connector/dhcp-vs-static-ip.mdx deleted file mode 100644 index 28839ad6c8c4f46..000000000000000 --- a/src/content/partials/magic-wan/connector/dhcp-vs-static-ip.mdx +++ /dev/null @@ -1,5 +0,0 @@ ---- -params: - - name ---- - diff --git a/src/content/partials/magic-wan/connector/wan-with-static-ip.mdx b/src/content/partials/magic-wan/connector/wan-with-static-ip.mdx deleted file mode 100644 index ff5f24851f6c67d..000000000000000 --- a/src/content/partials/magic-wan/connector/wan-with-static-ip.mdx +++ /dev/null @@ -1,21 +0,0 @@ ---- -{} ---- - -After activating your Connector, you can use it in a network configuration with the WAN interface set to a static IP address — that is, an Internet configuration that is not automatically set by DHCP. To use your Connector on a network configuration with a static IP, follow the steps below. - -:::caution -Before proceeding, make sure that you went through the setup workflow and activated your Magic WAN Connector. -::: - -1. Connect Magic WAN Connector to a DHCP port with access to the Internet -2. [Add 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 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 \ No newline at end of file From 45cf511311fd8b5013c1abfb505199a5594331cf Mon Sep 17 00:00:00 2001 From: marciocloudflare <83226960+marciocloudflare@users.noreply.github.com> Date: Thu, 5 Dec 2024 13:52:46 +0000 Subject: [PATCH 22/22] Apply suggestions from code review Co-authored-by: Jun Lee --- .../connector/configure-hardware-connector/index.mdx | 10 +++++----- .../connector/configure-virtual-connector.mdx | 10 +++++----- .../partials/magic-wan/connector/create-site.mdx | 2 +- 3 files changed, 11 insertions(+), 11 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 524d70120d669b0..ca381c414dbb595 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 @@ -26,10 +26,10 @@ Contact your account representative to learn more about purchasing options for t ## DHCP vs static IP connections -Magic WAN Connector uses a DHCP connection at first boot to download your settings and go through the activation process. If you need to use a static IP in your Connector, however, and this is a fresh install: -1. Connect Magic WAN Connector to a DHCP port with access to the Internet -2. Go through the [setup flow](#set-up-cloudflare-dashboard) below and activate your Connector -3. Refer to [WAN with a static IP address](#wan-with-a-static-ip-address) +Magic WAN Connector uses a DHCP connection at first boot to download your settings and go through the activation process. However, if you need to use a static IP in your Connector, and this is a fresh install: +1. Connect Magic WAN Connector to a DHCP port with access to the Internet. +2. Go through the [setup flow](#set-up-cloudflare-dashboard) below and activate your Connector. +3. Refer to [WAN with a static IP address](#wan-with-a-static-ip-address). --- @@ -126,7 +126,7 @@ If there is a firewall deployed upstream of the Magic WAN Connector, configure t ## WAN with a static IP address -After activating your Connector, you can use it in a network configuration with the WAN interface set to a static IP address — that is, an Internet configuration that is not automatically set by DHCP. To use your Connector on a network configuration with a static IP follow the steps below. +After activating your Connector, you can use it in a network configuration with the WAN interface set to a static IP address — that is, an Internet configuration that is not automatically set by DHCP. To use your Connector on a network configuration with a static IP, follow the steps below. :::caution Before proceeding, make sure that you went through the setup workflow and activated your Magic WAN Connector. 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 669c19d4d2ff7cc..5b3d6c4c4c09fb7 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 @@ -33,10 +33,10 @@ Refer to [VMware's documentation](https://docs.vmware.com/en/VMware-vSphere/7.0/ ## DHCP vs static IP connections -Virtual Connector uses a DHCP connection at first boot to download your settings and go through the activation process. If you need to use a static IP in your Virtual Connector, however, and this is a fresh install: -1. Connect the machine with your Virtual Connector VM to a DHCP port with access to the Internet -2. Go through the [setup flow](#set-up-cloudflare-dashboard) below and activate your Connector -3. Refer to [WAN with a static IP address](#wan-with-a-static-ip-address) +Virtual Connector uses a DHCP connection at first boot to download your settings and go through the activation process. However, if you need to use a static IP in your Virtual Connector, and this is a fresh install: +1. Connect the machine with your Virtual Connector VM to a DHCP port with access to the Internet. +2. Go through the [setup flow](#set-up-cloudflare-dashboard) below and activate your Connector. +3. Refer to [WAN with a static IP address](#wan-with-a-static-ip-address). ## Obtain the Virtual Connector image @@ -135,7 +135,7 @@ You cannot use the same license key twice, or reuse a key once the virtual machi ## WAN with a static IP address -After activating your Virtual Connector, you can use it in a network configuration with the WAN interface set to a static IP address - that is, an Internet configuration that is not automatically set by DHCP. To use your Virtual Connector on a network configuration with a static IP follow the steps below. +After activating your Virtual Connector, you can use it in a network configuration with the WAN interface set to a static IP address - that is, an Internet configuration that is not automatically set by DHCP. To use your Virtual Connector on a network configuration with a static IP, follow the steps below. :::caution Before proceeding, make sure that you went through the setup workflow and activated your Virtual Connector. diff --git a/src/content/partials/magic-wan/connector/create-site.mdx b/src/content/partials/magic-wan/connector/create-site.mdx index 9965a8de67de106..73f4ba163241a8d 100644 --- a/src/content/partials/magic-wan/connector/create-site.mdx +++ b/src/content/partials/magic-wan/connector/create-site.mdx @@ -78,7 +78,7 @@ Take note of the site `id` parameter, as you will need it to create WANs and LAN 4. In **VLAN ID**, enter a number between `0` and `4094` to specify a [VLAN ID](/magic-wan/configuration/connector/reference/#vlan-id). 5. In **Priority**, choose the priority for your WAN. Lower numbers have higher priority. Refer to Traffic steering to learn more about how Cloudflare calculates priorities. 6. **Addressing**: Select **DHCP**. This is needed the first time you set up your Connector to successfully download all settings to the machine and activate it. If you need a static IP address in your network environment: - 1. Continue the set up flow below to activate your Connector + 1. Continue the set up flow below to activate your Connector. 2. Refer to [WAN with a static IP address](#wan-with-a-static-ip-address). If you choose a static IP, you also need to specify the static IP and gateway addresses.