3.12.5.2. Через интерфейс командной строки

 
Интерфейс командной строки позволяет получать диагностическую информацию по Astra.Historian и базам данных, а также запускать некоторые команды управления.
 
Для выполнения консольных команд используется утилита командной строки: astra.historian.cli – файл astra.historian.cli.exe в папке установки Astra.Historian.
 
Для запуска утилиты командной строки astra.historian.cli необходимо выполнить следующие действия:
  • Открыть командную строку.
  • Перейти в каталог:
ОС Windows: C:\Program Files\AstraRegul\Astra.Historian
OC Linux: /opt/AstraRegul/Astra.Historian
3. Выполнить команду.
Команды можно передавать как локальному экземпляру Astra.Historian, так и удалённому.
 
Общий синтаксис командной строки:
astra.historian.cli [ПАРАМЕТРЫ] КОМАНДА

Консольный вывод

 
Вся информация выводится в стандартный поток вывода stdout.
 
Поток вывода stderr не используется: сообщения об ошибках выводятся в поток stdout. Сделано это, чтобы сохранить порядок вывода сообщений для удобства анализа.
 
Формат вывода зависит от значения параметра --output-format, переданного команде (доступен не для всех команд):
plain – простой текст, используется по умолчанию
csv – в формате CSV
 

Указание адресата

С помощью параметра --target можно указать целевую базу данных или экземпляр Astra.Historian, к которому будет применена команда.
 
Значение параметра должно иметь вид: [db@][host[:port]], где:
db – имя базы данных;
host – ip-адрес или сетевое имя компьютера с экземпляром Astra.Historian, если не указан – локальный компьютер;
port – порт интерфейса мониторинга Astra.Historian, если не указан – 4600.
 
Возможны следующие комбинации полей:
db@host:port – обращение к базе данных с именем db в экземпляре Astra.Historian, расположенном по адресу host:port;
db@host – обращение к базе данных с именем db в экземпляре Astra.Historian, расположенном по адресу host:4600;
db@ – обращение к базе данных с именем db локального экземпляра Astra.Historian;
host:port – обращение к экземпляру Astra.Historian, расположенном по адресу host:port;
host – обращение к экземпляру Astra.Historian, расположенному по адресу host:4600.