Table of Contents

...

The service works with a guests list containing the emulator executable file name, configuration file and, optionally, the auto_boot on server startup parameter ( at service level, not the same as SRM console levelthe emulated machine).

• Startup: the virtual machine is executed in detached mode (using ‘-dx’ parameter) and then requires the console port to be set as virtual serial line.
  • Connection to the console will be performed using telnet on the defined localhost / port. This can also be performed using other utilities like putty. If there is more than one guest on the server, guests are started in parallel.
  • Before the guest starts, the network interfaces used will be checked and all the offload parameters will be set offline.
    
    
• Shutdown: a common shutdown script can be created for guests shutdown. See "Service management - Create/Edit guest stop script" for details.
  
  • If the script does not exist, the virtual machine process is killed without proper guest shutdown. This is the equivalent of a server power off on Tru64 or OpenVMS side.
  • If the script exists, it executes the customer defined command lines to perform a proper shutdown (using ‘ssh’, 'rsh' or ‘expect’ for example). If the virtual machine process is still running after execution, the stop operation is considered as failed so for Linux systems not using systemd (Red Hat 6) the script must stop the emulator either by sending a “power off” at SRM prompt (AXP) or F6 key (VAX) with ‘expect’ or just by killing the process . For Linux systems using systemd (Red Hat Enterprise Linux/CentOS 7 and 8), the process is killed by the system (SIGKILL).
  • If there is more than one guest on the server, guests are stopped in sequential parallel mode during server shutdown based on their order in the guests list. This order can be modified from the menu. This is valid only for Linux systems not using systemd (Red Hat 6), for other systems. If a specific order is required, the services description files will have to be modified to add dependencies using Before= or After= for example. For more information, see manpages: # man systemd.unit

...

• The first part of the menu displays server information: server boot time, number of CPUs and Memory Free / Total.
• This description is valid for all menu options displaying the virtual machines list and for the "vmlist" command line.

• The second part displays the list of virtual machines (guests) managed. Column details:

  
  

  EmulatorDisplays the automatic boot on server startup value, YES or NO.
  This means the Charon virtual machine will be started. To automatically boot the virtual machine on startup, please refer to the Charon-AXP or Charon-VAX users guides and console settings

  Column	Description		Emulator used
  Configuration File	Configuration file name (shortened).
  CPU	Displays the number of CPUs by looking for the 'model' parameter into configuration file settings (set n_of_cpus ...) first then using default value for the selected hardwareand searching in a predefined file containing the list of models and cpu numbers. If no information is available, "-" is displayed instead. The number of CPUs displayed does represent the number defined in the configuration file or the default number of cpus for this hardware model. The real number of CPUs the virtual machine owns depends on the CHARON server hardware limitations, CHARON licenses and also licenses on the virtual machine side (Tru64 or OpenVMS)
  Memory	Displays the amount of memory defined in the configuration file (if defined). If no information is available, "-" is displayed instead.
  State For Red Hat Enterprise Linux 6.x can be either RUNNING, STARTING, STARTING/ALL (if all guests have been started at the same time), STOPPED. If the guest is in STOPPED state, an additional information will be displayed: REQUESTED: the service has been stopped by user request or has not been started on Linux server boot due to boot parameter set to off FAILURE: the guest process failed For Red Hat Enterprise Linux/CentOS 7 and 8 (using both systemd)	can be either ACTIVE, ACTIVATING, INACTIVE, DEACTIVATING, FAILED or UNKNOWN If the guest is in STOPPED state, an additional information will be displayed: REQUESTED: the service has been stopped by user request or has not been started on Linux server boot due to boot parameter set to off FAILURE: the guest process failed	OnBoot

  .

  .

• Depending on settings and virtual machine state, more information can be displayed

  • Emulator
  • Description
  • Auto-restart settings (. This feature is managed by systemd, described here: How to restart Charon-VAX/AXP on Linux automatically on failure ) and described in the Tips and Tricks chapter.
  • Service start and/or stop timeouts Description (not available on Red Hat Enterprise Linux 6.x as it is defined in the systemd service)and Start on boot. Start on boot value means the Charon virtual machine will be started on Linux server boot but not necessarily booted. To automatically boot the virtual machine on startup, please refer to the Charon-PAR and console settings.
  • Start/stop date if available
  • Stop script - Displays the status of the stop script used to perform a clean shutdown of the guest. Can be:
    • Not found: the script has not been created. If not found, a service stop request will induce a kill of the emulator process
    • To customize: the script exists and a case line has been added for the specified configuration file. It must however be customized with some commands to perform a clean shutdown of the guest (OpenVMS or Tru64 HP-UX or MPE/iX virtual machine).
      For more information and examples, see VM management - Create/Edit guest stop script
    • Case not set : the script exists but does not relate to the specified configuration file. This means it has either been created manually or initialized automatically by the menu and a new guest has been added after initialization.
    • [Using XXX] where XXX can be EXPECT, RSH or SSH: the script exists and a case line has been added for the specified configuration file and it uses the shutdown scripts provided with the kit
    • Customized : a customized script or command lines is/are used
  • Protected against Out Of Memory Killer (OOM Killer)
  • Pre-start script if defined (the 3 first lines are displayed)
  • Console port
  • Guest OS response (optional, see Service management - Create/Edit guest stop script / Optional guest display status script)
  • If the virtual machine is running and is using Charon-AXP or Charon-VAX version 4.9 minimum, the The license status is displayed (license found, in case of events: communication lost/restored, connection lost/application will stop, license expiration information)license found, ...
  • Network Interfaces settings with some checks performed. A NIC displayed followed by a number between parenthesis means an issue has been discovered: (1)=NIC does not exist, (2)=NIC is not managed by ncu (if installed), (3)=NIC is already used, (4)=NIC has an IP address.
    .

• The third part displays the available options that are detailed in the 20423737527 chapter further.

Example

Notes: 

• The A star besides the "ds20 / ds20vms" virtual machine means it has been started using the "vmstart ds20vms" command and emulator name means next commands lines like vmstop, vmcfg, and vmconsole will use this virtual machine if no other one is specified.
• If Auto-restart on failure is managed by systemd (not available on Red Hat Enterprise Linux 6.X). This is described here: How to restart Charon-VAX/AXP on Linux automatically on failureneeds to be set for this service, please read the Tips and Tricks chapter.
• "Description" and "Service Timeouts" are managed by systemd (not available on Red Hat Enterprise Linux 6.X). defined at service level. This is described here: VM management - Install, update or manage serviceManage 'systemd' services.
• "Guest OS answer" is based on an optional script performing an ssh connection to the Tru64 HP-UX system. This is described here: VM management - Create/Edit guest stop script. If the guest OS response returns error code 255, this means Tru64 or OpenVMS the legacy system is not booted (still at SRM prompt).

...

• or there is a network problem.

Menu options

...