Oracle Cloud Infrastructure Documentation

Operating the Serial Console

The Roving Edge device has a Serial Console that enables you to administer the device by connecting directly to the device.

To use the serial console, perform these actions:

  1. Connect a local computer, such as a laptop to the device serial port. See Cable the Roving Edge Device.
  2. Set up terminal emulation on the local computer, See Set Up Terminal Emulation.
  3. Power on or reboot the device, and the Serial Console prompts you for the passphrase to unlock the device, then displays the Serial Console main menu. The passphrase was created when the device was requested, but it can be changed any time using the Serial Console.

The device Serial Console provides the following menu options:

  • Unlock Device: Use to unlock the device using an unlock passphrase obtained from the device's node resource in Oracle Cloud Infrastructure.

  • Change Passphrase: Use to update the device's unlocking passphrase. This passphrase is listed in the Details section of your node in the OCI Console.

  • Configure Networking: Use to configure IP address, subnet, and gateway for the device. You can also configure DNS, NTP, and the public IP pool range for Compute VM instances through this command. See Configure Network Parameters.

  • Show Status: Use to display the device software version, lock or unlock status, and other device information.

  • Show System Diagnostics: Use to display diagnostic information regarding the device's system attributes.

  • Shutdown Device: Use to shut down the device.

  • Reboot Device: Use the reboot the device.

  • Enter Safe-Mode: Contact support before using Safe-Mode, use when the storage is full resulting in write and/or read errors. At this storage capacity level the Compute service and other device operations are suspended. While in safe mode, you can remove items from object storage until the capacity is lower, preferably at 80% or less. See Avoiding Storage Overages Using Safe Mode.

  • Exit Safe-Mode: Use to take the device out of safe mode after you have lowered the device's storage capacity level. See Avoiding Storage Overages Using Safe Mode

  • Shred Key: Use to destroy or "shred" the master key of your device. Run this command if you believe the device's has been compromised or is unsafe and is likely to be compromised. See Shredding the Master Key

  • Recover Key: Use to recover a device whose key has been shredded and return it to service. See Recovering Your Device after Shredding the Master Key.

  • Reset Device: Use to reset the device, either to factory level (objects in object storage are deleted) or service level (objects in the object storage retained.). See Resetting Devices.

  • Advance Menu: Use to access additional menu commands:

    • Banner Management: Use to run various banner tasks. The banner is the default message that appears when you attempt to log into the device. See Managing the Banner.

    • Network Management: Use to display the status various network-related topics. See Managing the Network.

    • Password Management: Use to specify the number of user login attempts allowed. See Managing Your Password.

  • Node Health: Use to monitor the storage health in Roving Edge Infrastructure device nodes. Storage health covers following components:

    • Block storage health

    • Object storage health

    • Storage backend services health

    • Disk health

    The health of a service on a device node is determined by the following classifications:

    • AVAILABLE: The service is available, and all components are functional.

    • WARNING: The service is still functional, but some minor issue is happening and we may need to pay attention.

    • DEGRADED: The service is partially functional and some components have issues.

    • UNAVAILABLE: The service is not responding or some components have critical issues which make the service not functional.

  • Diagnostics: Use to run tasks related to collecting diagnostics data related to Roving Edge Infrastructure device performance. You can collect the diagnostics data and forward it to Oracle for analysis. See Collecting Device Diagnosis Information.

  • Help: Use to display the online help for the Serial Console.