example.conf

# This is an example configuration file for the landscape client.
# It is not meant to be machine-readable, but to list all the existing configuration
# options it recognises so that you can create a valid, machine-readable configuration
# file (typically as /etc/landscape/client.conf).

# All lines starting with a pound sign should be considered comments.
# Values given are the default.

[client]

# GENERAL OPTIONS

# The directory in which landscape-client will store data files in.
data_path = /var/lib/landscape/client/

# If set to True, do not log to standard output.
quiet = False

# The directory in which to store log files.
log_dir = /var/log/landscape/

# The log level at which to log events.
# Values can be one of: "debug", "info", "warning", "error", "critical"
log_level = info

# The main URL for the landscape server to connect this client to. If you
# purchased a Landscape Dedicated Server (LDS), change this to point to your
# server instead. This needs to point to the message-system URL.
#
# Please pay special attention to the protocol used here, since it is a common
# source of error.
#
# Example:
#   url = https://landscape.example.com/message-system
url = https://landscape.canonical.com/message-system

# The ping url you want this client to report to.
#
# If you have purchased a Landscape Dedicated Server (LDS), change this to
# point to your server instead.
#
# Example:
#   ping_url = http://landscape.example.com/ping
ping_url = http://landscape.canonical.com/ping

# The public SSL certificate file against which the connection to the landscape
# server (set in "url") will be checked.
#
# This configuration entry is not set by default.
#
#ssl_public_key

# The ratio over which to spread landscape intervals. This is to mitigate
# the impact of restarting the host of multiple landscape-client instances.
# Values range from 0.0 to 1.0, from unstaggered to spreading over
# the full interval.
#
# Default value is 0.1, meaning jobs will start with up to 10% delay
#
# Example:
#   stagger_launch = 0.5

# If set to True interrupt (SIGINT) signals will be ignored by the
# landscape-client daemon.
ignore_sigint = False

# If set to True, user signal 1 (SIGUSR1) will be ignored by the landscape
# client daemon.
# SIGUSR1 is used to force rotating logs.
ignore_sigusr1 = False

# MONITOR OPTIONS

# A comma-separated list of monitor plugins to use.
#
# Currently available monitor plugins are:
#
#   ActiveProcessInfo - lists active processes
#   ComputerInfo - various information
#   LoadAverage - load information
#   MemoryInfo - memory information
#   MountInfo - information about mount points (space available, used)
#   ProcessorInfo - type, speed, instruction sets
#   Temperature - temperature sensors information
#   PackageMonitor - packages installed, available, versions
#   UserMonitor - users, groups
#   RebootRequired - whether a reboot is required or not
#   AptPreferences - system APT preferences configuration
#   NetworkActivity - network information (TX, RX)
#   NetworkDevice - a list of connected network devices
#   UpdateManager - controls when distribution upgrades are prompted
#   CPUUsage - CPU usage information
#   SwiftUsage - Swift cluster usage
#   CephUsage - Ceph usage information
#   ComputerTags - changes in computer tags
#   UbuntuProInfo - Ubuntu Pro registration information
#   LivePatch - Livepath status information
#   UbuntuProRebootRequired - informs if the system needs to be rebooted
#   SnapServicesMonitor - manage snap services
#
# The special value "ALL" is an alias for the full list of plugins.
monitor_plugins = ALL

# The number of seconds between monitor flushes.
flush_interval = 300 # 5 minutes

# BROKER OPTIONS

# The account name this computer belongs to.
# This configuration option has no default value.
#
# It is required that you define a value for this entry.
account_name = dummy

# An optional account-wide key used to register clients.
# You can define a registration key in your account settings.
# There is no key defined by default.
#registration_key = secret-key

# The computer title to report to the landscape server as identifying this
# computer.
#
# It is required that you define a value for this entry.
#computer_title = Database Server 1

# The number of seconds between server exchanges
exchange_interval = 900 # 15 minutes

# The number of seconds between urgent exchanges with the server.
urgent_exchange_interval = 60 # 1 minute

# The number of seconds between pings.
ping_interval = 30

# The number of seconds between apt update calls.
apt_update_interval = 21600

# The number of seconds between package monitor runs.
package_monitor_interval = 1800

# The number of seconds between snap monitor runs.
snap_monitor_interval = 1800

# The URL of the http proxy to use, if any.
# This value is optional.
#
#http_proxy=http://my-proxy.example.com:8080

# The URL of the https proxy to use, if any.
# This value is optional.
#https_proxy=https://my-proxy.example.com:8081

# If set, your machine will be marked as a cloud instance.
cloud = True

# The One Time Password (OTP) that was given by cloud-init, to be used during
# registration.
#
# This has no default.
#otp = ABCD1234

# A comma-separated list of tags to attach to this computer.
#
# Example:
#   tags = servers, oneiric, database, production
#tags = example

# MANAGER OPTIONS

# A comma-separated list of manager plugins to use.
#
# Currently available manager plugins are:
#
#   ProcessKiller
#   PackageManager
#   UserManager
#   ShutdownManager
#   AptSources
#   HardwareInfo
#   KeystoneToken
#   SnapManager
#   SnapServicesManager
#
# The special value "ALL" is an alias for the entire list of plugins above and is the default.
manager_plugins = ALL

# A comma-separated list of manager plugins to use in addition to the default ones.
#
# The ScriptExecution manager plugin is not enabled by default.
# The following example would enable it.
#include_manager_plugins = ScriptExecution

# A comma-separated list of usernames that scripts can run as.
#
# By default, all usernames are allowed.
#script_users = ALL


# The maximum script output length transmitted to landscape
# Output over this limit is truncated
#
# The default is 512kB
# 2MB is allowed in this example
#script_output_limit=2048

# Whether files in /etc/apt/sources.list.d are removed when a repository
# profile is added to this machine.
#
# The default is True
#manage_sources_list_d = True

# Set this for WSL instances managed by Landscape. The value
# should match the uid assigned to the host machine.
# For all other computers, do not set this parameter.
#hostagent_uid = the-uid-of-the-host-machine