run.md+deploy.md: major update

docs/reference/cli.md

@@ -66,7 +66,19 @@ picodata run [OPTIONS]
 Адрес, который другие инстансы должны использовать для подключения к
 данному инстансу.
 
-По умолчанию используется значение параметра [--listen](#run_listen).
+Параметр `--advertise` используется для установки публичного IP-адреса и
+порта инстанса. Параметр сообщает, по какому адресу остальные инстансы
+должны обращаться к текущему. По умолчанию он равен
+[--listen](#run_listen), поэтому его не обязательно использовать. Но,
+например, в случае `--listen 0.0.0.0` его придется указать явно:
+
+```shell
+picodata run --listen 0.0.0.0:3301 --advertise 192.168.0.1:3301
+```
+
+Значение параметра `--advertise` анонсируется кластеру при запуске
+инстанса. Его можно поменять при перезапуске инстанса или в процессе его
+работы командой `picodata set-advertise`.
 
 Аналогичная переменная окружения: `PICODATA_ADVERTISE`<br>
 Аналогичный параметр файла конфигурации: `instance.advertise_address`
@@ -201,7 +213,12 @@ picodata run [OPTIONS]
 
 Сетевой адрес инстанса.
 
-По умолчанию используется значение `localhost:3301`.
+По умолчанию используется значение `localhost:3301`. Если указать только
+порт, то будет использован IP-адрес по умолчанию (127.0.0.1).
+
+Значение параметра сохраняется в системной таблице
+[_pico_peer_addresses](../architecture/system_tables.md#_pico_peer_address),
+но может измениться при перезапуске инстанса.
 
 Аналогичная переменная окружения: `PICODATA_LISTEN`<br>
 Аналогичный параметр файла конфигурации: `instance.listen`

docs/tutorial/run.md

@@ -12,9 +12,11 @@ Picodata, из которых состоит кластер. Picodata может
 Запуск инстанса сводится к выполнению команды `picodata run` с нужным
 набором параметров. Полный перечень
 возможных параметров запуска и их описание содержатся в разделе
-[Аргументы командной строки Picodata](../reference/cli.md), а также в выводе команды
+[Аргументы командной строки Picodata], а также в выводе команды
 `picodata run --help`.
 
+[Аргументы командной строки Picodata]: ../reference/cli.md
+
 Обязательных параметров у исполняемого файла `picodata` нет, что позволяет
 свести запуск к выполнению всего одной простой команды:
 
@@ -23,36 +25,13 @@ picodata run
 ```
 
 Такой вариант предполагает целый ряд умолчаний, касающихся размещения
-рабочих файлов инстанса, сетевых адресов, вывода отладочного
-журнала и т.д. В реальности, для решения практических задач, ряд
-параметров запуска необходимо задать явным образом, см. [Создание
-кластера](../tutorial/deploy.md)
-
-## Несколько инстансов на одном сервере {: #single_server_run }
-
-Если планируется запускать на одном сервере (вычислительном узле)
-несколько инстансов Picodata, то необходимо определить каждому инстансу
-его директорию (параметр `--data-dir`), в которой инстанс будет
-размещать свои [рабочие
-файлы](../architecture/instance_runtime_files.md) (иначе он будет
-хранить их в текущей директории). Также нужно указать адрес и порт для
-приема соединений (параметр `--listen`) в формате `<HOST>:<PORT>`. Если
-для `--listen` указать только порт, то будет использован IP-адрес по
-умолчанию (127.0.0.1):
-
-```shell
-picodata run --data-dir i1 --listen :3301
-```
-Соответственно, указанные параметры должны отличаться при запуске
-нескольких инстансов. Например:
+рабочих файлов инстанса, сетевых адресов, вывода диагностических
+сообщений и т.д. Если необходимо запустить несколько инстансов, которые
+объединятся к кластер, задайте параметры запуска явно.
 
-```shell
-picodata run --data-dir i1 --listen :3301
-picodata run --data-dir i2 --listen :3302
-picodata run --data-dir i3 --listen :3303
-```
+См. также:
 
-Все корректно запущенные инстансы автоматически объединяются в один кластер.
+- [Создание кластера](../tutorial/deploy.md)
 
 ## Безопасный запуск {: #secure_run }
 
@@ -60,15 +39,14 @@ picodata run --data-dir i3 --listen :3303
 
 Для обеспечения мер безопасности рекомендуется организовать хранение
 пароля для внутреннего системного пользователя `pico_service` в
-отдельном файле. При запуске инстанса путь к этому файлу следует
-передать в параметре [‑‑service‑password‑file][pwdfile].
+отдельном файле. При запуске инстанса путь к этому файлу передайте в
+параметре [‑‑service‑password‑file][pwdfile].
 
-Дополнительно, в опции [‑‑audit][audit] следует явно указать способ
+Дополнительно, в опции [‑‑audit][audit] явно укажите указать способ
 вывода [журнала аудита](../tutorial/audit_log.md).
 
 Также рекомендуется использовать опцию [‑‑shredding][shredding], которая
-обеспечивает безопасное удаление рабочих файлов, см. [Рабочие файлы
-инстанса](../architecture/instance_runtime_files.md).
+обеспечивает безопасное удаление рабочих файлов.
 
 Пример команд, реализующих безопасный запуск:
 
@@ -84,11 +62,11 @@ picodata run --service-password-file secret.txt --audit audit.log --shredding
 
 ## Безопасное завершение работы {: #secure_stop }
 
-Для безопасного завершения работы инстанса следует нажать сочетание
+Для безопасного завершения работы инстанса нажмите сочетание
 ++ctrl+c++ в консоли, в которой он был запущен. После этого процесс
 инстанса будет корректно завершен.
 
 См. также:
 
-- [Создание кластера](deploy.md)
+- [Аргументы командной строки](../reference/cli.md)
 - [Подключение и работа в консоли](connecting.md)