Product Documentation and Knowledge Base - HomeDocumentation


Charon-SSP


Serial Line Configuration

Contents

Vconsole Configuration (Charon-SSP/4V only)

The Vconsole represents the serial console device of a Charon-SSP/4V instance. To view or change the current virtual machine console configuration, select Vconsole in the left-hand pane of the Settings window. This opens the Vconsole configuration window, shown below.

The emulated terminal type can have one of four values as described below. Use the Type drop-down list to set the value.

  • TCP raw: configure the console device as a network device (TCP socket) without any protocol enabled.

  • Telnet: configure the console device as a network device (TCP socket) with the telnet protocol enabled.

  • Physical: configure the console device as physical terminal directly attached to the host system. For a cloud instance, this could be a virtual serial line provided by a serial line server (terminal server).

  • Disabled: disable the virtual console device entirely.


Vconsole Network Configuration

When configuring a network console device, the user can select one of two modes:

  • TCP raw (serial line without protocol), or
  • Telnet (serial line with telnet protocol support).

Network Vconsole Configuration Options and their Functions

Port:

This option specifies the TCP/IP port to use when listening for incoming console client connections. A different port must be specified for each network console and serial port used on the same Charon-SSP host system.

(warning) Using a port that is already in use results in error messages in the virtual machine log file similar to the following.

To access the console of a guest system across the network without, make sure the port configured for the console is permitted by any intermediate firewalls and/or security groups. If using the built-in console function of the Charon Manager in combination with the Charon Manager SSH tunnel, the console port is redirected through this SSH tunnel.

Console:

For Charon-SSP cloud-specific products, the value of this parameter is fixed to Built-in. The built-in console is displayed and accessible from the Console tab in the Charon Manager. The console process listens on TCP port 9000 by default.

Access:

(info) Introduced with version 3.1.26.

Possible values:

Unlimited: Connection to the console is possible via a remote network connection.

Local only: Connection to the console is only possible from the local host.

Log:

When this box is checked, Charon-SSP writes a console log file. The log can be viewed on the Charon Manager Log tab.

Please note: the log file configured here is separate from the file the Charon-SSP Manager uses to cache the console output for the built-in serial console of the Charon-SSP Manager.

Vconsole Physical Line Configuration

The image below shows the configuration window for a physical console device of a Charon-SSP/4V system.

Physical serial console configuration options:

  • Device: opens a file browser to let the user select from the directly attached serial ports available on the host system (tty* devices).

  • Log: used to enable and disable the console log. 


TTYA Configuration

To view or change the current virtual machine console configuration, select TTYA in the Device column of the left-hand pane of the configuration window. This opens the TTYA configuration window, shown below. In this example, TTYA is disabled.


(info) On Charon-SSP/4U and Charon-SSP/4M, TTYA can be configured as the serial console or, if the graphical device is configured to be the system console, TTYA can be used as a normal serial line. On Charon-SSP/4V systems, it can only be used as a normal serial line.

The emulated terminal type can have one of four values as described below. Use the Type drop-down list to set the value.

  • TCP raw: configure the console device as a network device (TCP socket) without any protocol enabled.

  • Telnet: configure the console device as a network device (TCP socket) with the telnet protocol enabled.

  • Physical: configure the console device as physical terminal directly attached to the host system. For a cloud instance, this could be a virtual serial line provided by a serial line server (terminal server)

  • Disabled: disable the virtual console device entirely.

The following sections describe the specific configuration details of physical and network consoles.

TTYA Physical Line Configuration

The image below shows the configuration window for a physical console device of a Charon-SSP/4U system.

Physical serial console configuration options:

  • Device: opens a file browser to let the user select from the directly attached serial ports available on the host system (tty* devices).

  • Log: used to enable and disable the console log. 


TTYA Network Configuration

When configuring a network console device, the user can select one of two modes:

  • TCP raw (serial line without protocol), or

  • Telnet (serial line with telnet protocol support).

Please note that TTYA cannot be used as the serial system console for Charon-SSP/4V systems. Such systems must use the Vconsole device.

The image below shows the configuration window for a network console device with telnet protocol support on a Charon-SSP/4U system:



TTYA Network Console Configuration Options and their Functions

Port:

This option specifies the TCP/IP port to use when listening for incoming console client connections. A different port must be specified for each network console and serial port used on the same Charon-SSP host system.

(warning) Using a port that is already in use results in the following error messages in the virtual machine log file.

To access the console of a guest system across the network, make sure the port configured for the console is permitted by any intermediate firewalls and/or security groups. If using the built-in console function of the Charon Manager in combination with the Charon Manager SSH tunnel, the console port is redirected through this SSH tunnel.

Console:

(info) Not applicable to Charon-SSP/4V. Please refer to the Vconsole section instead.

(info) Option is not visible if graphics device is configured with console enabled. 

For Charon-SSP cloud-specific products, the value of this parameter is fixed to Built-in. The built-in console is displayed and accessible from the Console tab in the Charon Manager. The console process listens on TCP port 9000 by default.

Access:

Possible values:

Unlimited: Connection to the console is possible via a remote network connection.

Local only: Connection to the console is only possible from the local host.

Log:

(info) Not applicable to Charon-SSP/4V.

When this box is checked, Charon-SSP writes a console log file. The log can be viewed on the Charon Manager Log tab.

Please note: the log file configured here is separate from the file the Charon-SSP Manager uses to cache the console output for the built-in serial console of the Charon-SSP Manager.

TTYB Configuration

To view or change the virtual machine TTYB configuration, select TTYB in the Device column of the left-hand pane of the configuration window. The virtual TTYB serial device can be configured as both a physical or network connected device. The configuration of this device is very similar to TTYA. For further details related to configuring this device, consult the section TTYA Configuration.





© Stromasys, 1999-2024  - All the information is provided on the best effort basis, and might be changed anytime without notice. Information provided does not mean Stromasys commitment to any features described.