Command lines
The greptime command provided by the pre-built binary can start/stop GreptimeDB and pass configuration options. To execute the binary with greptime instead of the ad-hoc ./greptime, you might need to move the binary into the system bin directory or add the binary path to the PATH environment variable.
The help command lists all available commands and options of greptime.
$ greptime help
greptimedb
branch: ...
commit: ...
dirty: ...
version: ...
USAGE:
greptime [OPTIONS] <SUBCOMMAND>
OPTIONS:
-h, --help Print help information
--log-dir <LOG_DIR>
--log-level <LOG_LEVEL>
-V, --version Print version information
SUBCOMMANDS:
cli
datanode
frontend
help Print this message or the help of the given subcommand(s)
metasrv
standalone$ greptime help
greptimedb
branch: ...
commit: ...
dirty: ...
version: ...
USAGE:
greptime [OPTIONS] <SUBCOMMAND>
OPTIONS:
-h, --help Print help information
--log-dir <LOG_DIR>
--log-level <LOG_LEVEL>
-V, --version Print version information
SUBCOMMANDS:
cli
datanode
frontend
help Print this message or the help of the given subcommand(s)
metasrv
standalone--log-dir=[dir]specify logs directory,/tmp/greptimedb/logsby default.--log-level=[info | debug | error | warn | trace]specify the log level,infoby default.
Starts GreptimeDB in standalone mode with customized configurations:
greptime --log-dir=/tmp/greptimedb/logs --log-level=info standalone start -c config/standalone.example.tomlgreptime --log-dir=/tmp/greptimedb/logs --log-level=info standalone start -c config/standalone.example.tomlThe standalone.example.toml configuration file comes from the config directory of the [GreptimeDB](https://github.com/GreptimeTeam/greptimedb/) repository. You can find more example configuraiton files there. The -c option specifies the configuration file, for more information check Configuration.
To start GreptimeDB in distributed mode, you need to start each component separately. The following commands show how to start each component with customized configurations or command line arguments.
Starts a metasrv with customized configurations:
greptime metasrv start -c config/metasrv.example.tomlgreptime metasrv start -c config/metasrv.example.tomlStarts a datanode instance with customized configurations:
greptime datanode start -c config/datanode.example.tomlgreptime datanode start -c config/datanode.example.tomlStarts a datanode instance with command line arguments specifying the gRPC service address, the MySQL service address, the address of the metasrv, and the node id of the instance:
greptime datanode start --rpc-addr=0.0.0.0:4001 --mysql-addr=0.0.0.0:4002 --metasrv-addr=0.0.0.0:3002 --node-id=1greptime datanode start --rpc-addr=0.0.0.0:4001 --mysql-addr=0.0.0.0:4002 --metasrv-addr=0.0.0.0:3002 --node-id=1Starts a frontend instance with customized configurations:
greptime frontend start -c config/frontend.example.tomlgreptime frontend start -c config/frontend.example.tomlStarts a frontend instance with command line arguments specifying the address of the metasrv:
greptime frontend start --metasrv-addr=0.0.0.0:3002greptime frontend start --metasrv-addr=0.0.0.0:3002