Table of contents
Important note
This document applies to Linux Utilities kits version 42, dated December 2015 and version 43, dated January 2016
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 products
CHARON qualified versions:
CHARON-AXP V4.4 Build 147-07
CHARON-AXP V4.5 Build 155-05 minimum
CHARON-AXP V4.6 Build 166-03 minimum
CHARON-AXP V4.7 Build 171-01 minimum
CHARON-VAX V4.6 Build 165-02 minimum
CHARON-VAX V4.7 Build 171-01 minimum
Scripts have been tested and validated on the following Linux distributions/versions:
Fedora 20, 21 and 22
Red Hat Enterprise Linux Server release 6.2 to 6.6
Red Hat Enterprise Linux Server release 7 and 7.2
- The following packages have to be installed on the CHARON server:
telnet(mandatory for connection from the CHARON server to the virtual machine console)expect(recommended ifsshcannot be used to execute shutdown commands from the console)ssh(recommended for executing shutdown commands with trusted connection between the CHARON server and the CHARON virtual machine)evince(recommended for reading online documentation)sendmail(mandatory)screen(mandatory)firefox
- All described operations will have to be performed on the CHARON server and logged in as 'root' (no other user supported).
The 'menu' must be used by one user at a time only - CHARON-AXP and CHARON-VAX installations are supported when installed in
/opt/charonfolder only - Mail service must have been configured.
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). |
| Bold monospace type in interactive examples indicates typed user input. |
| Bold monospace type enclosed by angle brackets indicates command parameters and parameter values. |
| 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. |
| 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 |
| vim | Test | Advanced users with more features (colored) |
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. A recipient list can be defined in this case
- Wall notification can be disabled from the menu
- The alert script can be customized and then you can use command lines linked to your monitoring software and disable emails for example
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.