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
.

Install the CHARON Linux Toolkit as described in the Setup page.
.
Install the CHARON product(s) you need from menu option "Install/Upgrade/Remove Charon"
.
Dedicate network interfaces to CHARON using menu option "Network Configuration Utility" (see your CHARON product documentation / networking chapter).
.
Check the license can be read using the "HASP license details" menu option
.
Prepare your configuration file(s) or use the clone utility available from the "VM management - Update guests list" menu (see further).
.

Prepare your storage configuration and create your vdisk files using the "mkdskcmd" command if needed.
Example:
# mkdskcmd -o /data/vms0_rz28.dsk -d rz28
.

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 or not 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.
  It is recommended to test your shutdown scripts before going on production
  .
- The log file monitoring service is created automatically.
Connect to the guest console using the "Connect to guest console" menu option (from the "VM Management" menu) and install or restore the operating system. If 'telnet' is not installed, you can connect via putty for example ( in this case some firewall settings will have to be set, see Connection to guest console blocked by firewall )
.

Command	Description
`# vmlist`	Virtual machines list and status
`# logview`	Virtual machine log view
`# logtail`	Virtual machine log tail (continuous view)
`# vmstart`	Virtual machine start
`# vmstop`	Virtual machine stop ('`#` `vmstop -f`' to avoid confirmation)
`# vmconsole`	Connection to the virtual machine console
`# vmrmc`	Connection to the virtual machine Remote Management Console (if defined)
`# vmcfg`	Virtual machine configuration file editing