Kit download
Download the kit from our SFTP server (please ask us connection credentials if you have no access) and extract all files in a dedicated folder, "C:\Charon" for example.
The kit contains the following files:
| File | Description |
|---|---|
| charon_cleanshutdown.ps1 | Powershell main script |
| charon_cleanshutdown_Windows.exp | Expect script, launched by the 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 |
| psexec.exe | Taken from Microsoft Sysinternals and used in case of integration to Windows shutdown |
Shutdown command
Depending on the guest operating system running on the CHARON instance, the following commands are executed to perform a clean shutdown:
| Tru64 |
for all modes except 'expect' followed by:
|
|---|---|
| OpenVMS | Depending on the method selected (described in more detail below), one of the following commands is executed: Either
or the script detailed below if 'expect' is not used. |
Requirements
Powershell V5.1 or newer version is required.
To run PowerShell scripts (files that end with .ps1), you must first set the execution policy to Unrestricted (This operation has to be done once).
To do so, open a command line window (cmd.exe) as an Administrator and use the following command:
c:\Charon>powershell -command "Set-ExecutionPolicy Unrestricted" |
The ExecutionPolicy can also be set to "RemoteSigned". In this case the .ps1 script files will have to be unblocked as described below.
If you are still prompted to allow for execution of the script, please run the following command to unblock the downloaded charon_cleanshutdown.ps1 file:
c:\Charon>powershell -command "Unblock-File -path c:\charon\ |
See Powershell version, upgrade, enabling scripts execution, tips and tricks.
Available methods
Four methods are available to perform the remote shutdown. For all methods except 'expect', the CHARON host must be able to communicate via TCP/IP with the guest operating system(s) running on the CHARON instance(s).
Please select the method that is best suited to your configuration:
| Mode | Description | Requirements | Notes | |
|---|---|---|---|---|
| expect | Simulates an interactive connection to the console of the CHARON instance and performs the necessary actions. | Restrictions 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.
|
| |
| 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). |
| |
| 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 |
|
Case sensitive: 'If the CHARON instance is running OpenVMS and the mode is not 'expect', the CHARON_SHUTDOWN.COM script is required, see below.
OpenVMS shutdown script
Copy/paste this script on your OpenVMS system, it will be used to issue the shutdown command for "rsh" and "ssh" modes:
$ IF F$MODE() .eqs. "OTHER"
$ THEN
$ DEFINE SYS$OUTPUT OPA0:
$ @SYS$SYSTEM:SHUTDOWN 0 SHUTDOWN NO YES LATER NO NONE
$
$ ELSE
$ IF "''P1'".EQS."CHECK"
$ THEN
$ WRITE SYS$OUTPUT "''P2' was successful"
$ ELSE
$ SET VERIFY
$ PURGE /KEEP=20 SYS$MANAGER:CHARON_SHUTDOWN.LOG
$ RUN /DETACH SYS$SYSTEM:LOGINOUT.EXE /INPUT=SYS$MANAGER:CHARON_SHUTDOWN -
/OUTPUT=SYS$MANAGER:CHARON_SHUTDOWN.LOG /UIC=[1,4]
$ ENDIF
$ ENDIF
$ EXIT
|