diff --git a/src/content/partials/magic-wan/connector/configure-connectors.mdx b/src/content/partials/magic-wan/connector/configure-connectors.mdx index 0f4b7cb2f04349..eb3ea5bca515f6 100644 --- a/src/content/partials/magic-wan/connector/configure-connectors.mdx +++ b/src/content/partials/magic-wan/connector/configure-connectors.mdx @@ -76,10 +76,36 @@ You cannot enable high availability for an existing Connector on-ramp. To add hi ## DHCP vs static IP connections -{props.productName} 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 {props.productName}, and this is a fresh install: -1. Connect {props.productNameType} 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). +{ props.magicWord === "hardware" && ( + <> +

At first boot, Magic WAN Connector needs to reach out to Cloudflare to download your settings and go through the activation process. If any of the networks plugged into your Connector are DHCP enabled, does not use a VLAN, and have an Internet connection, that process is handled automatically. However, if all of the networks require more information to utilize, (such as a network with static IPs, or tagged VLAN networks) your Magic WAN Connector might need some more information to proceed. There are couple of ways to provide that information. Choose the one that fits your workflow:

+ + +
    +
  1. Connect Magic WAN Connector to a DHCP port with access to the Internet.
    2. +
  2. Go through the setup flow below and activate your Connector.
    3. +
  3. Refer to WAN with a static IP address.
    4. +
+ + +

Refer to the Bootstrap workflow.

+ + + ) +} + +{ props.magicWord === "virtual" && ( + <> +

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. +
  2. Go through the setup flow below and activate your Connector.
    3. +
  3. Refer to WAN with a static IP address.
    4. +
+ + ) +} + --- @@ -371,11 +397,25 @@ After finishing your Connector configuration, you need to add it to a site. +

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 set up.

+

If you set up your Connector with a static IP through the bootstrap method, you do not need a DHCP port. Refer to DHCP vs static IP connections for more information.

