...
| Table of Contents | ||
|---|---|---|
|
Description
| Status | ||||
|---|---|---|---|---|
|
If the script does not exist, it will be generated automatically based on existing guests list and will by default do nothing except preparing the script skeleton . 
If guests are added after the script initialization, they will have to be inserted manually. This consists in adding a chapter for the new configuration file in the "case in..." commandwith commands using the provided script examples to perform the shutdown via either "expect", "rsh" or "ssh". Newly added virtual machines will have their "case" added to the script when it will be edited.
To be able to perform a clean shutdown of your Tru64 or OpenVMS virtual machine, you will have either to use the provided scripts (see above) or to add your own shutdown scripts or .
If you plan to use the examples provided in the "charon_gstart.stop.example" script located in the "/opt/charon/utils" folder.In this script, examples are provided for clean shutdown using "ssh" or "expect" thanks to the "guest_shutdown.exp" script (provided as an example). See "expect" utility, please read Tips and Tricks - Shutdown guests with Expect tool for more.
Notes:
Basic knowledge of shell programming is needed to implement the clean shutdown / stop script.
...
| Method | Comments |
|---|---|
expect | Requires you pass user and password to the script |
...
so that it |
...
can connect to the OPA0 console via |
...
" |
...
" and execute the shutdown commands. The "
|
...
|
...
|
...
|
...
|
...
|
...
This method is useful if the virtual machine has no telnet connection available. Important notes:
|
...
|
...
rsh | Requires a trust to be created between the Linux server and the Tru64 or OpenVMS guest (proxy) |
ssh | Requires a secured trust to be created between the Linux server and the Tru64 or OpenVMS guest (key pair) |
| Info | ||
|---|---|---|
| ||
If your application and server needs time to shutdown, it could be necessary to give more time in the service definition to prevent from the service stop procedure to fail due to timeout. To do so, open the " Example:
|
More information can be found using the "Options
TO BE CONTINUED
Explanation on the example file
...
An ssh trust between the CHARON Linux server and the Tru64 guest must have been previously configured in order to use this method. See Tips and Tricks for help to setup the trust.
...
...
...
Principle
- Check the guest can be reached via "
ssh" (adapt the ConnectTimeout value to your needs), if yes, issue theshutdowncommand, wait a few seconds and check if the guest can be "pinged" and repeat with an interval of 5 seconds. If the guest cannot be pinged, assume the shutdown procedure is complete - Kill the emulator process (Red Hat Enterprise Linux 6.x) or use the service kill command (RHEL 7.x and CentOS 7.x). Note: the shutdown commands does not power off nor stop the emulator process, that's why this operation is needed
- Report the stop information within the guest log file
...
An ssh trust between the CHARON Linux server and the OpenVMS guest must have been previously configured in order to use this method. See Tips and Tricks for help to setup the trust.
...
...
| color | #5078D0 |
|---|
...
Principle
- Check the guest can be pinged (an "
ssh" command as for the Tru64 example above can also be used), if yes, issue theshutdowncommand, wait a few seconds and check if the guest can be "pinged" and repeat with an interval of 5 seconds. If the guest cannot be pinged, assume the shutdown procedure is complete - Kill the emulator process (Red Hat Enterprise Linux 6.x) or use the service kill command (RHEL 7.x and CentOS 7.x). Note: the shutdown commands does not power off nor stop the emulator process, that's why this operation is needed
- Report the stop information within the guest log file
...
Example with Expect tool, Tru64 guest
...
| color | #5078D0 |
|---|
...
- Check if there's an active connection to the console on the local host, kill if any.
Reminder: If the console is locked from an external connection or if the prompt is not detected after sending a carriage return, the expect script will fail. - Replace the user (EXPUSR), password (EXPPWD) and shell prompt (EXPPRT) with the ones corresponding to your guest (shell prompt is used to determine if a user is logged on the console)
- Execute the "
expect" script and report all output to/opt/charon/log/console.stop.<guest name>.log. Note: no need to kill the emulator process here as the "power off" command is executed.
...
Example with Expect tool, AXP VMS guest
| Highlight | ||
|---|---|---|
| ||
Principle |
- Check if there's an active connection to the console on the local host, kill if any.
Reminder: If the console is locked from an external connection or if the prompt is not detected after sending a carriage return, the expect script will fail. - Replace the user (EXPUSR), password (EXPPWD) and shell prompt (EXPPRT) with the ones corresponding to your guest (shell prompt is used to determine if a user is logged on the console)
- Execute the "
expect" script and report all output to/opt/charon/log/console.stop.<guest name>.log. No need to kill the emulator process here as the "power off" command is executed.
...
Example with Expect tool, VAX VMS guest
| Highlight | ||
|---|---|---|
| ||
Principle |
- Check if there's an active connection to the console on the local host, kill if any.
Reminder: If the console is locked from an external connection or if the prompt is not detected after sending a carriage return, the expect script will fail. - Replace the user (EXPUSR), password (EXPPWD) and shell prompt (EXPPRT) with the ones corresponding to your guest (shell prompt is used to determine if a user is logged on the console)
- Execute the "
expect" script and report all output to/opt/charon/log/console.stop.<guest name>.log.- VAX systems have no "
power off" command so the F6 key will be sent. - The F6 key can be enabled or not in the configuration file. The expect script will send it if the "
power off" command fails and if F6 operation fails, it will exit with return code 9 meaning the emulator process will have to be killed. - If the "
expect" script returns the error code 9, this means the F6 key is not defined in the configuration file and then the emulator process must be killed - Report the stop information within the guest log file
- VAX systems have no "
...
This status line is the result of the command you executed for that guest (known by its configuration file), for example a ping, an ssh command displaying uptime (Tru64) or boottime (OpenVMS).
Display output example:
| Div | ||
|---|---|---|
| ||
...