TrueNAS SCALETrueNAS SCALE Documentation Archive
This content follows the TrueNAS SCALE 22.12 (Bluefin) releases. Archival documentation is provided for reference only and not actively maintained.
Use the Product and Version selectors above to view content specific to different TrueNAS software or major version.

Managing Advanced Settings

Advanced Settings provides configuration options for the console, syslog, sysctl, replication, cron jobs, init/shutdown scripts, system dataset pool, isolated GPU device(s), and self-encrypting drives.

Advanced settings have reasonable defaults in place. A warning message displays for some settings advising of the dangers making changes. Changing advanced settings can be dangerous when done incorrectly. Use caution before saving changes.

ChangingAdvancedSettingsWarning

Make sure you are comfortable with ZFS, Linux, and system configuration backup and restoration before making any changes.

SystemAdvancedScreen

This article provides information on sysctl, system dataset pool, and setting the maximum number of simultaneous replication tasks the system can perform.

Managing Sysctl Variables

Use Add on the Sysctl widget to add a tunable that configures a kernel module parameter at runtime.

AdvancedSysctlWidgetNoSysctl

The Add Sysctl or Edit Sysctl configuration screens display the settings.

AddSysctlConfigScreens

Enter the sysctl variable name in Variable. Sysctl tunables configure kernel module parameters while the system runs and generally take effect immediately.

Enter a sysctl value for the loader in Value.

Enter a description and then select Enabled. To disable but not delete the variable, clear the Enabled checkbox.

Click Save.

Managing the System Dataset Pool

Storage widget displays the pool configured as the system dataset pool and allows users to select the storage pool they want to hold the system dataset. The system dataset stores core files for debugging and keys for encrypted pools. It also stores Samba4 metadata, such as the user and group cache and share-level permissions.

AdvancedSystemStorageWidget

Configure opens the Storage Settings configuration screen.

Storage Settings Configuration Screen

If the system has one pool, TrueNAS configures that pool as the system dataset pool. If your system has more than one pool, you can set the system dataset pool using the Select Pool dropdown. Users can move the system dataset to an unencrypted pool, or an encrypted pool without passphrases.

SystemDatasetPoolConfigScreen

Users can move the system dataset to a key-encrypted pool, but cannot change the pool encryption type afterward. If the encrypted pool already has a passphrase set, you cannot move the system dataset to that pool.

Swap Size lets users enter an amount (in GiB) of hard disk space to use as a substitute for RAM when the system fully utilizes the actual RAM.

By default, the system creates all data disks with the specified swap amount. Changing the value does not affect the amount of swap on existing disks, only disks added after the change. Swap size does not affect log or cache devices.

Setting the Number of Replication Tasks

The Replication widget displays the number of replication tasks that can execute simultaneously configured on the system. It allows users to adjust the maximum number of replication tasks the system can execute simultaneously.

SystemAdvancedSettingsReplicationWidget

Click Configure to open the Replication configuration screen.

AdvancedSettingsReplicationConfigScreen

Enter a number for the maximum number of simultaneous replication tasks you want to allow the system to process and click Save.

Related Content

Related Replication Articles