Installing the YDB DSTool
To install the YDB DSTool, follow these steps:
-
Run the command:
curl -sSL 'https://install.ydb.tech/dstool' | bash
The script will install the YDB DSTool. If the script is run from a
bash
orzsh
shell, it will also add theydb-dstool
executable to thePATH
environment variable. Otherwise, you can run it from the~/ydb/bin
folder or add it toPATH
manually. -
To update the environment variables, restart the command shell.
-
Test it by running the command that shows cluster information:
ydb-dstool -e <bs_endpoint> cluster list
bs_endpoint
: URI of the cluster's HTTP endpoint, the same endpoint that serves the Embedded UI. Example:http://localhost:8765
.
Result:
┌───────┬───────┬───────┬────────┬────────┬───────┬────────┐ │ Hosts │ Nodes │ Pools │ Groups │ VDisks │ Boxes │ PDisks │ ├───────┼───────┼───────┼────────┼────────┼───────┼────────┤ │ 8 │ 16 │ 1 │ 5 │ 40 │ 1 │ 32 │ └───────┴───────┴───────┴────────┴────────┴───────┴────────┘
To install the YDB DSTool, follow these steps:
-
Run the command:
curl -sSL 'https://install.ydb.tech/dstool' | bash
The script will install the YDB DSTool. If the script is run from a
bash
orzsh
shell, it will also add theydb-dstool
executable to thePATH
environment variable. Otherwise, you can run it from the~/ydb/bin
folder or add it toPATH
manually. -
To update the environment variables, restart the command shell.
-
Test it by running the command that shows cluster information:
ydb-dstool -e <bs_endpoint> cluster list
bs_endpoint
: URI of the cluster's HTTP endpoint, the same endpoint that serves the Embedded UI. Example:http://localhost:8765
.
Result:
┌───────┬───────┬───────┬────────┬────────┬───────┬────────┐ │ Hosts │ Nodes │ Pools │ Groups │ VDisks │ Boxes │ PDisks │ ├───────┼───────┼───────┼────────┼────────┼───────┼────────┤ │ 8 │ 16 │ 1 │ 5 │ 40 │ 1 │ 32 │ └───────┴───────┴───────┴────────┴────────┴───────┴────────┘
To install the YDB DSTool, follow these steps:
-
Run the command:
-
in PowerShell:
iex (New-Object System.Net.WebClient).DownloadString('https://install.ydb.tech/dstool-windows')
-
in CMD:
@"%SystemRoot%\System32\WindowsPowerShell\v1.0\powershell.exe" -Command "iex ((New-Object System.Net.WebClient).DownloadString('https://install.ydb.tech/dstool-windows'))"
-
-
Specify whether to add
ydb-dstool
to thePATH
environment variable:Add ydb-dstool installation dir to your PATH? [Y/n]
-
To update the environment variables, restart the command shell.
Note
The YDB DSTool uses Unicode characters in the output of some commands. If these characters aren't displayed correctly in the Windows console, switch the encoding to UTF-8:
chcp 65001
-
Test it by running the command that shows cluster information:
ydb-dstool -e <bs_endpoint> cluster list
bs_endpoint
: URI of the cluster's HTTP endpoint, the same endpoint that serves the Embedded UI. Example:http://localhost:8765
.
Result:
┌───────┬───────┬───────┬────────┬────────┬───────┬────────┐ │ Hosts │ Nodes │ Pools │ Groups │ VDisks │ Boxes │ PDisks │ ├───────┼───────┼───────┼────────┼────────┼───────┼────────┤ │ 8 │ 16 │ 1 │ 5 │ 40 │ 1 │ 32 │ └───────┴───────┴───────┴────────┴────────┴───────┴────────┘