Product
Support
Everything Else
Helix 6 Server — Server Preferences
Introduction

Some behaviors of Helix Server can be changed by setting preference values. They are documented in Helix Server's built-in Help, under the topic "Setting Server Preferences" — consult that Help page for the list that applies to the version of Helix Server you are running.

In Helix Server 6.0, preferences fit into four basic areas: File Paths, Info Windows, Memory Allocation, and Buffering. Although the default settings are preferred by most users, being able to change these values is important to some users, and they may provide performance improvements in certain situations, so we provide a way to change them.

Two of the Buffer related commands are also accessible via Helix Server's Preferences window, which is the preferred method of adjusting these settings. A future release will bring all of the preferences into the stardard interface.

How Do I Change Preference Values?

Helix Server preferences are stored in an XML formatted plist (macOS's preference file format) named "com.qsatoolworks.helixserver" found in the user's ~/Library/Preferences/ folder. This file can be edited with any XML editor. If you have installed Apple's Developer tools, you have their Property List Editor application and double clicking on the Helix Server preference file should launch it automatically. If you have installed the developer tools, we assume you don't need instructions on using Property List Editor. All macOS installations include the Terminal application, so the following instructions explain how to change preferences using Terminal.

To change a setting, make sure Helix Server is not running, then open the Terminal application (/Applications/Utilities/) and enter a command in this format:

defaults write com.qsatoolworks.helixserver keyword -datatype value

The underlined words must be replaced with appropriate values taken from the chart found in the built-in help for your version of Helix Server. These three values represent the preference to be changed for the word keyword, the type of data required by the preference for the word datatype and the value to set the preference to for the word value.

Note: Keywords are case sensitive! If you enter a value with the wrong case, it will not cause a problem, but the entry has no effect on Helix's behavior.

Frequently Requested Changes
Turning Crash Warnings Off (and Back On)

When a Helix collection is opened the first time after a crash, it presents a series of dialog boxes letting you know about the problem. Since the collection is not available until these dialogs are dismissed, it is sometimes preferred to turn these dialogs off altogether. (Particularly in a situation where the Server is unattended.)

To turn the crash recovery dialogs off, make sure Helix Server is not running, then open the Terminal application (/Applications/Utilities/) and enter this command:

defaults write com.qsatoolworks.helixserver HxLogRecoveryAlert -boolean no

You can turn the crash recovery dialogs back on with this command:

defaults write com.qsatoolworks.helixserver HxLogRecoveryAlert -boolean yes

Turning Transaction Logging Off (and On)

Since the vast majority of users prefer to run their Servers with transaction logging turned on, and because it is easy to forget to turn it back on after making design changes via Helix RADE, Helix 6 Server turns transaction logging on by default. There is no "Save and Log"/"Save and Stop Logging" menu command in Helix 6.

To turn transaction logging off, make sure Helix Server is not running, then open the Terminal application (/Applications/Utilities/) and enter this command:

defaults write com.qsatoolworks.helixserver HxAutologging -boolean no

You can turn transaction logging back on with this command:

defaults write com.qsatoolworks.helixserver HxAutologging -boolean yes

More Preference Settings

For the complete list of editable preferences, see this page.