Skip to main content

Pre-installation Configuration Tool

taospreset prepares one host or all hosts in a cluster for TDengine installation.

Usage

usage: taospreset [-h] [--model {local,ssh}] [--config CONFIG]
[--backend] [--disable-kysec] [--result RESULT]
[--version] [--log-level {debug,info}]
OptionDescription
-m, --modelConfigure the local host or all configured hosts over SSH; default: local
-f, --configFull path to the configuration file; default: current directory
-b, --backendRun in the background
-d, --disable-kysecDisable the KySec security framework on Kylin Linux
-r, --resultReport output directory; default: current directory
-l, --log-levelLog level: debug or info; default: info
-v, --versionPrint the tool version

The configuration format is shared with taosprecheck. It can define hosts, timezone, service state, core dump paths, and kernel and user limits.

[test_env]
firstep=192.168.0.1||fqdn=tdengine1||username=root||password=123456||port=22
secondep=192.168.0.2||fqdn=tdengine2||username=root||password=123456||port=22

[timezone]
tz=Asia/Shanghai

[services]
firewall=inactive
selinux=inactive

[coredump]
kernel.core_pattern=/data/taos/core/core-%%e-%%p

Configuration Scope

The tool can configure the system timezone, stop the firewall and SELinux services, apply system parameters, configure core dumps, replace a default localhost hostname with the configured FQDN, and add cluster host mappings to /etc/hosts.

Output

taospreset writes preset_report.md, which records the settings changed by the tool.

Examples

# Configure the current host
./taospreset

# Configure all hosts over SSH
./taospreset -m ssh

# Use a specific configuration
./taospreset -m ssh -f /path/to/preset.cfg

# Also disable KySec
./taospreset -m ssh -d