Quick Setup Guide

Introduction

This article summarizes the operations to be performed to make your emulator running with the Charon Linux Toolkit.

Preparation

  • Create a folder to store the Charon products and Charon Linux Toolkit(s)
    Example:

    # mkdir /charon

    .

  • Download the kits in this folder from the Stromasys sftp server using 'sftp' or your browser with the link provided by Stromasys.

    .

  • Optionally create a folder where to store your licenses (C2V and V2C files)
    Example:

    mkdir /charon/licenses

    .

  • Prepare your storage configuration and create your virtual disk files (see the Charon-PAR user's guide) if needed.

    .


Virtual machines creation

  • Use the "VM management - Update guests list" option from the "VM Management (add/remove VM, start, stop, console connection, ...)" menu option to add and start your new virtual machine (guest)
    .
    • Optionally, use option "Enable/Disable start at server boot" to prevent the guest from starting automatically when the Linux server is booted
      .
    • Optionally (but highly recommended), use option "Create/Edit guest stop script" to define the stop script that will be used to perform a clean shutdown of the virtual machine at service stop.
      (lightbulb) It is recommended to test your shutdown scripts before going on production
      .
    • (info) The log file monitoring service is created automatically.


Post installation checks

  • You can remove the USB dongle, if any, to verify the dongle removal is identified by the askusbd log monitor service:
    .
    • If you enabled the 'wall' alerts from the "Alerts management" menu, you should receive an immediate 'wall' message.
      .

    • If you disabled the 'wall' alerts from the "Alerts management" menu (default), you can have a look at the alerts history from the "Alerts management" menu
      .
    • If the mail has been correctly configured, you will receive an alert with subject: "[Charon] License dongle disconnected" quite immediately (please ensure the email has not been moved to the junk folder). The immediate alert can be followed by an alert coming from the virtual machine log monitoring announcing the time remaining before stop

Virtual machine(s) management

To avoid navigating in the 'menu' options, use the Additional command lines for ease of management:

CommandDescription
# vmlistVirtual machines list and status
# logviewVirtual machine log view
# logtailVirtual machine log tail (continuous view)
# vmstartVirtual machine start
# vmstopVirtual machine stop ('# vmstop -f' to avoid confirmation)
# vmconsoleConnection to the virtual machine console
# vmcfgVirtual machine configuration file editing



© 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.