yb-ts-cli is a command line tool that can be used to perform an operation on a particular tablet server ([yb-tserver](../../reference/configuration/yb-tserver/)). Some of the commands perform operations similar to [yb-admin commands](../yb-admin/). The yb-admin commands focus on cluster administration, the yb-ts-cli commands apply to specific YB-TServer nodes. yb-ts-cli is a binary file installed with YugabyteDB and is located in the `bin` directory of the YugabyteDB home directory. ## Syntax ```sh yb-ts-cli [ --server_address=: ] ``` * *host*:*port*: The *host* and *port* of the tablet server. Default is `localhost:9100`. * *command*: The operation to be performed. See [Commands](#commands). * *flags*: The flags to be applied to the command. See [Flags](#flags). ### Online help To display the available online help, run yb-ts-cli without any commands or flags at the YugabyteDB home directory. ```sh ./bin/yb-ts-cli ``` ## Commands ### are_tablets_running If all tablets are running, returns "All tablets are running". **Syntax** ```sh yb-ts-cli [ --server_address=: ] are_tablets_running ``` * *host*:*port*: The *host* and *port* of the tablet server. Default is `localhost:9100`. ### is_server_ready Prints the number of tablets that have not yet bootstrapped. If all tablets have bootstrapped, returns "Tablet server is ready". **Syntax** ```sh yb-ts-cli [ --server_address=: ] is_server_ready ``` * *host*:*port*: The *host* and *port* of the tablet server. Default is `localhost:9100`. ### clear_server_metacache Clears all metacaches that are stored on a specified server. Works on both YB-Master (port 9100) and YB-TServer (port 7100) processes. Tablet servers and masters use MetaCaches to cache information about which tablet server hosts which tablet. Because these caches could become stale in some cases, you may want to use this command to clear the MetaCaches on a particular tablet server or master. **Syntax** ```sh yb-ts-cli [ --server_address=: ] clear_server_metacache ``` * *host*:*port*: The *host* and *port* of the tablet/master server. Default is `localhost:9100`. ### compact_all_tablets Compact all tablets on the tablet server. **Syntax** ```sh yb-ts-cli [ --server_address=: ] compact_all_tablets ``` * *host*:*port*: The *host* and *port* of the tablet server. Default is `localhost:9100`. ### compact_tablet Compact the specified tablet on the tablet server. **Syntax** ```sh yb-ts-cli [ --server_address=: ] compact_tablet ``` * *host*:*port*: The *host* and *port* of the tablet server. Default is `localhost:9100`. * *tablet-id*: The identifier of the tablet to compact. ### compact_vector_index Trigger compaction of [vector indexes](../../additional-features/pg-extensions/extension-pgvector/#vector-indexing) (pgvector) on a specific tablet. Use this for tablet-level vector index compaction when you need to compact only vector indexes on a given tablet (for example, after bulk loads or for maintenance). **Syntax** ```sh yb-ts-cli [ --server_address=: ] compact_vector_index [ ...] ``` * *host*:*port*: The *host* and *port* of the tablet server. Default is `localhost:9100`. * *tablet-id*: The identifier of the tablet that contains the vector index(es). * *vector-index-id1*, *vector-index-id2*, ...: Optional. Table IDs of specific vector indexes to compact. If omitted, all vector indexes on the tablet are compacted. ### count_intents Print the count of uncommitted intents (or [provisional records](../../architecture/transactions/distributed-txns/#provisional-records)). Helpful for debugging transactional workloads. **Syntax** ```sh yb-ts-cli [ --server_address=: ] count_intents ``` * *host*:*port*: The *host* and *port* of the tablet server. Default is `localhost:9100`. ### current_hybrid_time Prints the value of the current [hybrid time](../../architecture/transactions/transactions-overview/#hybrid-logical-clocks). **Syntax** ```sh yb-ts-cli [ --server_address=: ] current_hybrid_time ``` * *host*:*port*: The *host* and *port* of the tablet server. Default is `localhost:9100`. ### delete_tablet Deletes the tablet with the specified tablet ID (`tablet-id`) and reason. **Syntax** ```sh yb-ts-cli [ --server_address=: ] delete_tablet "" ``` * *host*:*port*: The *host* and *port* of the tablet server. Default is `localhost:9100`. * *tablet-id*: The identifier (ID) for the tablet. * *reason-string*: Text string providing information on why the tablet was deleted. ### dump_tablet Dump, or export, the specified tablet ID (`tablet-id`). **Syntax** ```sh yb-ts-cli [ --server_address=: ] dump_tablet ``` * *host*:*port*: The *host* and *port* of the tablet server. Default is `localhost:9100`. * *tablet-id*: The identifier (ID) for the tablet. ### flush_all_tablets Flush all tablets on the tablet server. **Syntax** ```sh yb-ts-cli [ --server_address=: ] flush_all_tablets ``` * *host*:*port*: The *host* and *port* of the tablet server. Default is `localhost:9100`. ### flush_tablet Flush the specified tablet on the tablet server. **Syntax** ```sh yb-ts-cli [ --server_address=: ] flush_tablet ``` * *host*:*port*: The *host* and *port* of the tablet server. Default is `localhost:9100`. * *tablet-id*: The identifier of the tablet to flush. ### list_tablets Lists the tablets on the specified tablet server, displaying the following properties: column name, tablet ID, state, table name, shard, and schema. **Syntax** ```sh yb-ts-cli [ --server_address=: ] list_tablets ``` * *host*:*port*: The *host* and *port* of the tablet server. Default is `localhost:9100`. ### reload_certificates Trigger a reload of TLS certificates and private keys from disk on the specified (master or tablet) server. **Syntax** ```sh yb-ts-cli [ --server_address=: ] reload_certificates ``` * *host*:*port*: The *host* and *port* of the master or tablet server. Default is `localhost:9100`. ### remote_bootstrap Trigger a remote bootstrap of a tablet from another tablet server to the specified tablet server. **Syntax** ```sh yb-ts-cli [ --server_address=: ] remote_bootstrap ``` * *host*:*port*: The *host* and *port* of the tablet server running the remote bootstrap. Default is `localhost:9100`. * *source-host*: The *host* or *host* and *port* of the tablet server to bootstrap from. * *tablet-id*: The identifier of the tablet to trigger a remote bootstrap for. See [Manual remote bootstrap of failed peer](/stable/troubleshoot/cluster/replace_failed_peers/) for example usage. ### set_flag Sets the specified configuration flag for the tablet server. **Syntax** ```sh yb-ts-cli [ --server_address=: ] set_flag [ --force ] ``` * *host*:*port*: The *host* and *port* of the tablet server. Default is `localhost:9100`. * `--force`: Flag to allow a change to a flag that is not explicitly marked as runtime-settable. Note that the change may be ignored on the server or may cause the server to crash, if unsafe values are provided. See [--force](#force). * *flag*: The yb-tserver configuration flag (without the `--` prefix) to be set. See [yb-tserver](../../reference/configuration/yb-tserver/) * *value*: The value to be applied. {{< note title="Important" >}} The `set_flag` command changes the in-memory value of the specified flag, atomically, for a running server, and can alter its behavior. **The change does NOT persist across restarts.** In practice, there are some flags that are runtime safe to change (runtime-settable) and some that are not. For example, the bind address of the server cannot be changed at runtime, because the server binds just once at startup. While most of the flags are probably runtime-settable, you need to review the flags and note in the configuration pages which flags are not runtime-settable. (See GitHub issue [#3534](https://github.com/yugabyte/yugabyte-db/issues/3534)). One typical operational flow is that you can use this to modify runtime flags in memory and then out of band also modify the configuration file that the server uses to start. This allows for flags to be changed on running servers, without executing a restart of the server. {{< /note >}} ### status Prints the status of the tablet server, including information on the node instance, bound RPC addresses, bound HTTP addresses, and version information. **Syntax** ```sh yb-ts-cli [ --server_address=: ] status ``` * *host*:*port*: The *host* and *port* of the tablet server. Default is `localhost:9100`. For an example, see [Return the status of a tablet server](#return-the-status-of-a-tablet-server) ### refresh_flags Refresh flags that are loaded from the configuration file. Works on both YB-Master (port 9100) and YB-TServer (port 7100) process. No parameters needed. Each process needs to have the following command issued, for example, issuing the command on one YB-TServer won't update the flags on the other YB-TServers. **Syntax** ```sh yb-ts-cli [ --server_address=: ] refresh_flags ``` * *host*:*port*: The *host* and *port* of the YB-Master or YB-TServer. Default is `localhost:9100`. ## Flags The following flags can be used, when specified, with the commands above. ### --force Use this flag with the [`set_flag`](#set-flag) command to allow a change to a flag that is not explicitly marked as runtime-settable. Note that the change may be ignored on the server or may cause the server to crash, if unsafe values are provided. Default: `false` ### --server-address The address (*host* and *port*) of the tablet server to run against. Default: `localhost:9100` ### --timeout_ms The duration, in milliseconds (ms), before the RPC request times out. Default: `60000` (1000 ms = 1 sec) ### --certs_dir_name To connect to a cluster with TLS enabled, you must include the `--certs_dir_name` flag with the directory location where the root certificate is located. Default: `""` ## Examples ### Return the status of a tablet server ```sh ./bin/yb-ts-cli --server_address=127.0.0.1 --certs_dir_name="/path/to/dir/name" status ``` ```output node_instance { permanent_uuid: "237678d61086489991080bdfc68a28db" instance_seqno: 1579278624770505 } bound_rpc_addresses { host: "127.0.0.1" port: 9100 } bound_http_addresses { host: "127.0.0.1" port: 9000 } version_info { git_hash: "83610e77c7659c7587bc0c8aea76db47ff8e2df1" build_hostname: "yb-macmini-6.dev.yugabyte.com" build_timestamp: "06 Jan 2020 17:47:22 PST" build_username: "jenkins" build_clean_repo: true build_id: "743" build_type: "RELEASE" version_number: "2.0.10.0" build_number: "4" } ``` ### Display the current hybrid time ```sh ./bin/yb-ts-cli --server_address=yb-tserver-1:9100 current_hybrid_time ``` ```output 6470519323472437248 ```