...
| File | Description |
|---|
| charon_cleanshutdown.ps1 | Powershell PowerShell main script |
| charon_cleanshutdown_Windows.exp | Expect script, launched by the Powershell PowerShell script if 'expect' is selected |
| rsh.exe | Used if 'rsh' mode is selected |
| template.ini | Used to facilitate the creation of a customized configuration file for the CHARON instance |
| plink.exe | Taken from www.putty.org and used with "expect" mode only (see further) |
| psexec.exe | Taken from Microsoft Sysinternals and used in case of integration to Windows shutdown |
...
| Tru64 | /sbin/init 0
|
|---|
| OpenVMS | @SYS$MANAGER:CHARON_SHUTDOWN.COM
is executed for "rsh", "ssh" and "opa0" modes. If "expect" is used,the following command is executed: @SYS$SYSTEM:SHUTDOWN 0 SHUTDOWN NO YES LATER NO NONE
|
|---|
Requirements
Powershell PowerShell V5.1 or newer version is required.
...
c:\Charon>powershell -command "Unblock-File -path c:\charon\charon_cleanshutdown.ps1" |
See Powershell PowerShell version, upgrade, enabling scripts execution, tips and tricks.
...
| Mode | Description | Requirements | Notes |
|---|
| expect | Simulates an interactive connection to the console of the CHARON instance and performs the necessary actions. |
| Warning |
|---|
| Expect is supported only on Windows Server 2008 R2 and Windows 7. Windows Server 2012 R2, Windows Server 2016 and Windows 8.1 and 10 are not supported. |
Download and install TCL from http://www.activestate.com/activetcl/expect. Select the "x86" version, not "x64" as 'expect' is not included in the "x64" kit. Do not install a package version higher than ActiveTcl8.6.4.1.299124-win32-ix86-threaded as the Expect kit could be missing. This kit can also be downloaded here.
Open a command window (cmd.exe), go to c:\tcl\bin and run: C:\tcl\bin> teacup install Expect |
 Case sensitive: 'Expect' must be entered as shown (not 'expect').
.
- Download
plink.exe from the www.putty.org web site: click on the "You can download PuTTY here." link and copy plink.exe to the same folder (recommended) as the Powershell PowerShell and Expect scripts (C:\Charon for example).
| - Does not work if the console is running an application. Works only if the console is at the SRM prompt, prompting for username or password, or at the shell prompt.
- Does not work if a connection to the console is already active from another host than the CHARON server.
- If the password of the guest operating system changes, either the encrypted clixml file has to be updated or the password stored in clear text in the configuration file.
- Useful if TCP/IP is not available on the guest operating system running on the CHARON instance.
- This method is end of life, will be replaced by "opa0" mode (see below) that is supported on modern Windows versions
|
| opa0 | Connection to the OPA0 console via telnet on the specified port using PowerShell internal functions | The 'SYS$MANAGER:CHARON_SHUTDOWN.COM' script must exist on the emulated VMS system. No requirement if Tru64 is used. | - Does not work if the console is running an application. Works only if the console is at the SRM prompt, prompting for username or password, or at the shell prompt.
- Does not work if a connection to the console is already active from another host than the CHARON server.
- If the password of the guest operating system changes, either the encrypted clixml file has to be updated or the password stored in clear text in the configuration file.
- Useful if TCP/IP is not available on the guest operating system running on the CHARON instance.
|
| rsh | Executes a remote command on the guest operating system (TCP/IP is required). On Tru64 the .rhosts file must be configured and on OpenVMS the rexec/rsh services must have been enabled and a proxy must have been created. | The 'rsh.exe' file is included in the kit. Copy it to a folder of your choice ("C:\Bin" or "C:\Charon" for example). The Charon Windows server and the emulated operating system must be able to communicate via TCPIP. The 'SYS$MANAGER:CHARON_SHUTDOWN.COM' script must exist on the emulated VMS system. No requirement if Tru64 is used. | - Not subject to password change.
|
| ssh | Executes a remote command on the guest operating system over a secure connection (TCP/IP is required). | Download and install OpenSSH from the https://github.com/PowerShell/Win32-OpenSSH/releases web site or preferably the version attached to this document. As a user with Administrator privileges, extract the package to C:\Program Files\OpenSSH. The Charon Windows server and the emulated operating system must be able to communicate via TCPIP. The 'SYS$MANAGER:CHARON_SHUTDOWN.COM' script must exist on the emulated VMS system. No requirement if Tru64 is used. | - Not subject to password change.
- Secure connection.
|
...