Serial console

Connect a serial console to the virtual machine.

If enabled, a Console resource is associated with the virtual machine and tagged with the virtual machine's resource tags.

Properties

Enable

Enable the virtual machine's serial console.

  • Data type: boolean
  • Default: true
  • Configuration

CLI: (cli)> config compute vm <key> console enable

Mode

The mode of operation for this serial port.

The serial port mode determines how serial port is accessed and what options are allowed when connected.

OptionLabelDescription
remoteRemote accessAccess an external serial appliance remotely. Suitable for remotely accessing a serial console on servers or other appliances, and if required, interacting with those appliances via their serial interface.
loginSystem loginProvide a traditional login service. A login service will allow remote CLI access to this device. A console server, modem or other appliance can be used to access the CLI on this device via the serial port.
  • Data type: string select
  • Default: remote
  • Configuration
  • Required

CLI: (cli)> config compute vm <key> console mode

Escape character (ASCII character code)

The escape character to enter for menu and command access.

Enter the escape character followed by a command character while connected to a serial port in order to access the menu or serial port commands. The following sequences are possible:

 Escape-Char 'q' : quit
 Escape-Char 'b' : send serial break
 Escape-Char 'd' : list or disconnect other sessions
 Escape-Char 's' : port history (graphical terminal only)
 Escape-Char '?' : help

The table below lists the decimal values for the escape character, control characters are prefixed with '^'.

00102030405060708090100110120
0^J^T^^(2<FPZdnx
1^A^K^U^)3=GQ[eoy
2^B^L^V^?*4>HR\fpz
3^C^M^W!+5?IS]gq{
4^D^N^X",6@JT^hr
5^E^O^Y#-7AKU_is}
6^F^P^Z$.8BLV`jt~
7^G^Q^[%/9CMWakuDEL
8^H^R^\&0:DNXblv
9^I^S^]'1;EOYcmw
  • Data type: integer
  • Default: 30
  • Minimum: 1
  • Maximum: 255
  • Configuration
  • Required

CLI: (cli)> config compute vm <key> console escape-character

Single user mode

Allow only one user at a time.

The port will allow a single user to connect. While a user is connected, all other connection requests will be rejected and logged.

  • Data type: boolean
  • Default: false
  • Configuration

CLI: (cli)> config compute vm <key> console single-user