Preference¶
A Preference (Pref) tracks a global DRP configuration setting. While most configuration in DRP flows through the Profile and Param system, Preferences provide simple string key-value pairs for a small set of system-wide settings that can be changed at runtime without restarting the server.
Preferences cover settings such as the default boot environment for known
machines, the boot environment served to unknown machines, token
timeouts, and debug logging levels for various subsystems. Both the key
(Name) and value (Val) are strings; integer values are stored as
their string representation and parsed internally.
When a corresponding Param exists for a Preference name, validation is performed against the Param's schema. This allows operators to extend the preference system with type-checked values while maintaining backward compatibility with the simple string-based storage.
| Pref | Type | Description |
|---|---|---|
defaultBootEnv |
string | This is a valid BootEnv the is assign to a Machine if the machine does not have a bootenv specified. The default is sledgehammer. |
unknownBootEnv |
string | This is the BootEnv used when a boot request is serviced by an unknown machine. The BootEnv must have OnlyUnknown set to true. The default is ignore. |
unknownTokenTimeout |
integer | The amount of time in seconds that the token generated by GenerateToken is valid for unknown machines. The default is 600 seconds. |
knownTokenTimeout |
integer | The amount of time in seconds that the token generated by GenerateToken is valid for known machines. The default is 3600 seconds. |
debugRenderer |
integer | The debug level of the renderer system. 0 = off, 1 = info, 2 = debug |
debugDhcp |
integer | The debug level of the DHCP system. 0 = off, 1 = info, 2 = debug |
debugBootEnv |
integer | The debug level of the BootEnv system. 0 = off, 1 = info, 2 = debug |