-:::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. -::: + + + ) +} + +{ props.magicWord === "virtual" && ( + <> +

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.

+ + + + + ) +} When you are ready to connect your Magic WAN Connector to the Cloudflare network: @@ -446,6 +486,102 @@ When you are ready to connect your Magic WAN Connector to the Cloudflare network ) } +{ props.magicWord === "hardware" && ( + <> + +

Advanced users can locally configure their Magic WAN Connector to work in a static IP configuration. This local method does not require having access to a DHCP Internet connection. However, it does require being comfortable with using tools to access the serial port on Magic WAN Connector as well as using a serial terminal client to access the Connector's environment.

+

Below is a detailed description of how to use the serial port to configure your Magic WAN Connector locally.

+ + +

To access the serial port on Magic WAN Connector you will need the following equipment:

+
    +
  • The Magic WAN Connector appliance
    • +
  • A Phillips-head screwdriver
    • +
  • A micro-USB to USB-A cable (there should be one included in the packaging of your Connector)
    • +
  • A computer with an available USB port
    • +
  • A serial terminal client
    • +
  • Optional: if needed, a USB-A to USB-C converter dongle if your computer requires it
    • +
+ + +
    +
  1. Using the Phillips screwdriver, loosen the screw covering the serial console panel on the back of the Magic WAN Connector and turn the panel out of the way. +
      +
    1. Pictures and more instructions can be found on Dell's Technical Documents.
      2. +
    +
    2. +
  2. Connect your computer to the Magic WAN Connector using the USB cable.
    3. +
+ + +

Your Connector's default password is the serial number (also known as a Service Tag for Dell devices), all uppercase followed by an "!" (for example, A1B2C3D!)

+ + +

To access Magic WAN Connector's environment you need a serial terminal client. Follow the instructions below to install one, based on your operating system.

+ + +

Cloudflare recommends using PuTTY for Windows. Download PuTTY from the official website and then install it.

+
    +
  1. Check the COM port of the USB to UART device in the Windows Device Manager. It should show up as something similar to Silicon Labs CP210x USB to UART Bridge (COMX).
    2. +
  2. Take note of the value in the parentheses (COMX). +
      +
    1. Refer to the Dell Documentation Page for more details on creating a serial console connection.
      2. +
    +
    3. +
  3. Launch PuTTY.
    4. +
  4. Under Category, make sure that Session (the first item) is selected.
    5. +
  5. Under Connection type, select Serial.
    6. +
  6. In the Serial Line, type in the COM port found in step 2 (for example, COM1).
    7. +
  7. In the Speed, enter 115200.
    8. +
  8. Select Open on the bottom of the dialog box. A terminal window should pop up.
    9. +
  9. The screen may need to be manually refreshed when a new device is connected. You can do that by pressing CTRL + C.
    10. +
+ + +

Cloudflare recommends installing Screen for macOS. You can install Screen via brew install screen. If you do not have brew installed, follow the instructions on Brew's Official Website to install it.

+
    +
  1. Open the macOS Terminal.
    2. +
  2. Run ls /dev/cu.* to list the connected serial devices.
    3. +
  3. The command should return an output similar to /dev/cu.usbserial-0001. Copy this output to the clipboard or note this down somewhere else.
    4. +
  4. Run sudo screen -adRUS {`<`}PATH_FROM_STEP_3{`>`} 115200.
    5. +
  5. The screen may need to be manually refreshed when a new device is connected. You can do that by pressing CMD + C.
    6. +
+ + +

Cloudflare recommends installing Screen for Linux. You can install Screen via your package manager of choice. For example, for Debian/Ubuntu, install by running sudo apt update && sudo apt install screen

+ +
    +
  1. Open Terminal.
    2. +
  2. List the connected serial devices by running ls /dev/serial/by-id/*.
    3. +
  3. The command should return an output similar to /dev/serial/by-id/usb-Silicon_Labs_CP2102_USB_to_UART_Bridge_Controller_0001-if00-port0. Copy this to the clipboard or note this down.
    4. +
  4. Run sudo screen -adRUS {`<`}THE PATH FROM STEP 3{`>`}; 115200.
    5. +
  5. The screen may need to be manually refreshed when a new device is connected. You can do that by pressing CTRL + C.
    6. +
+ + +
    +
  1. Log into the Connector. +
      +
    1. You will be prompted to change your password if you attempt to log in with the default password.
      2. +
    +
    2. +
  2. From the menu, go to Bootstrap with the arrow keys and select it with the Enter key.
    3. +
  3. Select the Jack (physical port) you want to configure for the initialization of the connector.
    4. +
  4. Enter the VLAN tag (if applicable) of the network. Leave it blank if untagged.
    5. +
  5. Select whether the network is DHCP or static.
    6. + + + + +
  6. Enter the IP address you would like the connector to have in CIDR form (for example, 10.0.0.2/24).
    7. +
  7. Enter the IP address of the Internet gateway (this must be in the same subnet as the previous IP address you entered and must not be the same address).
    8. +
  8. Select Save and confirm that you want to use the new settings.
    9. +
  9. The Connector will download the rest of the settings from Cloudflare. The last heartbeat of the Connector should update once it has made contact with Cloudflare.
    10. +
+ + ) +} + --- ## About high availability configurations diff --git a/src/content/release-notes/magic-wan.yaml b/src/content/release-notes/magic-wan.yaml index eef266f41cb175..b30a73724fd360 100644 --- a/src/content/release-notes/magic-wan.yaml +++ b/src/content/release-notes/magic-wan.yaml @@ -5,6 +5,10 @@ productLink: "/magic-wan/" productArea: Cloudflare One productAreaLink: /cloudflare-one/changelog/ entries: + - publish_date: "2025-02-14" + title: Local console access for bootstrapping Magic WAN Connector + description: |- + Magic WAN Connector can now be configured to connect to the Cloudflare network via a static IP assignment through local console. - publish_date: "2024-12-12" title: LAN Policy improvements for the Magic WAN Connector description: |-