UNDER CONSTRUCTION

TO DO:

update log output in other modes and here too
specify parameters and values are case sensitive (in all other modes too)
add a "clixmlsys" parameter as for "identityfile" and "identityfsys" so that this file will be used with "system" (service) account

Required parameters

Parameter Value Example

logfile Full path to the logfile that will be used to log the script output logfile=C:\Charon\myds20_shutdown.log

mode 'opa0' mode=opa0

os Either Tru64 or VMS os=Tru64

servicename

CHARON instance service name.

When using expect, the service is stopped by the expect script either with a "power off" or the "F6" key.

If this operation does not succeed (cannot connect to console or "F6" key not enabled for example), it is then stopped using a Windows service command.

servicename=myds20

username

Defines the remote username that will be used to connect to the console of the CHARON instance (if not already logged in)

For OpenVMS: username=system

For Tru64: username=root

password

Defines the password in clear text that will be used to connect to the console.

The password can be also stored in an encrypted clixml file as described below.

If password is sent then clixml (below) value must be set to "none"

password=12345

clixml

Defines the full path of the clixml file that contains the encrypted password (password parameter must then not be set).

To create this file, open a "cmd.exe " window and then run :

C:\Users\Administrator> cd C:\Charon

C:\Charon> powershell

PS C:\Charon> "<password>" | export-clixml <file>

Example:

PS C:\Charon> "12345" | export-clixml C:\Charon\myds20pwd.clixml

clixml=C:\Charon\myds20pwd.clixml

clixmlsys

Defines the full path of the clixml file that contains the encrypted password (password parameter must then not be set) for the "system" account. Used in case of integration with Windows shutdown.

If not specified, clixml is used or the combination of username/password (see above)

clixml=C:\Charon\myds20pwdsys.clixml

port Defines the port to access the console (same as the one defined in the configuration file). port=10003

prompt

Defines the prompt at the shell level of the guest operating system. Used by 'expect' to check that the connection did succeed.

prompt=myds20>

timelimitsec Defines the maximum number of seconds the script can run (default = 180 seconds). This value depends on the time needed to shutdown properly the operating system timelimitsec=600

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

Example

Configuration file

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

# myds20 Tru64 V5.1 machine

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

logfile=C:\Charon\myds20_shutdown.log

servicename=myds20

mode=opa0

os=Tru64

username=root

clixml=C:\Charon\myds20pwd.clixml

port=10003

prompt=#

timelimitsec=180

Script execution

Check mode

When check mode is enabled, a pop-up window will be displayed to check the expect operations performed on the CHARON instance console.

c:\Charon>powershell -file charon_cleanshutdown.ps1 -config myds20tru64.ini -check

-->To update

Shutdown execution

c:\Charon>powershell -file charon_cleanshutdown.ps1 -config myds20tru64.ini