...
$ mtd [options] <tape device name> <tape container name> |
Parameters:
MTD - CHARON Magnetic Tape Dump & Restore utility, Version 2.3 (Build 18302)
Copyright (C) 2009-2016 STROMASYS SA. All rights reserved.
Usage: mtd [options] <tape-drive-name> <file-name> - dump tape content to file
mtd <file-name> <tape-drive-name> - restore dump to tape
mtd <file-name> <file-name> - convert formats
mtd <file-name> - examine tape dump and check integrity
<tape-drive-name> - tape drive
<file-name> - name of tape container file (.mtd or .vtape)
Options:
-l <file-name> - log file name (.log)
-n - do not rewind tape
-r <number> - number of attempts to retry failing tape reads
-i - ignore failing tape reads (implies -r 0)
-p - disable progress reporting
-v - enable verbose trace of data transfer (implies -p)
-s - output tape image in SMA format
-g - gather statistics and print upon completion
|
Example:
...
Login as root and enter "ncu". The following menu will appear:
# ncu
CHARON Network Configuration Utility, STROMASYS (c) 2016 Version 1.6
Interfaces Dedicated to State
---------- ------------ ------------
eth0 host connected to host
eth1 host connected from host
lo host unmanaged from host
=================================================================
bridge name bridge id STP enabled interfaces
========================== VLAN =================================
================================================================= select action:
1 - Dedicate to CHARON
2 - Release to host
3 - Create Bridge with TAPs
4 - Remove Bridge
5 - Add VLAN
6 - Remove VLAN
7 - Print status
8 - Exit :> 8
|
The utility lists available network interfaces (both physical and virtual) and indicates whether they are dedicated to the host or to CHARON and whether they are currently in use by host operating system.
...
Enter "1", then type "eth1" and press Enter:
Specify the interface to dedicate to CHARON:eth1
Turning off offloading for eth1.. Please wait
select action:
1 - Dedicate to CHARON
2 - Release to host
3 - Create Bridge with TAPs
4 - Remove Bridge
5 - Add VLAN
6 - Remove VLAN
7 - Print status
8 - Exit :> 7
|
Now the interface "eth1" is dedicated to CHARON-AXP:
Interfaces Dedicated to State
---------- ------------ ------------
eth0 host connected to host
eth1 CHARON disconnected from host
lo host unmanaged from host
=================================================================
bridge name bridge id STP enabled interfaces
========================== VLAN =================================
================================================================= select action:
1 - Dedicate to CHARON
2 - Release to host
3 - Create Bridge with TAPs
4 - Remove Bridge
5 - Add VLAN
6 - Remove VLAN
7 - Print status
8 - Exit |
Enter "8" to return to console prompt.
...
Login as root and enter "ncu". The following menu will appear:
# ncu
CHARON Network Configuration Utility, STROMASYS (c) 2016 Version 1.6
Interfaces Dedicated to State
---------- ------------ ------------
eth0 host connected to host
eth1 CHARON disconnected from host
lo host unmanaged from host
=================================================================
bridge name bridge id STP enabled interfaces
========================== VLAN =================================
================================================================= select action:
1 - Dedicate to CHARON
2 - Release to host
3 - Create Bridge with TAPs
4 - Remove Bridge
5 - Add VLAN
6 - Remove VLAN
7 - Print status
8 - Exit :> 2
|
Let's say that we want to return the interface "eth1" (currently dedicated to CHARON) back to host. To do that enter "2" then "eth1":
Specify the interface to release to HOST:eth1
Connection successfully activated (D-Bus active path: /org/freedesktop/NetworkManager/ActiveConnection/3)
select action:
1 - Dedicate to CHARON
2 - Release to host
3 - Create Bridge with TAPs
4 - Remove Bridge
5 - Add VLAN
6 - Remove VLAN
7 - Print status
8 - Exit :> 8
|
Enter "8" to quit the "ncu" utility.
...
Login as root and enter "ncu":
# ncu
CHARON Network Configuration Utility, STROMASYS (c) 2016 Version 1.6
Interfaces Dedicated to State
---------- ------------ ------------
eth0 host connected to host
eth1 host connected to host
lo host unmanaged from host
=================================================================
bridge name bridge id STP enabled interfaces
========================== VLAN =================================
================================================================= select action:
1 - Dedicate to CHARON
2 - Release to host
3 - Create Bridge with TAPs
4 - Remove Bridge
5 - Add VLAN
6 - Remove VLAN
7 - Print status
8 - Exit :> 3
|
Enter "3" to create a bridge between the host physical network adapter and the LINUX virtual network interfaces (TAP) and specify the physical network interface ("eth1" in our example) and the number of virtual network interfaces to be created (2 in our example):
Specify the interface to be used for BRIDGE:eth1
How many tap should be created:2
Forming the bridge: ..1..2..3..4..5.. addif tap0 .. addif tap1 ..7..8 done!
Formed bridge br0_eth1 attached over eth1...
select action:
1 - Dedicate to CHARON
2 - Release to host
3 - Create Bridge with TAPs
4 - Remove Bridge
5 - Add VLAN
6 - Remove VLAN
7 - Print status
8 - Exit
:> 7
|
Now enter "7" to see the created virtual interfaces:
Interfaces Dedicated to State
---------- ------------ ------------
eth0 host connected to host
eth1 bridge connected to bridge
lo host unmanaged from host
tap0 CHARON connected to host
tap1 bridge connected to bridge
=================================================================
bridge name bridge id STP enabled interfaces
br0_eth1 8000.768e1ea091d9 no eth1
tap0
tap1
========================== VLAN =================================
================================================================= select action:
1 - Dedicate to CHARON
2 - Release to host
3 - Create Bridge with TAPs
4 - Remove Bridge
5 - Add VLAN
6 - Remove VLAN
7 - Print status
8 - Exit :> 8
|
In the example above we see 2 virtual network Interfaces "tap0" and "tap1" connected to the created bridge. The physical network interface "eth1" is used for the bridge to the virtual network interfaces.
...
Login a root. Start "ncu" utility:
# ncu
CHARON Network Configuration Utility, STROMASYS (c) 2016 Version 1.6
Interfaces Dedicated to State
---------- ------------ ------------
eth0 host connected to host
eth1 bridge connected to bridge
lo host unmanaged from host
tap0 CHARON connected to host
tap1 bridge connected to bridge
=================================================================
bridge name bridge id STP enabled interfaces
br0_eth1 8000.768e1ea091d9 no eth1
tap0
tap1
========================== VLAN =================================
================================================================= select action:
1 - Dedicate to CHARON
2 - Release to host
3 - Create Bridge with TAPs
4 - Remove Bridge
5 - Add VLAN
6 - Remove VLAN
7 - Print status
8 - Exit :> 4
|
Enter "4" then enter the interface name that is a bridge to the Linux virtual network on this host ("eth1" in our example):
Specify the phys interface used for BRIDGE:eth1
Cleanup bridge br0_eth1 with ip over eth1...
Removing the bridge: ..1..2 delif eth1
delif tap0
delif tap1
..5..6..7..8 done!
select action:
1 - Dedicate to CHARON
2 - Release to host
3 - Create Bridge with TAPs
4 - Remove Bridge
5 - Add VLAN
6 - Remove VLAN
7 - Print status
8 - Exit :> 8
|
Enter "8" to quit "ncu" utility.
...
Login a root. Start "ncu" utility:
# ncu
CHARON Network Configuration Utility, STROMASYS (c) 2016 Version 1.6
Interfaces Dedicated to State
---------- ------------ ------------
eth0 host connected to host
eth1 host connected to host
lo host unmanaged from host
=================================================================
bridge name bridge id STP enabled interfaces
========================== VLAN =================================
================================================================= select action:
1 - Dedicate to CHARON
2 - Release to host
3 - Create Bridge with TAPs
4 - Remove Bridge
5 - Add VLAN
6 - Remove VLAN
7 - Print status
8 - Exit :> 5
|
Enter "5" then enter:
- The phisical interface name to be used for creating VLAN
- The ID of the VLAN device
- IP address of the VLAN device. Skip this step if no IP is required
- Network mask of the VLAN device. Enter for no network mask.
Specify the phys interface used for VLAN:eth1
Specify the id of VLAN device (<4095):111
Specify the ip address of VLAN device or empty string for no ip address: 192.168.1.100
Specify the netmask address of VLAN device or empty string for no netmask: 225.225.225.0 select action:
1 - Dedicate to CHARON
2 - Release to host
3 - Create Bridge with TAPs
4 - Remove Bridge
5 - Add VLAN
6 - Remove VLAN
7 - Print status
8 - Exit :> 8
|
Enter "8" to quit "ncu" utility.
...
Login a root. Start "ncu" utility:
# ncu
CHARON Network Configuration Utility, STROMASYS (c) 2016 Version 1.6
Interfaces Dedicated to State
---------- ------------ ------------
eth0 host connected to host
eth1 host connected to host
lo host unmanaged from host
=================================================================
bridge name bridge id STP enabled interfaces ========================== VLAN =================================
eth1.111
================================================================= select action:
1 - Dedicate to CHARON
2 - Release to host
3 - Create Bridge with TAPs
4 - Remove Bridge
5 - Add VLAN
6 - Remove VLAN
7 - Print status
8 - Exit :> 6
|
Enter "6" then enter the VLAN interface for remove:
Specify the VLAN interface, which be removed: eth1.111
Removed VLAN -:eth1.111:-select action:
1 - Dedicate to CHARON
2 - Release to host
3 - Create Bridge with TAPs
4 - Remove Bridge
5 - Add VLAN
6 - Remove VLAN
7 - Print status
8 - Exit :> 8
|
Enter "8" to quit "ncu" utility.
Back to Table of Contents
CHARON Guest Utilities for OpenVMS
The "CHARON Guest Utilities for OpenVMS" (CHARONCP) package contains several utilities for managing virtual tapes, changing the emulator speed and creating useful definitions for that operations.
...
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:
$ @SYS$UPDATE:VMSINSTAL
* Are you satisfied with the backup of your system disk [YES]? YES
* Where will the distribution volumes be mounted: <device name>:[000000.CHARONCP011.KIT]
Enter the products to be processed from the first distribution volume set.
* Products: CHARONCP011
|
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]: 4
|
Proceed with installation using all the default options.
Once the installation is completed, update "SYSTARTUP_VMS.COM" file with the following line:
$ @SYS$STARTUP:CHARONCP_STARTUP |
After that the package will be loaded automatically on startup.
Back to Table of Contents
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.
| Command | Description |
|---|
| $ CHARONCP SET IDLE /ENABLE | Loads the OpenVMS idle loop detection software. This allows CHARON to detect when the emulated CPU(s) are idle and use the host power saving instructions to reduce power usage. |
| $ CHARONCP SET IDLE /DISABLE | Unloads the OpenVMS idle loop detection software. |
Back to Table of Contents
...
CHARON speed can be adjusted using these commands:
| Command | Description |
|---|
| $ CHARONCP SET SPEED /UP=<number of steps> | Increase the emulator speed by the specified number of steps. |
| $ CHARONCP SET SPEED /DOWN=<number of steps> | Decrease the emulator speed by the specified number of steps. |
| $ CHARONCP SET SPEED /RESET | Remove all speed stepping restraints. |
Back to Table of Contents
...
It is possible to schedule CHARON to shutdown directly from OpenVMS:
| Command | Description |
|---|
| $ CHARONCP SET SHUTDOWN /IN=<seconds, 60 is default> | The number of seconds before the CHARON emulator is to shut down. The value can be between 0 and 65535 (approx. 18 hours). |
| $ CHARONCP SET SHUTDOWN /RESET | Clear a scheduled shutdown. |
Back to Table of Contents
...
Specify mapping to tape container in the following way in the CHARON configuration file:
set <adapter name> container[<unit name>] = ".vtape" removable[<unit name>] = true |
Example:
set PKA container[600] = ".vtape" removable[600] = true |
Once it is done using the following commands it is possible to manage virtual tapes attached to CHARON:
| Command | Description |
|---|
| $ CHARONCP SET MAGTAPE <device> /LOAD="<filename>.vtape" | Create the specified host-file (if it does not already exist) and attach it to the specified virtual tape device. Example: $ CHARONCP SET MAGTAPE MKA600: /LOAD="backup_01.vtape" |
|
| $ CHARONCP SET MAGTAPE <device> /UNLOAD | Detach any file currently attached to te specified virtual tape device. Example: $ CHARONCP SET MAGTAPE MKA600: /UNLOAD |
|
Possible errors:
| Error | Description |
|---|
| 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 fileextension of ".vtape" and optional directory). |
If some tape container has been already specified in the CHARON configuratioon file use the command "CHARONCP SET MAGTAPE <device> /UNLOAD" to unload it first.
...
It is possible to define certain keys on the terminal keyboard for fast access to the CHARONCP functionalilty while you are in CHARONCP:
| Command | Description |
|---|
$ CHARONCP
CHARONCP> DEFINE /KEY <key-name> <equivalence-string> | Defines an equivalence string and a set of attributes with a key on the terminal keyboard. You can have a set of keys defined automatically for use with the CHARONCP utility by placing DEFINE/KEY commands in the file SYS$LOGIN:CHARONCP_KEYDEFS.INI Example: $CHARONCP
CHARONCP> DEFINE /KEY F1 "SET MAGTAPE MKA600: /UNLOAD" |
|
$ CHARONCP
CHARONCP> SHOW KEY <key-name> | Displays key definitions created with the DEFINE/KEY command. Refer to the DCL help entry for SHOW KEY for further information. Example: $CHARONCP
CHARONCP> SHOW KEY F1
DEFAULT key state definitions:
F1 = "set magtape mka600: /unload"
CHARONCP> |
|
For more information refer to the OpenVMS DCL Dictionary (DEFINE/KEY section).
...
Back to Table of Contents
Displaying version
| Command | Description |
|---|
| $ CHARONCP SHOW VERSION | Displays the CHARONCP package version number and architecture. This can be useful for customers reporting issues with the CHARONCP software. Example: $ CHARONCP SHOW VERSION
CHARONCP version id is: V1.1
|
|
Back to Table of Contents
...