Skip to content

Commit 3f0bf73

Browse files
[MWAN Connector] Adds self serve option (#23389)
* removed prereqs line * added register appliance steps * corrected anchor links * correcter title depth * refined text * corrected links * corrected wan links * corrected lan link * corrected links * Apply suggestions from code review Co-authored-by: Maddy <[email protected]> --------- Co-authored-by: Maddy <[email protected]>
1 parent 9106144 commit 3f0bf73

File tree

4 files changed

+44
-24
lines changed

4 files changed

+44
-24
lines changed

src/content/docs/magic-wan/configuration/connector/network-options/nat-subnet.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -22,4 +22,4 @@ Even if NAT is enabled, the local prefix for a subnet must be unique within its
2222

2323
## Create NATs for subnets
2424

25-
For more information on how to a create a NAT for a subnets, refer to **Create a LAN**, either in [Configure hardware Connector](/magic-wan/configuration/connector/configure-hardware-connector/#3-create-a-lan) or [Configure virtual Connector](/magic-wan/configuration/connector/configure-virtual-connector/#3-create-a-lan).
25+
For more information on how to a create a NAT for a subnets, refer to **Create a LAN**, either in [Configure hardware Connector](/magic-wan/configuration/connector/configure-hardware-connector/#create-a-lan) or [Configure virtual Connector](/magic-wan/configuration/connector/configure-virtual-connector/#create-a-lan).

src/content/docs/magic-wan/configuration/connector/network-options/routed-subnets.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -53,4 +53,4 @@ Optionally, you can also [enable NAT for a subnet](/magic-wan/configuration/conn
5353

5454
## Create routed subnets
5555

56-
For more information on how to create routed subnets, refer to **Create a LAN**, either in [Configure hardware Connector](/magic-wan/configuration/connector/configure-hardware-connector/#3-create-a-lan) or [Configure virtual Connector](/magic-wan/configuration/connector/configure-virtual-connector/#3-create-a-lan).
56+
For more information on how to create routed subnets, refer to **Create a LAN**, either in [Configure hardware Connector](/magic-wan/configuration/connector/configure-hardware-connector/#create-a-lan) or [Configure virtual Connector](/magic-wan/configuration/connector/configure-virtual-connector/#create-a-lan).

src/content/docs/magic-wan/configuration/connector/reference.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -91,7 +91,7 @@ For high-capacity use cases, multiple tunnels can be established with equal prio
9191

9292
### Configure multiple tunnels in the same WAN profile
9393

94-
If you need to configure multiple tunnels for the same WAN profile, [set up multiple WAN connections](/magic-wan/configuration/connector/configure-hardware-connector/#2-create-a-wan). Each WAN is assigned one IPsec tunnel.
94+
If you need to configure multiple tunnels for the same WAN profile, [set up multiple WAN connections](/magic-wan/configuration/connector/configure-hardware-connector/#create-a-wan). Each WAN is assigned one IPsec tunnel.
9595

9696
### WAN settings
9797

src/content/partials/networking-services/mconn/configure-connectors.mdx

Lines changed: 41 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -27,9 +27,7 @@ import { AnchorHeading, Aside, Card, Code, GlossaryTooltip, Markdown, Render, Ta
2727
text={`
2828
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.
2929
30-
You also need to purchase a Magic WAN Connector before you can start configuring your settings in the Cloudflare dashboard. After buying a Magic WAN Connector, the device will be registered with your Cloudflare account and show up in your Cloudflare dashboard.
31-
32-
Contact your account representative to learn more about purchasing options for the Magic WAN Connector device.
30+
You also need to purchase a Magic WAN Connector before you can start configuring your settings in the Cloudflare dashboard. Contact your account representative to learn more about purchasing options for the Magic WAN Connector device.
3331
`}
3432
inline={false}
3533
/>
@@ -139,7 +137,7 @@ You cannot enable high availability for an existing Connector on-ramp. To add hi
139137
text={`
140138
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.
141139
142-
Refer to [SFP+ port information](/magic-wan/configuration/connector/configure-hardware-connector/sfp-port-information/) for details on this topic.</p>
140+
Refer to [SFP+ port information](/magic-wan/configuration/connector/configure-hardware-connector/sfp-port-information/) for details on this topic.
143141
`}
144142
inline={false}
145143
/>
@@ -253,7 +251,29 @@ You cannot enable high availability for an existing Connector on-ramp. To add hi
253251

254252
## Set up Cloudflare dashboard
255253

256-
### 1. Add a Connector on-ramp
254+
{ props.magicWord === "hardware" && (
255+
<>
256+
<AnchorHeading title="Register your appliance" depth={3} />
257+
<Markdown
258+
text={`
259+
To set up and use Magic WAN Connector, you first need to register it with your account.
260+
261+
1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/) and select your account.
262+
2. Go to **Magic WAN** > **Configuration**.
263+
3. Under **Connectors**, select **Register your appliance**.
264+
4. In **Appliance details** > **Serial number**, insert the serial number for your device. You can optionally add notes about the Magic WAN Connector you are adding to the dashboard.
265+
5. (Optional) Select **Add** below **Serial number** to add multiple Magic WAN Connectors at once to your account.
266+
6. Select **Register appliance**.
267+
268+
Your device is now registered with your account. Select **Add on-ramps** to continue with the setup process, or **Return to connections** to check your newly added Connector.
269+
`}
270+
inline={false}
271+
/>
272+
</>
273+
)
274+
}
275+
276+
### Add a Connector on-ramp
257277

258278
You need to add your Connector to your Cloudflare dashboard and configure its settings before connecting it to the Internet.
259279

@@ -270,7 +290,7 @@ To add a Connector on-ramp:
270290
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.
271291
10. Select **Continue** to proceed to creating your WAN and LAN networks.
272292

273-
### 2. Create a WAN
293+
### Create a WAN
274294

275295
<Tabs syncKey="dashPlusAPI"> <TabItem label="Dashboard">
276296

@@ -313,7 +333,7 @@ curl https://api.cloudflare.com/client/v4/accounts/{account_id}/magic/sites/{sit
313333

314334
</TabItem> </Tabs>
315335

316-
### 3. Create a LAN
336+
### Create a LAN
317337

318338
<Tabs syncKey="dashPlusAPI"> <TabItem label="Dashboard">
319339

@@ -372,7 +392,7 @@ Magic WAN Connector supports different types of DHCP configurations. Connector c
372392

373393
Refer to [DHCP options](/magic-wan/configuration/connector/network-options/dhcp/) to learn more.
374394

375-
### 4. Add your Connector to a site
395+
### Add your Connector to a site
376396

377397
After finishing your Connector configuration, you need to add it to a site. <Render file="sites-brief" product="networking-services" />
378398

@@ -441,11 +461,11 @@ After finishing your Connector configuration, you need to add it to a site. <Ren
441461

442462
## Activate Connector
443463

444-
{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).
464+
{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](#set-up-cloudflare-dashboard).
445465

446466
{ props.magicWord === "hardware" && (
447467
<>
448-
<p>When the Connector is first activated, you need to have Internet connection. If you chose to set up your Connector with DHCP you will need to have one of the Connector ports 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 <a href="#1-add-a-connector-on-ramp">set up</a>.</p>
468+
<p>When the Connector is first activated, you need to have Internet connection. If you chose to set up your Connector with DHCP you will need to have one of the Connector ports 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 <a href="#set-up-cloudflare-dashboard">set up</a>.</p>
449469
<p> If you set up your Connector with a static IP through the bootstrap method, you do not need a DHCP port. Refer to <a href="#decide-on-dhcp-vs-static-ip-connections"> DHCP vs static IP connections</a> for more information.</p>
450470

451471
<Aside type="caution">Remember that if you chose the DHCP method you have to connect Magic WAN Connector through a route that supports DHCP for its first connection to the Internet. Otherwise, the Connector will not work.</Aside>
@@ -455,7 +475,7 @@ After finishing your Connector configuration, you need to add it to a site. <Ren
455475

456476
{ props.magicWord === "virtual" && (
457477
<>
458-
<p>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 <a href="#1-add-a-connector-on-ramp">set up</a>.</p>
478+
<p>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 <a href="#set-up-cloudflare-dashboard">set up</a>.</p>
459479

460480
<Aside type="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.</Aside>
461481

@@ -479,7 +499,7 @@ When you are ready to connect your Magic WAN Connector to the Cloudflare network
479499
<Markdown
480500
text={`
481501
1. Go to **Virtual Machines** in VMware, and boot up Virtual Connector's VM.
482-
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).
502+
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](#set-up-cloudflare-dashboard).
483503
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.
484504
4. If successful, the [tunnel health checks](/magic-wan/configuration/common-settings/check-tunnel-health-dashboard/) will show as healthy.
485505
5. If you do not see a [healthy heartbeat](/magic-wan/configuration/connector/maintenance/heartbeat/) on the Cloudflare dashboard, reboot the Virtual Connector's VM in VMware.
@@ -503,11 +523,11 @@ When you are ready to connect your Magic WAN Connector to the Cloudflare network
503523
<Markdown
504524
text={`
505525
1. Connect Magic WAN Connector to a DHCP port with access to the Internet.
506-
2. [Add a Connector on-ramp](#1-add-a-connector-on-ramp) in the Cloudflare dashboard.
507-
3. Create a [DHCP WAN](#2-create-a-wan).
526+
2. [Add a Connector on-ramp](#add-a-connector-on-ramp) in the Cloudflare dashboard.
527+
3. Create a [DHCP WAN](#create-a-wan).
508528
4. [Activate](#activate-connector) and power on your Connector.
509529
5. Wait 60 seconds.
510-
6. Make changes to the [WAN settings](#2-create-a-wan) in the Cloudflare dashboard to a static IP set up.
530+
6. Make changes to the [WAN settings](#create-a-wan) in the Cloudflare dashboard to a static IP set up.
511531
7. Wait 60 seconds again.
512532
8. Magic WAN Connector will go offline. This is normal and expected behavior.
513533
9. Adjust your physical connections as required to match the static configuration.
@@ -528,11 +548,11 @@ When you are ready to connect your Magic WAN Connector to the Cloudflare network
528548
<Markdown
529549
text={`
530550
1. Connect the machine where you installed the VM with Virtual Connector to a DHCP port with access to the Internet.
531-
2. [Add a Connector on-ramp](#1-add-a-connector-on-ramp) in the Cloudflare dashboard.
532-
3. Create a [DHCP WAN](#2-create-a-wan).
551+
2. [Add a Connector on-ramp](#add-a-connector-on-ramp) in the Cloudflare dashboard.
552+
3. Create a [DHCP WAN](#create-a-wan).
533553
4. [Activate](#activate-connector) and boot your Virtual Connector.
534554
5. Wait 60 seconds.
535-
6. Make changes to the [WAN settings](#2-create-a-wan) in the Cloudflare dashboard to a static IP set up.
555+
6. Make changes to the [WAN settings](#create-a-wan) in the Cloudflare dashboard to a static IP set up.
536556
7. Wait 60 seconds again.
537557
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.
538558
9. Reboot your virtual machine.
@@ -686,15 +706,15 @@ You cannot enable high availability for an existing site. To add high availabili
686706

687707
To set up a high availability configuration:
688708

689-
1. Follow the steps in [Add a Connector on-ramp](#1-add-a-connector-on-ramp) up until step 4.
709+
1. Follow the steps in [Add a Connector on-ramp](#add-a-connector-on-ramp) up until step 4.
690710
2. After naming your site, select **Turn on high availability**.
691711
3. Select **Create and continue**.
692712
4. Select **Add Connector**.
693713
5. From the list, choose your first Connector > **Add Connector**.
694714
6. Back on the previous screen, select **Add secondary Connector**.
695715
7. From the list, choose your second Connector > **Add Connector**.
696-
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.
697-
9. To create a LAN, follow the steps mentioned above in [Create a LAN](#3-create-a-lan) up until step 4.
716+
8. Select **Continue** to [Create a WAN](#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.
717+
9. To create a LAN, follow the steps mentioned above in [Create a LAN](#create-a-lan) up until step 4.
698718
10. In **Static address**, enter the IP for the primary node in your site. For example, `192.168.10.1/24`.
699719
11. In **Secondary static address**, enter the IP for the secondary node in your site. For example, `192.168.10.2/24`.
700720
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`.

0 commit comments

Comments
 (0)