Required parameters

Parameter	Value	Example
`logfile`	Full path to the logfile that will be used to log the script output.	`logfile=C:\Charon\myds20vms_shutdown.log`
`waitbeforestop`	Number of seconds to wait before stopping the service once the guest operating system no longer responds to 'ping'. If not set, default value = 60.	`waitbeforestop=10`
`servicename`	CHARON instance service name	`servicename=myds20vms`
`guestsystem`	Server name or IP address	`guestsystem=10.0.0.3`
`os`	VMS or Tru64	`os=VMS`
`mode`	'rsh'	`mode=rsh`
`rshbin`	Defines the location of the "rsh.exe" program.	`rshbin=C:\bin\rsh.exe`
`username`	Defines the remote username that will be used to connect to the guest operating system via rsh.	`username=system`
`openconsolecmd`	Optional parameter used to open the console program while executing the script. It is recommended to define this parameter in case of integration with Windows shutdown	`openconsolecmd=C:\Program Files\CHARON\Build_20203\x64\putty`
`openconsolearg`	Optional parameter defining the parameters of the `openconsolecmd` parameter above.	`openconsolearg=-load OPA0 -P 10003`
`windowwidth`	Optional parameters used to resize the window when running with service user ("system" account). Useful during Windows shutdown to check operations executed. Width = 132 and Height = 32 by default. BufferHeight set 2000 lines by default.	`windowwidth=120`
`windowheight`		`windowheight=50`

Enabling remote connection on Tru64

To allow connections from the Windows server to the Tru64 guest system without having to specify a password, the Tru64 local account's .rhosts file has to be updated with the name or IP address of the Windows system and the account used.

The .rhosts file contains a list of remote users who are not required to supply a login password when they use the local user account and execute the rcp, rlogin, and rsh commands (see "# man rhosts" for more).

In the example below, a proxy will be created between the Windows 'administrator' account (the IP address of the Windows system is 10.0.0.1) and the Tru64 'root' account (the IP address of the Tru64 system is 10.0.0.2).

# vi $HOME/.rhosts

10.0.0.1 Administrator

Enabling remote connection on OpenVMS

Enable the REXEC and RSH service on OpenVMS by executing the TCPIP$CONFIG script (depending on the OpenVMS version, the script could also be called UCX$CONFIG):

VMS084> @sys$manager:tcpip$config

Checking TCP/IP Services for OpenVMS configuration database files.

HP TCP/IP Services for OpenVMS Configuration Menu

Configuration options:

1 - Core environment

2 - Client components

3 - Server components

4 - Optional components

5 - Shutdown HP TCP/IP Services for OpenVMS

6 - Startup HP TCP/IP Services for OpenVMS

7 - Run tests

A - Configure options 1 - 4

[E] - Exit configuration procedure

Enter configuration option: 2

HP TCP/IP Services for OpenVMS Client Components Configuration Menu

Configuration options:

1 - DHCP Client Disabled Stopped

2 - FTP Client Disabled Stopped

3 - NFS Client Disabled Stopped

4 - REXEC and RSH Disabled Stopped

5 - RLOGIN Disabled Stopped

6 - SMTP Disabled Stopped

7 - SSH Client Disabled Stopped

8 - TELNET Enabled Started

9 - TELNETSYM Disabled Stopped

A - Configure options 1 - 9

[E] - Exit menu

Enter configuration option: 4

RSH Configuration

Service is defined in the SYSUAF.

Service is defined in the TCPIP$SERVICE database.

Service is not enabled.

Service is stopped.

RSH configuration options:

1 - Enable service on this node

2 - Enable & Start service on this node

[E] - Exit RSH configuration

Enter configuration option: 2

%TCPIP-I-INFO, image SYS$SYSTEM:TCPIP$RSH.EXE installed

%TCPIP-I-INFO, image SYS$SYSTEM:TCPIP$RCP.EXE installed

%TCPIP-I-INFO, logical names created

%%%%%%%%%%% OPCOM 8-JUL-2016 01:28:23.22 %%%%%%%%%%%

Message from user INTERnet on VMS084

INTERnet ACP Activate RSH Server

%TCPIP-I-INFO, service enabled

%TCPIP-S-STARTDONE, TCPIP$RSH startup completed

Press <ENTER> key to continue ...

