run.md: describe running multiple instances

docs/tutorial/run.md

@@ -9,26 +9,59 @@ Picodata, из которых состоит кластер. Picodata может
 
 ## Минимальный вариант запуска {: #simple_run }
 
-Запуск инстанса сводится к выполнению команды `picodata run` с нужным
-набором параметров. Полный перечень возможных параметров запуска и их
+В самом простом случае запуск инстанса сводится к выполнению команды
+ `picodata run` без каких-либо параметров:
+
+```shell
+picodata run
+```
+
+Будет запущен кластер, состоящий из одного инстанса. Все параметры будут
+стандартны, и, скорее всего, вы захотите их переопределить.
+
+Читайте далее:
+
+- [Подключение и работа в консоли](../tutorial/connecting.md)
+
+## Запуск нескольких инстансов {: #run_multiple_instances }
+
+Для того чтобы запустить несколько инстансов на одном сервере,
+потребуется задать дополнительные параметры для каждого из них:
+
+- рабочую директорию ([--data-dir])
+- сетевой адрес ([--listen])
+- адрес одного или нескольких соседних инстансов ([--peer])
+
+Полный перечень возможных параметров запуска и их
 описание содержатся в разделе [Аргументы командной строки], а также в
 выводе команды `picodata run --help`.
 
 [Аргументы командной строки]: ../reference/cli.md
 
-Чтобы запустить кластер из одного инстанса выполните:
+Чтобы запустить два инстанса, которые объединятся в кластер,
+выполните в двух соседних терминалах следующие команды:
 
 ```shell
-picodata run
+picodata run --data-dir ./data/i1 --listen 127.0.0.1:3301
+```
+
+```shell
+picodata run --data-dir ./data/i2 --listen 127.0.0.1:3302 --peer 127.0.0.1:3301
 ```
 
-Обязательных параметров у этой команды нет. Такой вариант предполагает
-целый ряд умолчаний, касающихся размещения рабочих файлов инстанса,
-сетевых адресов, вывода отладочного журнала и т.д.
+Обратите внимание на различия в запуске инстансов:
+
+- каждый инстанс использует свою рабочую директорию и сетевой адрес
+- в отсутствие параметра `--peer` запуск инстанса приводит к созданию
+  нового кластера. Чтобы инстансы добавлялись в уже существующий кластер
+  в этом параметре передается адрес первого инстанса
+
+[--data-dir]: ../reference/cli.md#run_data_dir
+[--listen]: ../reference/cli.md#run_listen
+[--peer]: ../reference/cli.md#run_peer
 
 Читайте далее:
 
-- [Подключение и работа в консоли](../tutorial/connecting.md)
 - [Создание кластера](../tutorial/deploy.md)
 
 ## Безопасный запуск {: #secure_run }