Site SMAT options

Note: These options are read-only. Changes are made on the Server Administration > Host Server databases tab. See Host Server Databases tab.

The Database Options panel is read-only. This lists the current SMAT database encryption settings.

  • Saved into:
    • Saved into: File
    • Saved into: Database
  • Data Encryption:
    • Data Encryption: Disabled
    • Data Encryption: Enabled

These read-only fields are based on the site level. That is, the configuration is implemented on all processes. Processes within a site save the history database files to the link path.

You can also save SMAT history files outside the site folder by creating a link path to a specific folder/disc. See Loading SMAT history outside the SMAT folder.

This table shows the available options on the Site Preferences SMAT tab:

Option Description

Enable SMAT History

These settings affect the SMAT history behavior for each engine process. Because these settings are loaded after the engine is started, an engine bounce/restart is required for these setting to take effect. Daemons do not require to be restarted because SMAT is written by hciengine and has no effect on daemons.

Delete the oldest SMAT inbound/outbound history file when history file's number for a thread exceeds number files

Delete the oldest SMAT history file when history file's total size for a process exceeds number KB

Delete SMAT history file for a process when it is older than number days

These options are used to maintain the SMAT history files. When Unlimited is selected, the cycled SMAT files are saved. Otherwise, the earlier files are deleted after the limitation of the file number, disk size, or lifetime is reached.

If there are more than one file to compress, then each file is compressed individually.

If no command is configured, then the cycling files are not archived.

By default it is set to NULL and compression is disabled. The gzip and compress commands are supported.

Option descriptions are:

  • Delete the oldest SMAT inbound/outbound history file when history file's number for a thread exceeds number files

    This value controls the maximum number of SMAT files within SmatHistory. When the cycled file number exceed this threshold, the newest cycled file is saved and the oldest is deleted. The time stamp is the indicator for deciding which file is the newest and oldest. This option is on the thread-level. Each thread’s SMAT file number limitation is the threshold.

  • Delete the oldest SMAT history file when history file's total size for a process exceeds number KB

    This value is the threshold of the total size of SMAT files within SmatHistory. When the cycled file is backed up to SmatHistory, the engine calculates the size of all files and compares it to this threshold. When the size exceeds the threshold, the oldest file is deleted. The timestamp is also an indicator. This option is for the process-level. The total size contains all threaded SMAT files. It does not indicate the total size of SMAT files in a special thread.

  • Delete SMAT history file for a process when it is older than number days

    Age indicates the time stamp of the cycled SMAT file.

    This option continues saving the cycled files as long as the value is set. When a new cycled file moves into SmatHistory, the engine checks all files by timestamp one-by-one. After the file saving time exceeds this threshold, the file is deleted.

When all files are set a value, the engine deals with them with a priority of:

  1. Delete the oldest SMAT inbound/outbound history file when history file's number for a thread exceeds number files
  2. Delete the oldest SMAT history file when history file's total size for a process exceeds number KB
  3. Delete SMAT history file for a process when it is older than number days

Compress Command

This compresses the backed-up SMAT files to save disk space.

Save SMAT history based on thread name

The default value is unselected (key value = 0). When this is selected, (key value = 1), the smatHistory database files are saved based on the thread names.

SMAT History Location

The default value is null. Select this to save the SMAT history outside of the site folder. This creates a link path, where you can write the actual location in which to save the SMAT history.

Use Log History Setting

Select this for all the common settings to be synchronized. To use this feature:

  1. Select Enable Log History on Log History tab.
  2. Select Enable SMAT History on the SMAT tab.

Both history options must be selected to enable Use Log History Setting.

You can now apply the common settings of the Log History tab to SMAT Log History. The Compress Command setting cannot be applied if it is disabled. To enable it, you must clear Save into Database and select Enable SMAT History. After this is enabled, it can be synchronized with the log history settings.