REXEC Configuration

Service is not defined in the SYSUAF.

Service is not defined in the TCPIP$SERVICE database.

Service is not enabled.

Service is stopped.

REXEC configuration options:

1 - Enable service on this node

2 - Enable & Start service on this node

[E] - Exit REXEC configuration

Enter configuration option: 2

...

HP TCP/IP Services for OpenVMS Client Components Configuration Menu

Configuration options:

1 - DHCP Client Disabled Stopped

2 - FTP Client Disabled Stopped

3 - NFS Client Disabled Stopped

4 - REXEC and RSH Enabled Started

5 - RLOGIN Disabled Stopped

6 - SMTP Disabled Stopped

7 - SSH Client Disabled Stopped

8 - TELNET Enabled Started

9 - TELNETSYM Disabled Stopped

A - Configure options 1 - 9

[E] - Exit menu

Enter configuration option: E

Check that the service is enabled:

VMS084> tcpip show service

Service Port Proto Process Address State

RSH 514 TCP TCPIP$RSH 0.0.0.0 Enabled

SSH 22 TCP TCPIP$SSH 0.0.0.0 Enabled

TELNET 23 TCP not defined 0.0.0.0 Enabled

To allow connection from the Windows server to the OpenVMS guest system without specifying a password, a proxy must be created between the Windows user that will execute the 'rsh' command and the OpenVMS user account:

In the example below, a proxy will be created between the Windows 'administrator' account (the IP address of the Windows system is 10.0.0.1) and the OpenVMS 'system' account (the IP address of the OpenVMS system is 10.0.0.3)

VMS084> tcpip

TCPIP> add proxy system /remote=administrator /host=10.0.0.1

TCPIP> show proxy

VMS User_name Type User_ID Group_ID Host_name

SYSTEM CD ADMINISTRATOR 10.0.0.1

Example

Configuration file

#-----------------------------------------

# myds20 OpenVMS 8.4 machine

#-----------------------------------------

windowwidth=132

windowheight=50

logfile=C:\Charon\myds20vms_shutdown.log

servicename=ds20vms

os=VMS

username=system

waitbeforestop=10

mode=rsh

guestsystem=10.0.0.3

rshbin=C:\bin\rsh.exe

Script execution

Check mode

c:\Windows\system32>C:\charon\charon_cleanshutdown.ps1 -config C:\charon\myds20vms.ini -check

Charon clean shutdown

Name              Value
----              -----
windowheight      50
openconsolecmd    C:\Program Files\CHARON\Build_20203\x64\putty
servicename       ds20vms
username          system
waitbeforestop    10
guestsystem       10.0.0.3
os                VMS
openconsolearg    -load OPA0 -P 10003
mode              rsh
windowwidth       132
rshbin            C:\bin\rsh.exe
logfile           C:\Charon\myds20vms_shutdown.log

17:26:44 [INFO ] Using 'C:\Charon\myds20vms_shutdown.log' as log file / append
17:26:44 [INFO ] Execution date : 27-avr.-2020 17:26:44
17:26:44 [INFO ] Script version : 27-Apr-20 V2.0 (MD5: 4BA97792A105C9E0E484850B88B866F8 )
17:26:44 [INFO ] Powershell version : 5.1.14409.1018
17:26:44 [INFO ] Computer name : WIN2008BM
17:26:44 [INFO ] Username : Administrateur
17:26:44 [INFO ] Windows version : Microsoft Windows Server 2008 R2 Standard
17:26:44 [INFO ] Administrator mode : True
17:26:44 [INFO ]
17:26:44 [INFO ] Check mode enabled.
17:26:44 [INFO ] 'rsh' will be used
17:26:44 [INFO ] Service 'ds20vms' is Running (Display name: ds20vms)
17:26:44 [INFO ] Testing guest system '10.0.0.3' response
17:26:47 [INFO ] Opening console.
17:26:47 [INFO ] Invoking 'rsh' command and executing check command...
17:26:47 [INFO ] C:\bin\rsh.exe -l system 10.0.0.3 '@SYS$MANAGER:CHARON_SHUTDOWN.COM CHECK RSH'
17:26:47 [INFO ] Output results:
17:26:47 [INFO ] RSH was successful
17:26:47 [INFO ]
17:26:47 [INFO ]
17:26:47 [INFO ] Command successfully completed.
17:26:47 [INFO ] Check mode enabled: no connection test to be performed.
17:26:47 [INFO ] Check mode enabled: no wait / stop service.
17:26:47 [INFO ] Check mode enabled: the service ds20vms will not be stopped
17:26:47 [INFO ] Service ds20vms is Running
17:26:47 [INFO ] Script ended.

