Start the Tarantool instance specified on the command line if the instance is not running. This does nothing if an instance is running.

stop INSTANCE

Stop the Tarantool instance specified on the command line if the instance is running. This does nothing if an instance is not running.

status INSTANCE

Show status of the Tarantool instance specified on the command line (started/stopped). If pid file exists and an alive control socket exists, the return code is 0. Otherwise, the return code is not 0. Reports typical problems to stderr (e.g. pid file exists and control socket does not).

restart INSTANCE

Stop and start the Tarantool instance specified on the command line if the instance is running. This does nothing if an instance is not running.

logrotate INSTANCE

Rotate logs of the Tarantool instance specified on the command line if the instance is running. This works only if logging-into-file is enabled in the instance file ("box.cfg{log=...}" parameter). Pipe/syslog make no effect.

check INSTANCE

Check if there are syntax errors in the instance script of the Tarantool instance specified on the command line.

enter INSTANCE

Enter the interactive console of the Tarantool instance specified on the command line.

eval INSTANCE FILE

COMMAND | tarantoolctl eval INSTANCE

Evaluate a local file on the Tarantool instance specified on the command line if the instance is running. This does nothing if an instance is not running.

connect URI

COMMAND | tarantoolctl connect URI

Connect on an admin-console port to the Tarantool instance with the URI specified on the command line. This supports both TCP/Unix sockets.

The file with system-wide defaults for tarantoolctl is installed in "/etc/default/tarantool". This file is used when tarantoolctl is invoked by root. When invoked by a local user, tarantoolctl first looks for its defaults file in the current directory ("$PWD/.tarantoolctl"), and then in the current user's home directory ("$HOME/.config/tarantool/tarantool"). If not found, tarantoolctl falls back to built-in defaults:

Directory for the pid file and control-socket file; tarantoolctl will add "/instance_name" to the directory name.

wal_dir

Directory for write-ahead *.xlog files; tarantoolctl will add "/instance_name" to the directory name.

memtx_dir

Directory for snapshot *.snap files; tarantoolctl will add "/instance_name" to the directory name.

vinyl_dir

Directory for vinyl files; tarantoolctl will add "/instance_name" to the directory name.

log

The place where the application log will go; tarantoolctl will add "/instance_name.log" to the name.

username

The user that runs the Tarantool instance. This is the operating-system user name rather than the Tarantool-client user name. Tarantool will change its effective user to this user after becoming a daemon.

instance_dir

The directory where all instance files for this host are stored. Put instance files in this directory, or create symbolic links.

As a full-featured example, you can take "example.lua" script that ships with Tarantool and defines all configuration options.