Быстрый старт

Альтера разделена на несколько бинарных пакетов.

  • Основной — altera — предоставляет функции взаимодействия с модулями бекенда и авторизации действий в них через Polkit для непривилегированных пользователей. Достаточно установить только его, если клиентские утилиты умеют напрямую с ним общаться.
  • altera-cli устанавливается рядом с altera в том случае, если клиентские утилиты используют его для общения с основным процессом altera (пример — altera-sessions) или при необходимости тестирования altera в отсутствие каких-либо иных клиентских утилит.
  • Связанные бинарные пакеты altera-web и altera-sessions, которые требуют altera-cli и предоставляют функции подключения к altera с удалённых машин.

Для изучения всех возможностей altera рекомендуем установить эти четыре бинарных пакета вместе:

apt-get update
apt-get install altera altera-cli altera-web altera-sessions

systemctl enable altera --now
systemctl enable altera-sessions --now
systemctl enable altera-web --now

После этого вы сможете установить соединение с одним из установленных модулей старого альтератора или альтеры. Например, через клиентскую утилиту:

altera-cli /backend3/net-eth

Ввод ожидает запрос в виде json-сообщения. Пример: {"action": "list"}.

При наличии разрешающей политики Polkit или если вы запустили CLI от root, то вам придёт ответ от модуля бекенда.

Для завершения ввода отправьте exit отдельной строкой. CLI дождётся обработки уже отправленных запросов и закроется.

Вы можете открыть соединение, которое сможет одновременно работать с несколькими установленными модулями, таким образом:

altera-cli

Тогда альтера будет ожидать сообщения вида {"/backend3/net-eth": {"action": "list"}}, где ключом выступает путь к модулю бекенда, а значение — запросом к этому модулю.

Для явной остановки конкретного модуля в общем соединении отправьте {"/backend3/net-eth":"exit"}.

Или введите exit — CLI также дождётся обработки уже отправленных запросов и закроется.