Introduction

Important note

This document applies to Linux Utilities kit version 41 minimum dated August 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 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-VAX V4.6 Build 165-02 minimum
Scripts have been tested and validated on the following Linux distributions/versions:
Fedora 20
Red Hat Enterprise Linux Server release 6.2 to 6.6
Red Hat Enterprise Linux Server release 7 and 7.1

The following packages have to be installed on the CHARON server:

- telnet (mandatory for console connection)
- expect (recommended if ssh cannot 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/charon folder 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).
`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
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.

CHARON Linux Toolkit - Kit 41