Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 55 Next »

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:

FileDescription
charon_cleanshutdown.ps1Powershell main script
charon_cleanshutdown_Windows.expExpect script, launched by the Powershell script if 'expect' is selected
rsh.exeUsed if 'rsh' mode is selected
template.iniUsed to facilitate the creation of a customized configuration file for the CHARON instance

Shutdown command

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:

init 0

OpenVMS

Depending on the method selected (described in more detail below), one of the following commands is executed:

Either

@SYS$SYSTEM:SHUTDOWN 0 SHUTDOWN NO YES LATER NO NONE

or the script detailed below if 'expect' is not used.

Requirements

Powershell V4.0 or newer is recommended. The execution of Powershell scripts must have been enabled.

(info) 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:

ModeDescriptionRequirementsNotes
telnet

Telnet to the guest operating system using credentials stored in an encrypted clixml file.

This mode requires the Windows telnet client to be installed. This can be done using the following command:

C:\Charon> pkgmgr /iu:"TelnetClient"
  • OpenVMS only, does not work with Tru64.
  • If the password of the guest operating system changes, the encrypted clixml file has to be updated.
expectSimulates an interactive connection to the console of the CHARON instance and performs the necessary actions.

Restrictions

Expect is supported only on Windows 2008 R2 and Windows 7. Windows 2012 R2 and 8.1 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

    (warning) 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.
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).
  • 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 this site: https://sourceforge.net/projects/opensshwindows/.

(info) The installation is menu driven, use the default options.

  • Not subject to password change.
  • Secure connection.

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 all modes except 'expect':

$ EDIT SYS$MANAGER:CHARON_SHUTDOWN.COM

$ IF F$MODE() .eqs. "OTHER"
$ THEN
$   DEFINE SYS$OUTPUT OPA0:
$   @SYS$SYSTEM:SHUTDOWN 0 SHUTDOWN NO YES LATER NO NONE
$
$ 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
$ EXIT


<Go to Top>

  • No labels