Installation

The tools are provided in a tar file that must be extracted into the /opt/charon/utils folder.

• If the folder does not exist, by default created at Charon installation, create it and copy the tar file in this directory. In the example below, we assume the tar file was downloaded in the /charon folder:

  # mkdir -p /opt/charon/utils # cp /charon/Charon-PAR_Linux_Toolkit.V1.3.tar /opt/charon/utils

  .

• Extract the files from the tar file to the Charon installation directory, subdirectory ‘utils’

  # cd /opt/charon/utils # tar –xf Charon-PAR_Linux_Toolkit.V1.3.tar

  .

• Execute the installation script:

  # ./menusetup

  .

• The setup will check first your terminal settings, if set to VT100 you will not be able to continue until you set the TERM value to VT200, dtterm or xterm (see how to here: Configuration)

• Mandatory and recommended packages installation will be checked.
  • If some mandatory packages are missing you will not be able to continue.
  • If some recommended packages are missing, installation will continue. Installation of these packages can be done later if needed

• If 'telnet' is installed, you will be prompted to force the mode to character to avoid some input issues while connected to the guests consoles

• The 'menu', 'logtail', 'logview', 'vmlist', 'vmstart', 'vmstop', 'vmconsole' and 'vmcfg' aliases will be created. They will be the commands you'll use to access the menu or to view and manage virtual machines using command lines.

• Preferences can be defined during the setup or later, they are related to the default editors used with text and graphical user interfaces, Out Of Memory (OOM) Killer settings and continuous log view when starting a guest (virtual machine)

• Recurring jobs will be added in the crontab file:
  • if the crontab file does not exist, it will be automatically filled
  • if it already exists, you will be prompted to update it via the selected editor: a check will be performed and the missing entries will be added

• Alerts parameters will now have to be filled (see Alerts management chapter for more if needed)
  
  • Select between HTML or pure TEXT emails
  • Mail recipients list (used for alerts, not for sending files like log and configuration files for example)
  • Mail sender (can be used to change the displayed name of the sender)
  • Customize emails footer: if needed, add here your disclaimer, information on the Charon server or any information you think useful
  • Enable/disable wall alert messages
  • Install or update the alert script. It can be customized later, in this case it is recommended to do this once the virtual machines are installed

  • Select the alert level from guests log files: 0 = none, 1 = informational+warning+error entries, 2 = warning+error entries (default), 3 = error entries only

  • View alerts if any

  • Send immediate alert on dongle removal or not (with counter alert)

  • The alerts simulator can be used to send all the know alerts via email (for checks)

  • Reduce the number of warning messages sent on dongle removal or not
    

    Example:

    

     

• When the setup is completed, either log out and login again to define the command aliases or execute the following command:

  # . /etc/profile.d/charon_menu.sh