Setup

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, here we assume the tar file was downloaded in the /charon folder:

  # mkdir -p /opt/charon/utils # cp /charon/charon_linux_utils.kit<number>.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_linux_utils.kit<number>.tar .

  .

• All scripts can be configured using a menu. In order to activate the ‘menu’ command, execute the following commands:

  # ./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: Terminal settings)
    
    
• Mandatory packages installation will be checked (telnet, screen, etc..)
  • if one package is missing you will not be able to continue
    
    
• If telnet is installed, you will be prompted to force the mode to character to avoid some input issues while connected to the guests console
  
  
• Recommended packages installation will be checked (expect, evince)
  • if one package is missing you will be able to continue, installation of these packages can be done later if needed
    
    
• The 'menu' alias will be created, this will be the command you'll use to access the menu
  
  
• Recursive 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: at first time leave the editor without any update, a check will be performed and will add the missing entries. You'll then be rerouted to the crontab editor to check
    
    
• Emails alerts parameters will now have to be filled
  • select between HTML or pure TEXT emails
  • customize emails footer: you can add here your disclaimer, information on Charon server or any information you think useful
  • enter the recipients list, one recipient per line
  • select the alert level from guests log files: 0 = none, 1 = informational+warning+error entries, 2 = warning+error entries, 3 = error entries only
    
    

• When the setup is completed either log out to activate the 'menu' alias or execute the following command:

  # . /etc/profile.d/charon_menu*