Versions Compared

Old Version 20

changes.mady.by.user Bruno Miretti

Saved on

compared with

New Version Current

changes.mady.by.user Bruno Miretti

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: .vtape part updated

...

Specify this image in the CHARON configuration file, boot from the system disk and mount the disk with the following OpenVMS command:

$ MOUNT <device name> /OVERRIDE=IDENTIFICATION


Issue the following commands to install the package (example given for OpenVMS V8.4):

$ @SYS$UPDATE:VMSINSTAL

...

* Are you satisfied with the backup of your system disk [YES]? YES
* Where will the distribution volumes be mounted: <device name>:[CHARONCP013.KIT]

Enter the products to be processed from the first distribution volume set.
* Products: CHARONCP013

* Enter installation options you wish to use (none): <press enter>

...

Do you want to install this product [NO]? YES

...

* Where should the CHARONCP root directory be located ? [SYS$SYSDEVICE:[CHARONCP]]: <press enter>

...

* Do you want to purge files replaced by this installation [YES]? <press enter>


Div
classpagebreak


Select all the components included to the package:

                           Component Selection

Select the CHARONCP components you wish to install from the menu below.
An asterisk appears next to the packages that have already been
selected. You can remove a package from the list by selecting it
again. You may enter more than one selection by separating your
choices with commas.

1. [*] CHARONCP Guest Utility (REQUIRED)
2. [*] Compatability Utilities
3. [*] Install DCL Commands & Help

4. Exit

* Your choice [4]: 1,2,3

...

* Your choice [4]: 4

...

* Is this correct [YES]: <press enter>

...

* Products: <press enter>

        VMSINSTAL procedure done at hh:mn

$

Proceed with installation using all the default options.

Once the installation is completed, add the following line to the "SYS$STARTUP:SYSTARTUP_VMS.COM" ("SYS$STARTUP:SYSTARTUP_V5.COM" for VMS 5.5) file for the package to be loaded automatically at system startup:

$ @SYS$STARTUP:CHARONCP_STARTUP
$ CHARONCP SET IDLE /ENABLE

After that the package will be loaded automatically on startup.

Performance optimization

CHARON takes 100% of host CPU even in case of idle state of guest OpenVMS operating system. To get rid of such resources consumption there is a specific option provided by CHARON Guest Utilities - "idle" mode.

To load the OpenVMS idle loop detection software, use:

$ CHARONCP SET IDLE /ENABLE

This allows CHARON to detect when the emulated CPU(s) are idle and use the host power saving instructions to reduce power usage.

To unload the OpenVMS idle loop detection software, use:

$ CHARONCP SET IDLE /DISABLE


...

Warning
  • It is mandatory to set the "removable" parameter to "true"
  • The container name must either be ".vtape" (and nothing else) or a valid file name (Example: "/charon/tapes/mytape.vtape") with an existing folderThe container name length must not be more than 255 characters, no name and path must be specified, only extension.


Example:

set PKA container[600] = ".vtape" removable[600] = true

...

$ CHARONCP SET MAGTAPE <device> /LOAD="<filename>.vtape"

(warning) The container name specified in the /LOAD parameter must not be more than 255 characters

Example:

$ CHARONCP SET MAGTAPE MKA600: /LOAD="/charon/tapes/backup_01.vtape"

To detach any file currently attached to te specified virtual tape device, use:

...

$ CHARONCP SET MAGTAPE MKA600: /UNLOAD


Possible errorsDescription
BADFILENAME

The filename specified as a value to the qualifier /LOAD was either too long or does not have a file extension of ".vtape".

DEVNOTDISM

Attempting to execute a SET MAGTAPE/LOAD when a file is already attached.

Perform a SET MAGTAPE/UNLOAD first. If a SET MAGTAPE/LOAD command has not previously been executed, then the CHARON configuration container specification for the tape device may contain a full path. Doing this will create and attach and initial tape container file. To avoid this, remove the file name from the specification (leaving only a file extension of ".vtape" and optional directory).

...