...
Depending on the guest operating system running on the CHARON instance, the following commands are executed to perform a clean shutdown:
| Tru64 | uname -a
for all modes except 'expect' followed by: /sbin/init 0
|
|---|
| OpenVMS | Depending on the method selected (described in more detail below), one of the following commands is executed: Either@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 NONEor the script detailed below if 'expect' is not used.
|
|---|
Requirements
Powershell V5.1 or newer version is required.
...
| 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 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 | - Not subject to password change.
- Secure connection.
|
...
.
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.
|
OpenVMS shutdown script
Copy/paste this script on your OpenVMS system, it will be used to issue the shutdown command for "rsh", "ssh" and "sshopa0" modes:
$ EDIT SYS$MANAGER:CHARON_SHUTDOWN.COM
| Code Block |
|---|
| $ 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 |
|
...