Connect to guest console

Table of contents

Description

Use this option to connect to the guests consoles.

Notes:

• "telnet" package must be installed, it will be used to connect from the CHARON server to the virtual machine console
• The session will be recorded in a log file:
  • If 'set OPA0 log=' is found in the configuration file (not available with all CHARON products versions), the log will be stored in the temporary folder: '/tmp/console.<configuration file name shortened>.tmp.log' and will be overwritten for each session. It is just kept for information as the console log is managed by the CHARON emulator itself.
  • If there is no 'set OPA0 log=' line in the configuration file, the file will be located in '/opt/charon/log/console.<configuration file name shortened>.log'
• If 'stop_on' and/or 'break_on' features are enabled in the configuration file, this will be reminded before starting the telnet session

• To leave the telnet session, press the escape character which is by default CTRL + ] . This character can be changed in the /root/.telnetrc file by defining the 'set escape' parameter:
  Example:

  # cat /root/.telnetrc DEFAULT   mode char   set escape ² #

  Pressing the escape key will lead you to the 'telnet> ' prompt. To leave the session, enter 'quit'

• If a connection to the console is active from the server, you will be prompted to kill the previous one.
• If a connection to the console is active from another location, it will be displayed but will not be killed. This will have to be done manually.
• Emulator termination check:
  
  • For CHARON-AXP, if the 'power off' command is detected (or shortened command), the guest STOP state will be set to REQUESTED
  • If the emulator is no more running when you leave the session, you will have to confirm that is requested or not
• The console port number is displayed per guest. If a port number is used more than once, an alert will be displayed

Autoconnect feature

This feature has been implemented to prevent from buffer issues with CHARON-AXP versions V4.4 and older where a connection to the console had to be active for the guest not to be blocked (hang). This could prevent from booting the system.

Advantage of this feature is it will record console output for CHARON products versions that have not the console log feature implemented and activated: every 1 minute, a crontab job (/opt/charon/utils/charon_console_autoconnect) will check if a connection to the console is active or not. If not, a telnet session with output log recording will be engaged in the background.

This feature is disabled by default and can be enabled from this menu. It is automatically disabled for the guest that have console log recording with the 'set OPA0 log=' option.

Special comments in configuration file

For ease of use, it is possible to add formatted comments in the configuration file. These comments will appear before connecting to the console and can be used to describe the configuration, disks usage, etc...

To enable this feature, edit the configuration file and add comments starting with "#INFO:"

Example:

Example