Skip to content

Commit c91e9bc

Browse files
marciocloudflaremarciocloudflare
committed
indent
1 parent dab3a27 commit c91e9bc

File tree

1 file changed

+79
-90
lines changed

1 file changed

+79
-90
lines changed

‎src/content/partials/magic-wan/connector/configure-connectors.mdx‎

Lines changed: 79 additions & 90 deletions
Original file line numberDiff line numberDiff line change
@@ -488,107 +488,96 @@ When you are ready to connect your Magic WAN Connector to the Cloudflare network
488488

489489
{ props.magicWord === "hardware" && (
490490
<>
491-
<AnchorHeading title="Bootstrap via Serial Console" depth={2} />
492-
<p>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.</p>
493-
<p>Below is a detailed description of how to use the serial port to configure your Magic WAN Connector locally.</p>
494-
495-
<AnchorHeading title="Equipment required" depth={3} />
496-
<p>To access the serial port on Magic WAN Connector you will need the following equipment:</p>
497-
<ul>
498-
<li>The Magic WAN Connector appliance</li>
499-
<li>A Phillips-head screwdriver</li>
500-
<li>A micro-USB to USB-A cable (there should be one included in the packaging of your Connector)</li>
501-
<li>A computer with an available USB port</li>
502-
<li>A serial terminal client</li>
503-
<li>Optional: if needed, a USB-A to USB-C converter dongle if your computer requires it</li>
504-
</ul>
505-
506-
<AnchorHeading title="1. Access Magic WAN Connector's serial port" depth={3} />
507-
<ol>
508-
<li>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.
509-
<ol>
510-
<li>Pictures and more instructions can be found on <a href="https://www.dell.com/support/kbdoc/en-us/000134440/how-to-access-console-port-of-dell-emc-networking-virtual-edge-platform-1405-series" target="_blank" rel="noopener noreferrer">Dell's Technical Documents</a>.</li>
511-
</ol>
512-
</li>
513-
<li>Connect your computer to the Magic WAN Connector using the USB cable.</li>
514-
</ol>
491+
<AnchorHeading title="Bootstrap via Serial Console" depth={2} />
492+
<p>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.</p>
493+
<p>Below is a detailed description of how to use the serial port to configure your Magic WAN Connector locally.</p>
515494

516-
<AnchorHeading title="Default password to access Connector" depth={4} />
517-
<p>Your Connector's default password is the serial number (also known as a Service Tag for Dell devices), all uppercase plus an "!" (for example, <code>A1B2C3D!</code>)</p>
518-
519-
<AnchorHeading title="2. Install a serial terminal client" depth={3} />
520-
<p>To access Magic WAN Connector's environment you need a serial terminal client. Follow the instructions below on how to install one based on your operating system.</p>
495+
<AnchorHeading title="Equipment required" depth={3} />
496+
<p>To access the serial port on Magic WAN Connector you will need the following equipment:</p>
497+
<ul>
498+
<li>The Magic WAN Connector appliance</li>
499+
<li>A Phillips-head screwdriver</li>
500+
<li>A micro-USB to USB-A cable (there should be one included in the packaging of your Connector)</li>
501+
<li>A computer with an available USB port</li>
502+
<li>A serial terminal client</li>
503+
<li>Optional: if needed, a USB-A to USB-C converter dongle if your computer requires it</li>
504+
</ul>
521505

522-
<AnchorHeading title="Windows" depth={4} />
523-
<p>Cloudflare recommends using PuTTY for Windows. Download PuTTY from the <a href="https://www.putty.org/" target="_blank" rel="noopener noreferrer">official website</a> and then install it.</p>
524-
<ol>
525-
<li>Check the COM port of the USB to UART device in the Windows Device Manager. It should show up as something similar to <code>Silicon Labs CP210x USB to UART Bridge (COMX)</code>.</li>
526-
<li>Take note of the value in the parentheses (COMX).
527-
<ol>
528-
<li>Refer to the <a href="https://infohub.delltechnologies.com/l/virtual-edge-platform-vep-1405-series-diag-os-and-tools-release-notes/bios-installation-and-configuration" target="_blank" rel="noopener noreferrer">Dell Documentation Page</a> for more details on creating a serial console connection.</li>
529-
</ol>
530-
</li>
531-
<li>Launch PuTTY.</li>
532-
<li>Under <strong>Category</strong>, make sure that <strong>Session</strong> (the first item) is selected.</li>
533-
<li>Under <strong>Connection type</strong>, select <strong>Serial</strong>.</li>
534-
<li>In the <strong>Serial Line</strong>, type in the COM port found in step 2 (for example, <code>COM1</code>).</li>
535-
<li>In the <strong>Speed</strong>, enter <code>115200</code>.</li>
536-
<li>Select <strong>Open</strong> on the bottom of the dialog box. A terminal window should pop up.</li>
537-
<li>The screen may need to be manually refreshed when a new device is connected. You can do that by pressing <code>CTRL + C</code>.</li>
538-
</ol>
539-
540-
<AnchorHeading title="macOS" depth={4} />
541-
<p>Cloudflare recommends installing Screen for macOS. You can install Screen via <code>brew install screen</code>. If you do not have <code>brew</code> installed, follow the instructions on <a href="https://brew.sh/" target="_blank" rel="noopener noreferrer">Brew's Official Website</a> to install it.</p>
542-
<ol>
543-
<li>Open the macOS Terminal.</li>
544-
<li>Run <code>ls /dev/cu.*</code> to list the connected serial devices.</li>
545-
<li>The command should return an output similar to <code>/dev/cu.usbserial-0001</code>. Copy this output to the clipboard or note this down somewhere else.</li>
546-
<li>Run <code>sudo screen -adRUS {`<`}PATH_FROM_STEP_3{`>`} 115200</code>.</li>
547-
<li>The screen may need to be manually refreshed when a new device is connected. You can do that by pressing <code>CMD + C</code>.</li>
548-
</ol>
549-
550-
<AnchorHeading title="Linux" depth={4} />
551-
<p>Cloudflare recommends installing Screen for Linux. You can install Screen via your package manager of choice. For example, for Debian/Ubuntu, install by running <code>sudo apt update && sudo apt install screen</code></p>
552-
553-
<ol>
554-
<li>Open Terminal.</li>
555-
<li>List the connected serial devices by running <code>ls /dev/serial/by-id/*</code>.</li>
556-
<li>The command should return an output similar to <code>/dev/serial/by-id/usb-Silicon_Labs_CP2102_USB_to_UART_Bridge_Controller_0001-if00-port0</code>. Copy this to the clipboard or note this down.</li>
557-
<li>Run <code>sudo screen -adRUS {`<`}THE PATH FROM STEP 3{`>`}; 115200</code>.</li>
558-
<li>The screen may need to be manually refreshed when a new device is connected. You can do that by pressing <code>CTRL + C</code>.</li>
559-
</ol>
560-
561-
<AnchorHeading title="Configure a static IP on Magic WAN Connector" depth={3} />
562-
563-
<ol>
564-
<li>Log into the Connector.
565-
<ol>
566-
<li>You will be prompted to change your password if you attempt to log in with the default password.</li>
567-
</ol>
568-
</li>
569-
<li>From the menu, go to <strong>Bootstrap</strong> with the arrow keys and select it with the Enter key.</li>
570-
<li>Select the Jack (physical port) you want to configure for the initialization of the connector.</li>
571-
<li>Enter the VLAN tag (if applicable) of the network. Leave it blank if untagged.</li>
572-
<li>Select whether the network is DHCP or static:
506+
<AnchorHeading title="1. Access Magic WAN Connector's serial port" depth={3} />
573507
<ol>
574-
<li><Aside>The main reason to use the bootstrapper is if every network the Connector is plugged into is either static, behind a VLAN, or both. If you find yourself here and configuring a network with DHCP and no VLAN, you are probably not in the right place. See the section on configuring your Connector via the dashboard.</Aside></li>
508+
<li>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.
509+
<ol>
510+
<li>Pictures and more instructions can be found on <a href="https://www.dell.com/support/kbdoc/en-us/000134440/how-to-access-console-port-of-dell-emc-networking-virtual-edge-platform-1405-series" target="_blank" rel="noopener noreferrer">Dell's Technical Documents</a>.</li>
511+
</ol>
512+
</li>
513+
<li>Connect your computer to the Magic WAN Connector using the USB cable.</li>
575514
</ol>
576-
</li>
577-
<li>Enter the IP address you would like the connector to have in CIDR form (for example, <code>10.0.0.2/24</code>).</li>
578-
<li>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).</li>
579-
<li>Select <strong>Save</strong> and confirm that you want to use the new settings.</li>
580-
<li>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.</li>
581-
</ol>
582-
583-
584-
585515

516+
<AnchorHeading title="Default password to access Connector" depth={4} />
517+
<p>Your Connector's default password is the serial number (also known as a Service Tag for Dell devices), all uppercase plus an "!" (for example, <code>A1B2C3D!</code>)</p>
586518

519+
<AnchorHeading title="2. Install a serial terminal client" depth={3} />
520+
<p>To access Magic WAN Connector's environment you need a serial terminal client. Follow the instructions below on how to install one based on your operating system.</p>
587521

522+
<AnchorHeading title="Windows" depth={4} />
523+
<p>Cloudflare recommends using PuTTY for Windows. Download PuTTY from the <a href="https://www.putty.org/" target="_blank" rel="noopener noreferrer">official website</a> and then install it.</p>
524+
<ol>
525+
<li>Check the COM port of the USB to UART device in the Windows Device Manager. It should show up as something similar to <code>Silicon Labs CP210x USB to UART Bridge (COMX)</code>.</li>
526+
<li>Take note of the value in the parentheses (COMX).
527+
<ol>
528+
<li>Refer to the <a href="https://infohub.delltechnologies.com/l/virtual-edge-platform-vep-1405-series-diag-os-and-tools-release-notes/bios-installation-and-configuration" target="_blank" rel="noopener noreferrer">Dell Documentation Page</a> for more details on creating a serial console connection.</li>
529+
</ol>
530+
</li>
531+
<li>Launch PuTTY.</li>
532+
<li>Under <strong>Category</strong>, make sure that <strong>Session</strong> (the first item) is selected.</li>
533+
<li>Under <strong>Connection type</strong>, select <strong>Serial</strong>.</li>
534+
<li>In the <strong>Serial Line</strong>, type in the COM port found in step 2 (for example, <code>COM1</code>).</li>
535+
<li>In the <strong>Speed</strong>, enter <code>115200</code>.</li>
536+
<li>Select <strong>Open</strong> on the bottom of the dialog box. A terminal window should pop up.</li>
537+
<li>The screen may need to be manually refreshed when a new device is connected. You can do that by pressing <code>CTRL + C</code>.</li>
538+
</ol>
588539

540+
<AnchorHeading title="macOS" depth={4} />
541+
<p>Cloudflare recommends installing Screen for macOS. You can install Screen via <code>brew install screen</code>. If you do not have <code>brew</code> installed, follow the instructions on <a href="https://brew.sh/" target="_blank" rel="noopener noreferrer">Brew's Official Website</a> to install it.</p>
542+
<ol>
543+
<li>Open the macOS Terminal.</li>
544+
<li>Run <code>ls /dev/cu.*</code> to list the connected serial devices.</li>
545+
<li>The command should return an output similar to <code>/dev/cu.usbserial-0001</code>. Copy this output to the clipboard or note this down somewhere else.</li>
546+
<li>Run <code>sudo screen -adRUS {`<`}PATH_FROM_STEP_3{`>`} 115200</code>.</li>
547+
<li>The screen may need to be manually refreshed when a new device is connected. You can do that by pressing <code>CMD + C</code>.</li>
548+
</ol>
589549

550+
<AnchorHeading title="Linux" depth={4} />
551+
<p>Cloudflare recommends installing Screen for Linux. You can install Screen via your package manager of choice. For example, for Debian/Ubuntu, install by running <code>sudo apt update && sudo apt install screen</code></p>
590552

553+
<ol>
554+
<li>Open Terminal.</li>
555+
<li>List the connected serial devices by running <code>ls /dev/serial/by-id/*</code>.</li>
556+
<li>The command should return an output similar to <code>/dev/serial/by-id/usb-Silicon_Labs_CP2102_USB_to_UART_Bridge_Controller_0001-if00-port0</code>. Copy this to the clipboard or note this down.</li>
557+
<li>Run <code>sudo screen -adRUS {`<`}THE PATH FROM STEP 3{`>`}; 115200</code>.</li>
558+
<li>The screen may need to be manually refreshed when a new device is connected. You can do that by pressing <code>CTRL + C</code>.</li>
559+
</ol>
591560

561+
<AnchorHeading title="Configure a static IP on Magic WAN Connector" depth={3} />
562+
<ol>
563+
<li>Log into the Connector.
564+
<ol>
565+
<li>You will be prompted to change your password if you attempt to log in with the default password.</li>
566+
</ol>
567+
</li>
568+
<li>From the menu, go to <strong>Bootstrap</strong> with the arrow keys and select it with the Enter key.</li>
569+
<li>Select the Jack (physical port) you want to configure for the initialization of the connector.</li>
570+
<li>Enter the VLAN tag (if applicable) of the network. Leave it blank if untagged.</li>
571+
<li>Select whether the network is DHCP or static:
572+
<ol>
573+
<li><Aside>The main reason to use the bootstrapper is if every network the Connector is plugged into is either static, behind a VLAN, or both. If you find yourself here and configuring a network with DHCP and no VLAN, you are probably not in the right place. See the section on configuring your Connector via the dashboard.</Aside></li>
574+
</ol>
575+
</li>
576+
<li>Enter the IP address you would like the connector to have in CIDR form (for example, <code>10.0.0.2/24</code>).</li>
577+
<li>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).</li>
578+
<li>Select <strong>Save</strong> and confirm that you want to use the new settings.</li>
579+
<li>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.</li>
580+
</ol>
592581
</>
593582
)
594583
}

0 commit comments

Comments
 (0)