Introduction

Important note

This document applies to Linux Utilities kit version 38 minimum dated 14-Jan-2015.

Kit download

To download the kit, you must issue a request via email to the Stromasys support team: support@stromasys.com

Prerequisites

Basic knowledge of Unix commands
Basic knowledge of Charon product
Charon qualified versions:
- Charon-AXP v4.4 build 14707
- Charon-AXP v4.5 build 15505 minimum
- Charon-VAX v4.6 build 16502 minimum
Scripts have been tested and validated on the following Linux distributions/versions:
- Fedora 17-20
  - Due to changes in service management with Fedora, clean shutdown of the emulated machines (guests) at Linux server shutdown is not functional with the current release.
- Red Hat Enterprise Linux Server release 6.2 to 6.5
The following softwares have to be installed of the Charon server:
- telnet (mandatory)
- expect (recommended if ssh cannot be used to execute shutdown commands from the console)
- evince (recommended for reading online documentation)
- sendmail (mandatory)
- screen (mandatory)
- firefox
All described operations will have to be performed on the Charon Linux server and logged on as 'root' (no other user supported)
Charon-AXP and Charon-VAX installations are supported when installed in /opt/charon only
Mail service must have been configured
The virtual machines (guests) log file name must be defined with full path within the configuration file. Rotating log files are not supported.

Conventions

Throughout the document(s) these conventions are followed

Notation	Description
$	The dollar sign in interactive examples indicates an operating system prompt for VMS. The dollar sign can also indicate non superuser prompt for UNIX / Linux.
#	The number sign represents the superuser prompt for UNIX / Linux.
>	The right angle bracket in interactive examples indicates an operating system prompt for Windows command (cmd.exe).
`User input`	Bold monospace type in interactive examples indicates typed user input.
`<path>`	Bold monospace type enclosed by angle brackets indicates command parameters and parameter values.
`Output`	Monospace type in interactive examples, indicates command response output.
[ ]	In syntax definitions, brackets indicate items that are optional.
...	In syntax definitions, a horizontal ellipsis indicates that the preceding item can be repeated one or more times.
`dsk0`	Italic monospace type, in interactive examples, indicates typed context dependent user input.

The following definitions apply

Term	Description
Host	The system on which the emulator runs, also called the Charon server
Guest	The operating system running on a Charon instance, for example, Tru64 UNIX, OpenVMS, Solaris, MPE or HP-UX

Note related to display/edit options

Some menu options will allow you to display or edit files using available editors (if installed) between:

Editor	Interface	Description
gedit	Graphical	Windows notepad like
emacs	Graphical	Windows notepad like, advanced
nano	Text	Basic text editor
vi	Text	Advanced users

Select the one you prefer or refer to 'man pages' for more information on available ones.

Note related to emails

There are 2 kinds of emails:

Results: some menu options will allow you to send results via email (example: license display, log and configuration files). The recipient will then be unique
Alerts: by default, the alert script will send alerts via email and 'wall' notifications (this can be customized). A recipient list can be defined in this case

Do not use Stromasys email address to send results directly, for example to support@stromasys.com. The sender will be unknown to us, it is then recommended to send results to yourself first and to forward us the mail you received.

Both require 'sendmail' to be installed and configured.