| Anchor | ||||
|---|---|---|---|---|
|
| Include Page | ||||
|---|---|---|---|---|
|
...
CHARON execution is controlled by the "CHARON Virtual Machines Machine Manager" that manages each CHARON instance, called a "CHARON Virtual Machine", running on the host.
The CHARON installation procedure creates a shortcut on the desktop and under the Windows Start menu for the CHARON Virtual Machines Machine Manager.
Desktop shortcut:
"Start" menu shortcut:
The CHARON Virtual Machines Machine Manager runs automatically at Windows startup. If it is minimized to tray, it can be re-opened in the following way:
...
After clicking the shortcuts, the main dialog of CHARON Virtual Machines Machine Manager appears.
| Include Page | ||||
|---|---|---|---|---|
|
...
CHARON installation contains a set of template files for creating a base configuration for each VAX/PDP11 model. Once the CHARON Virtual Machine (VM) is created using these templates it can be configured further to meet your requirements and all the specifics of the emulated system.
...
The CHARON templates do not contain any
...
specifications for disks and network; you
...
must update the configuration file created from the template to specify your
...
disk and network configuration.
Start the CHARON Virtual Machines Machine Manager (see above) and press the "Create VM from Template" button:
In the appearing dialog that appears select the VAX/PDP11 hardware model:
...
Note the Home Directory for the VM (see screenshot below), it will be used by default for storing logs, virtual disk images, toy and container files if no path is specified in the configuration file.
Specify Enter a name for the VM and press the "Create" button:
The CHARON Virtual Machines Machine Manager will report the VM has been created successfully:
...
It is also possible to use an existing configuration file for creating a CHARON Virtual Machine.
Open the CHARON Virtual Machines Machine Manager (see above) and press the "Add Existing VM" button:
In the appearing dialog that appears select the target configuration file to import by pressing the "Browse" button:
...
Select the configuration file and press the "Open" button:
...
Never select a configuration file template provided in the Charon installation folder for editing as these files could be overwritten with patching
...
Enter the CHARON Virtual Machine name and note the Home Directory for this VM, it will be used by default for storing logs, virtual disk images, toy and container files if no path is specified in the configuration file.
Press the "Create" button:
The CHARON Virtual Machines Machine Manager will report that the VM has been created successfully:
...
Select the target CHARON VM in the left pane and press the "Start" button:
CHARON Virtual Machines Machine Manager will display the execution log:
Note the color meaning:
| Colors | Meaning | Example |
|---|---|---|
Red | Error |
| color | #FF2020 |
|---|
This is an error message | |
| Light blue | Warning |
| color | #E6FFFF |
|---|
This is a warning message | |
Light yellow | Information |
| color | #FFFFE7 |
|---|
This is an informational message | |
Purple | Begin/End of the Windows system log |
| color | #7F7EFD |
|---|
Begin / End |
The console of this particular CHARON VM will then appear (if defined in the configuration file):
...
Check the desired options and press the "Allow access" button.
...
If you closed the CHARON VM console, it is always possible to re-open it by pressing the "Show Console" button:
...
Closing the console will not stop the CHARON Virtual Machine.
| Include Page | ||||
|---|---|---|---|---|
|
...
Note: before stopping the virtual machine from the CHARON Virtual Machines Machine Manager, a clean shutdown of the operating system running on the VM has to be performed.
Select the target CHARON VM in the left pane and press the "Stop" button. A dialog will appear to confirm, select "Yes" to continue to stop the VM:
| Include Page | ||||
|---|---|---|---|---|
|
...
To remove a CHARON VM, select it and press the "Remove VM" button:
The Virtual machine has to must be stopped before removing it (see Stopping a CHARON Virtual Machine chapter see 73605069537476 chapter above)
A confirmation dialog will be displayed:
...
Select the target CHARON VM and switch to the "VM Configuration" tab to see its features:
Using this dialog it is possible to:
...
The MkDisk utility will be called for this operation:
Refer to the "Utilities" section of this User's Guide for more information about the MkDisk utility.
...
Press the "Edit Configuration file" button:
Alternatively it is possible to select the target CHARON VM and press the "Edit Configuration" button:
The configuration file specifies all the settings of the CHARON VM. This will be discussed in the next chapter.
...
By default, the CHARON VM startup mode is set to "Manual" meaning a user has to start the CHARON VM manually using the CHARON Virtual Machines Machine Manager after a host reboot. If the CHARON VM has to start automatically, select the "Automatic" option.
...
If a patch has been applied to a specific version, only the patched version will appear, not the vanilla oneis offered. If you need to rollback to a vanilla the previous version, please you msut uninstall the patch according to the documentation provided with the patch.
Select the target desired CHARON version from the "Executable" drop-down list and press the "Apply" button:
| Include Page | ||||
|---|---|---|---|---|
|
...
| Function | Description |
|---|---|
| Update Log | The CHARON Virtual Machines Machine Manager updates the displayed log every 5 minutes and displays up to 1024 lines by default. It can be changed in the "Settings" dialog of the program system menu. Right click on top of the CHARON Virtual Machines Machine Manager window and select "Settings":
In the appearing dialog you can change the interval:
If it is required to see most up-to-date version of the log, press the "Update Log" button.
|
| Display Log | Available from the VM control tab, bottom right. Creates a separate window containing the selected CHARON VM log |
| Show Console | Available from the VM control tab, bottom right, and if the VM is running. Opens the selected CHARON VM console if it has been closed |
...
Select the "Host Information & Utilities" tab to get a quick access to the CHARON utilities:
These utilities are described below:
...