Configuration File Reference
Contents
- 1 Overview
- 2 License Configuration
- 3 Machine State Parameters
- 4 System Model Configuration
- 5 Memory Configuration
- 6 I/O Slot Configuration
- 7 System Console and Serial Line Configuration
- 8 SCSI Controllers and Devices
- 9 Network Card Configuration
- 10 Logging configuration
- 11 SuperIO Configuration
- 11.1 General Information
- 12 Other Parameters
Overview
The hardware of the emulated system is defined in the emulator configuration file. Charon-PAR comes with a number of template files that are stored in /opt/charon/cfg. Each template file contains the settings for a particular Charon-PAR/PA3 or Charon-PAR/PA9 hardware model or model family. The files also contain important descriptions for all parameters listed.
The name of the Charon-PAR/PA3 template file is pa3.cfg. The names of the Charon-PAR/PA9-64 templates are rp*.cfg, for Charon-PAR/PA9-32 pa9-32.cfg.
Before starting an emulator instance,
copy the appropriate template file to the directory where you store the configuration data of your emulator instance, and
modify the template file according to your requirements.
Comments in the file are preceded by the # character.
Please note that some entries require an equal-sign (=) and for other parameters an equal-sign is not allowed. The emulator will not start if a required equal-sign is missing or an equal-sign is placed where it is not permitted.
If a parameter value is a string, it must be enclosed in double quotes.
The configuration file is structured in several sections that are described below
License Configuration
This section defines the license specific parameters.
Parameter license_key_id
Optional parameter. There can be several license_key_id parameters in this section. They define a prioritized list of license keys. The first entry has the highest priority. If no key with this ID is available, the next key in the list will be tried. If a higher priority key becomes available, the emulator will switch to this license at the next periodic license check.
Syntax:
license_key_id "key-id-prio1"
license_key_id "key-id-prio2"
(...)
Parameters:
The key-id-prioX parameter is a numerical value that can be determined using the hasp_srm_view -all command and identifying the value of the License KeyId parameter in the output. As long as the ID is a numerical value, the quotes are optional.
Parameter license_use_any_key
Optional parameter. This parameter is closely related to the license_key_id parameter. If the license_key_id parameter is used, it determines what happens if none of the defined license keys are available.
Syntax:
license_use_any_key false | true
Parameters:
Default value: false
If this parameter is set to true, the emulator will try to find any other suitable licenses should none of the licenses specified by the license_key_id parameter(s) be available. By default, if the license_key_id parameter is used, only the license keys specified there will be considered.
Parameter license_id
Optional parameter. There can be several license_id parameters in this section. They define a prioritized list of product license IDs. The first entry has the highest priority. If no key with this product license ID is available, the next product license ID in the list will be attempted. If a higher priority license becomes available, the emulator will switch to this license at the next periodic license check.
Syntax:
license_id "lic-id-prio1"
license_id "lic-id-prio2"
(...)
Parameters:
The lic-id-prioX parameter is a string value that must be enclosed in quotes. It can be determined using the hasp_srm_view -all command and identifying the value of the Product License Number parameter in the output. If none of the specified product licenses is available, the emulator will not start, or a running emulator will stop.
Problem Handler Parameters
The Charon-PAR configuration file supports the following parameters that can be used to alert the user to potential license problems:
Parameter | Description |
|---|---|
hasp_lost_usr_cmd | Runs a user-defined script or a executable if Charon disconnects from current valid license and no other valid license is found. This action is called every hour during the 12 hours grace period (at the end of which Charon-PAR stops unless a license has been found). The script or command started receives three parameters from Charon-PAR: key-id, product-license-id, and termination time. Usage example: |
license_changed_usr_cmd | Runs a user-defined script or an executable when Charon-PAR disconnects from one license and connects to another for any reason. The script or command started receives four parameters from Charon-PAR: old-key-id, old-product-license-id,new-key-id, and new-product-license-id. Usage example: |
license_expiration_warning_usr_cmd | Runs a user-defined script or an executable when the license expiration time is within few hours. The default setup is: starting 24 hours before expiration this script is invoked each hour. The script or command started receives three parameters from Charon-PAR: key-id, product-license-id, expiration time. Usage example: |
Machine State Parameters
Optional parameter: allows a non-default path to store the machine state.
Syntax:
machine_state_path "path"
Parameters:
The value of path is a Unix file system path. It must be enclosed in double quotes.