Shutdown execution

c:\Windows\system32>C:\charon\charon_cleanshutdown.ps1 -config C:\charon\myds20vms.ini -check

Charon clean shutdown

Name              Value
----              -----
windowheight      50
openconsolecmd    C:\Program Files\CHARON\Build_20203\x64\putty
servicename       ds20vms
username          system
waitbeforestop    10
guestsystem       10.0.0.3
os                VMS
openconsolearg    -load OPA0 -P 10003
mode              rsh
windowwidth       132
rshbin            C:\bin\rsh.exe
logfile           C:\Charon\myds20vms_shutdown.log

17:29:13 [INFO ] Using 'C:\Charon\myds20vms_shutdown.log' as log file / append

17:29:13 [INFO ] Execution date : 27-avr.-2020 17:29:13

17:29:13 [INFO ] Script version : 27-Apr-20 V2.0 (MD5: 4BA97792A105C9E0E484850B88B866F8 )

17:29:13 [INFO ] Powershell version : 5.1.14409.1018

17:29:13 [INFO ] Computer name : WIN2008BM

17:29:13 [INFO ] Username : Administrateur

17:29:14 [INFO ] Windows version : Microsoft Windows Server 2008 R2 Standard

17:29:14 [INFO ] Administrator mode : True

17:29:14 [INFO ]

17:29:14 [INFO ] 'rsh' will be used

17:29:14 [INFO ] Service 'ds20vms' is Running (Display name: ds20vms)

17:29:14 [INFO ] Testing guest system '10.0.0.3' response

17:29:17 [INFO ] Opening console.

17:29:17 [INFO ] Invoking 'rsh' command and executing shutdown...

17:29:17 [INFO ] C:\bin\rsh.exe -l system 10.0.0.3 '@SYS$MANAGER:CHARON_SHUTDOWN.COM'

17:29:17 [INFO ] Output results:

17:29:17 [INFO ] $ PURGE /KEEP=20 SYS$MANAGER:CHARON_SHUTDOWN.LOG

17:29:17 [INFO ] $ RUN /DETACH SYS$SYSTEM:LOGINOUT.EXE /INPUT=SYS$MANAGER:CHARON_SHUTDOWN -

17:29:17 [INFO ] /OUTPUT=SYS$MANAGER:CHARON_SHUTDOWN.LOG /UIC=[1,4]

17:29:17 [INFO ] %RUN-S-PROC_ID, identification of created process is 00000122

17:29:17 [INFO ] $ ENDIF

17:29:17 [INFO ] $ EXIT

17:29:17 [INFO ] $

17:29:17 [INFO ] $ !

17:29:17 [INFO ] $ ! Force any output to the standard output socket.

17:29:17 [INFO ] $ ! Most useful when client is Un*x.

17:29:17 [INFO ] $ !

17:29:17 [INFO ] $ WRITE SYS$OUTPUT ""

17:29:17 [INFO ] $

17:29:17 [INFO ] $ IF (RSHD$ERROR .NES. RSHD$INPUT_OUTPUT)

17:29:17 [INFO ] $ ENDIF

17:29:17 [INFO ] $

17:29:17 [INFO ] $ ! SS_NORMAL, RSH was succcessful, command should send its error over net.

17:29:17 [INFO ] $ EXIT 1

17:29:18 [INFO ] Command successfully completed.

17:29:20 [INFO ] Testing connection to '10.0.0.3' = True

17:29:43 [INFO ] Testing connection to '10.0.0.3' = False

17:29:53 [INFO ] Sleeping for 10 seconds...

17:30:03 [INFO ] Stopping service ds20vms

17:30:04 [INFO ] Service ds20vms is Stopped

17:30:04 [INFO ] Script ended.

Using rsh

Contents

Required parameters

Enabling remote connection on Tru64

Enabling remote connection on OpenVMS

Example

Configuration file

Script execution

Check mode

Shutdown execution