System¶

Overview¶

System is a Saltbox module that configures system-wide settings including APT updates, network optimizations, sysctl tunings, CPU performance mode, timezone, locale, and log rotation.

Deployment¶

Core Saltbox role.

sb install system

Role Defaults¶

Variables can be customized using the Inventory. (1)

Example override
```
run_sysctl_tasks: true
```

General

run_sysctl_tasks

# Type: bool (true/false)
run_sysctl_tasks: true

cpu_performance_mode

# Manage CPU governor settings in performance mode on non-virtualized hosts.
# Set to false to leave the existing CPU governor configuration unchanged.
# Type: bool (true/false)
cpu_performance_mode: true

system_mount_tuning_enabled

# Ensure nodiratime and relatime on mounted local ext4 filesystems.
# Preserve existing noatime and explicit diratime or strictatime settings.
# Set to false to leave existing mount options unmanaged.
# Type: bool (true/false)
system_mount_tuning_enabled: true

system_mount_tuning_excluded_mounts

# Mount points to exclude from automatic access-time tuning.
# Example: ["/mnt/archive", "/mnt/backups"]
# Type: list
system_mount_tuning_excluded_mounts: []

system_inotify

# Type: string
system_inotify: "524288"

pam_limit_nofile

# Type: string
pam_limit_nofile: "100000"

timezone

# Type: string
timezone: "{{ tz }}"

timezone_string

# Type: string
timezone_string: "Time zone: {{ timezone }}"

timezone_use_local_rtc

# Type: bool (true/false)
timezone_use_local_rtc: false

system_locale

# Type: string
system_locale: "en_US.UTF-8"

system_language

# Type: string
system_language: "en_US.UTF-8"

saltbox_max_log_size

# Type: string
saltbox_max_log_size: 2M

sysctl_netdev_budget_usecs

# Reminder to change the conditional in sysctl.yml if defaults change
# Type: string
sysctl_netdev_budget_usecs: "5000"

sysctl_remove_settings

# Type: list
sysctl_remove_settings:
  - fs.file-max