Serial Console User Guide

User Guide

Updated Jan 13, 2023

Serial Console User Guide

Overview of the serial console Direct link to this section

The serial console is an interface that allows you to restart or reconfigure an appliance when you connect to it using a cable or AirConsole adapter. This is typically used for troubleshooting when other methods do not work.

This is typically used for troubleshooting when:

This page describes the hardware requirements for the serial console, as well as how to use the serial console.

Requirements Direct link to this section

This section details the hardware and driver requirements to use the serial console for each model.

Hardware requirements Direct link to this section

These are the hardware requirements for serial console sessions:

Appliance model Cable Driver Chip
AWN101 Sensor Black mini USB serial cable Prolific driver PL2303 chip
AWN200 Sensor Blue RJ45 to USB serial cable OS X FTDI driver Not applicable
AWN201 Sensor Blue RJ45 to USB serial cable OS X FTDI driver Not applicable
AWN202 Sensor Blue RJ45 to USB serial cable OS X FTDI driver Not applicable
AWN203 Sensor DB9 to USB cable Not applicable Not applicable
AWN301 Sensor DB9 to USB cable Not applicable Not applicable
AWN1000 Sensor Blue RJ45 to USB serial cable OS X FTDI driver Not applicable
AWN 200 Series Scanner Blue RJ45 to USB serial cable OS X FTDI driver Not applicable

Install the required drivers Direct link to this section

This section guides you through the installation of required drivers to use the serial console.

AWN101 serial console session driver Direct link to this section

To install the required driver for the AWN101 sensor:

  1. If you are using a Mac, and this Mac was previously used for another console session, run this command in a terminal to uninstall the previously installed driver:

    sudo rm -rf /System/Library/Extensions/ProlificUsbSerial.kext
  2. Download the driver from Prolific, and install it.

    Note: macOS requires approval before installation. You are prompted to enter your password during the installation.

  3. Use the cable identified in Hardware requirements to connect the sensor and your computer.

Console session drivers for all other appliances Direct link to this section

To install the required driver on all other appliance models:

Notes:

  1. Use the cable identified in Hardware requirements to connect the appliance to your computer.

  2. In a terminal, run the following command to identify the serial device name:

    ls /dev/tty* | grep -i usb

    This may return multiple USB device names for the computer.

  3. Run the following command, where <usb_serial_device> is one of the serial USB device names from the previous step:

    sudo screen /dev/<usb_serial_device> 115200

    For example, for Linux, you might enter sudo screen /dev/ttyUSB0 115200.

AirConsole requirements Direct link to this section

AirConsole is a portable, battery powered RS232 serial port over WiFi or a Bluetooth adapter. If you cannot use a physical cable, and you own an AirConsole adapter, you can use it instead.

For AirConsole, you need the:

To connect AirConsole:

  1. Launch the AirConsoleOSX application on your Mac.
  2. Change AirConsole from Auto to Manual.
  3. Enter the hostname of the AirConsole. For example, aircon1.
  4. Connect to the AirConsole device with this command, where <serial_number> is the serial number of the device:
    sudo screen /dev/cu.Airconsole-1 <serial_number>

Connect to the serial console Direct link to this section

Note:

To connect your appliance to the serial console, complete the procedure for your operating system:

Windows Direct link to this section

  1. Use the cable identified in Hardware requirements to connect the appliance to your computer.

  2. Launch PuTTY, and then select the following settings:

    • Serial line — Select the serial line for the console cable.
    • Speed — Enter 115200.
    • Connection type — Select Serial.
  3. Press Enter three times to initiate the serial console session.

Mac or Linux Direct link to this section

  1. Use the cable identified in Hardware requirements to connect the appliance to your computer.

  2. In a terminal, run the following command to identify the serial device name:

    ls /dev/tty* | grep -i usb

    This may return multiple USB device names for the computer.

  3. Run the following command, where <usb_serial_device> is one of the serial USB device names from the previous step:

    sudo screen /dev/<usb_serial_device> 115200

    For example, for Linux, you might enter sudo screen /dev/ttyUSB0 115200.

  4. Press Enter three times to initiate the serial console session.

Navigate the serial console Direct link to this section

On-screen instructions display how to navigate the serial console UI. Generally, you can perform the following actions using these keys:

Serial console tasks Direct link to this section

These are the tasks available while using the serial console with an activated appliance:

Note: Leaving the serial console session idle while performing a task returns you to the main task screen without applying changes.

Update the network parameters Direct link to this section

To update the network parameters:

  1. Navigate to the main task screen.
  2. Select Reconfigure on the management interface.
  3. Select either DHCP or Static networking as the option that you wish to configure your management interface with.
  4. If you selected Static networking, edit the following fields:
    • IP address
    • Netmask/Subnet
    • Primary DNS server
    • Secondary DNS server
    • Gateway
  5. Select Next. This runs a series of connectivity tests. If the tests:
    • Pass — You are redirected to the main task screen.
    • Fail — Select Back to return to the previous screen. Change the configuration and retry the connectivity tests.

View the current configuration and connectivity status Direct link to this section

To display the current device configuration details:

Note: You cannot make any modifications to the configuration from this screen.

  1. Navigate to the main task screen.
  2. Select Show the current configuration. The following information displays:
    • Customer-ID — The customer ID.
    • Deployment-ID — The deployment ID.
    • Deployment-Type — The deployment type. This can be Internal Tap, Mirroring, or Scanner.
    • Network Type — The network type. This can be DHCP or Static networking.
    • Connectivity to Switchboard 1 and Connectivity to Switchboard 2 — The connectivity status of the appliance. This can be PASS or FAIL.
  3. Select Next to return to the main task screen.

Reconfigure the deployment type Direct link to this section

You can reconfigure the deployment to a different deployment type. To reconfigure the deployment:

  1. Navigate to the main task screen.
  2. Select Reconfigure the deployment type.
  3. Select either Internal Tap, Mirroring, or Scanner.
  4. Select Next to return to the main task screen.

Note: You may need to restart the appliance to apply the new deployment type.

Restart the appliance Direct link to this section

To restart the appliance, navigate to the post-activation screen and select Reboot the device.

Configure an appliance to use a proxy server Direct link to this section

Proxy servers for appliances are configured using the serial console.

Notes:

Requirements Direct link to this section

Steps Direct link to this section

  1. Connect to the serial console. See Connect to the serial console for steps to connect to the serial console.

  2. Select Next to navigate to the next screen. See Navigate the serial console for more information.

  3. The option Use a proxy? Select an option: appears.

  4. Select Yes.

  5. From the Provide the following proxy information dropdown complete the following:

    • Server IP address — The proxy server IP address for your appliance.
    • Server port — The proxy server port information.
  6. Select Next to navigate to the next screen.

    A confirmation message reading Applying configuration appears while the configuration is being applied.

    Caution: This process can take up to several minutes to complete. Do not navigate away from this screen or close the serial console session until the configuration has been applied.

    When the configuration has been applied, the option to verify the network connection appears.

  7. Select Yes to run the network connectivity tests.

    Note: Verifying the network connectivity is not required, but strongly recommended by Arctic Wolf.

    Caution: Ensure that a network cable is plugged in prior to verifying the network connection.

  8. Select Next.

  9. If you selected Yes to run the connectivity tests, a series of connectivity tests are run.

  10. If the connectivity tests:

    • Pass — Select Next.
    • Fail — Select Back to return to the previous screen. Change the configuration and retry the connectivity tests.
  11. Select Next.

  12. If you want to configure more post-activation settings, select the Next button to be brought to the main task menu.