...

Running CHARON-VAX emulators

...

1. Copy the sample script "/opt/charon/bin/charon.service" ( "/opt/charon/bin/charon" for Red Hat  Linux 6.x) to the "/usr/lib/systemd/system/" directory (or to your home directory for Red Hat Enterprise Linux 6.x).

   Example:
   

   Red Hat Linux 6.x

   $ cp /opt/charon/bin/charon

   /my_services/mv3k6_service
   $ chmod 755 /my_services/mv3k6_serviceRed Hat Enterprise Linux/CentOS 7 & 8$ cp /opt/charon/bin/charon

   .service /usr/lib/systemd/system/mv3k6.service
$ chmod 755 /usr/lib/systemd/system/mv3k6.service

   
   

2. Edit the renamed file to replace sample values of the following parameters.

   Example:

   Red Hat Linux 6.x

   exec="/opt/charon/bin/mv3k6"
prog="my_mv3k6"
config="/my_services/mv3k6-service.cfg"

   Red Hat Enterprise Linux/CentOS 7 & 8

   
   ExecStart=/opt/charon/bin/mv3k6 -d /my_services/mv3k6-service.cfg
WorkingDirectory=/my_services

     "my_mv3k6" is a service name in the example above            
3. Create and edit the configuration file ("/my_services/mv3k6-service.cfg" in the examples above) the way it was described before and make sure the following pre-requisites are met:

   • OPA0 must be configured as a virtual port or physical console, not as an operator console.

     Example:

     load virtual_serial_line OPA0 port=10003 #load operator_console OPA0

     
     

   • Use only absolute paths to log, toy clock, nvram files and all the other data such as disk images, etc. The names of the references files must be unique.

     Example:

     ... set session log="/my_services/my_mv3k6.log" set toy container="/my_services/my_mv3k6.dat" load RQDX3/RQDX3 DUA set DUA container[0]="/my_services/mv3k6_daemon_boot_disk.vdisk" ...

     
     

   • Make sure the same physical devices are not used by other CHARON-VAX daemons and the OPA0 console port number is unique across the CHARON server.
     
     

...

Once configuration file is ready, execute the following commands (based on the examples above) to install and start CHARON-VAX as a daemon:

...

# ln -sf /my_services/mv3k6_service /etc/init.d/mv3k6_service
# chkconfig mv3k6_service on
# service mv3k6_service start

...

# systemctl enable mv3k6.service
# systemctl start mv3k6.service

...

To stop a CHARON-VAX daemon, use the following commands.

Example:

...

#

...

systemctl stop mv3k6

Please note that before stopping a CHARONCharon-VAX service, a clean shutdown of the operating system running on the virtual machine emulator has to be performed. Stopping the emulator when the guest is still running should be the last resort when all attempts to stop the guest have failed.

Removing

...

Charon-VAX service

To remove a CHARONCharon-VAX daemon use the following commands.

Example:

...

#

...

systemctl disable mv3k6.service
# rm -f /usr/lib/systemd/system/mv3k6.service

...

 Please note that before removing a CHARONCharon-VAX service, a clean shutdown of the operating system running on the virtual machine has to be performed and the service has to be stopped.

Please refer to the next chapters for more details concerning CHARONCharon-VAX configuration details

...