Exponenta Banner
exponenta event banner

admin-docker-agent

(DOS/UNIX) интерфейс Launch Cluster Admin, чтобы управлять Диспетчером пользователей, Системой отслеживания ошибок и Polyspace доступ к Приложениям

свернуть все на странице

Синтаксис

admin-docker-agent [OPTIONS]

Описание

пример

admin-docker-agent [OPTIONS] запускает интерфейс Cluster Admin. Если вы не задаете дополнительный OPTIONS, агент Администратора использует имя хоста localhost и запускается с HTTP протокол на порте 9443.

Входные параметры

свернуть все

Опции, чтобы задать и справиться с настройками подключения Cluster Admin.

Общие опции

ОпцияОписание

--hostname hostName

Задайте полностью определенное доменное имя машины, на которой вы запускаете Cluster Admin. Эта опция требуется, если вы используете параметры конфигурации HTTPS. hostName должен совпадать с Common Name (CN) то, что вы задаете, чтобы получить сертификаты SSL.

Именем хоста по умолчанию является localhost.

--port portNumber

Задайте номер порта сервера, который вы используете, чтобы получить доступ к веб-интерфейсу Cluster Admin.

Значение порта по умолчанию 9443.

--data-dir dirPath

Задайте полный путь к папке, содержащей settings.json файл.

Если файл не существует, Cluster Admin создает его в заданной папке.

Если файл уже существует, Cluster Admin снова использует свое содержимое, чтобы сконфигурировать настройки.

Папка по умолчанию является текущей папкой.

--network-name networkName

Задайте имя сети Docker, которую использует Polyspace доступ, Диспетчер пользователей и приложения Системы отслеживания ошибок.

Используйте эту опцию, если вы не хотите, чтобы приложения использовали mathworks по умолчанию сеть, например, если та сеть конфликтует с существующей сетью.

Чтобы проверять если ваши конфликты сети докера с существующей сетью, запустите эту команду:

docker network inspect networkName
и смотрите IPAM.Config узел, чтобы просмотреть область значений IP, которая используется сетью. Вы можете должны быть связаться со своим администратором сети, чтобы определить, используется ли область значений IP другими сервисами. Найти networkName, используйте команду docker network ls.

Чтобы создать новую сеть, смотрите, что сеть докера создает.

--force-exposing-ports

Задайте эту опцию, чтобы осушить порты сервисов, когда вы установите все сервисы на один узел. Чтобы задать серверный порт Докера, с которым осушенные порты связывают, откройте Cluster Admin, нажмите Configure Nodes, затем перейдите к вкладке Services.

По умолчанию, когда вы устанавливаете на одном узле, порты сервисов не осушены.

Используйте эту опцию, если вы устанавливаете на одном узле, но необходимо связаться с одним из сервисов через сторонний инструмент, например, если вы используете утилиты PostgreSQL, чтобы связаться с базой данных Access Polyspace.

--reset-passwordИзмените пароль, который вы используете, чтобы регистрировать в веб-интерфейс Cluster Admin.
--versionОтобразите номер версии агента Администратора.
--helpОтобразите меню справки.

Параметры конфигурации HTTPS

На Windows® системы, все пути должны указать на локальные диски.

ОпцияОписание

--ssl-cert-file absolutePath

Задайте абсолютный путь к сертификату SSL PEM файл.

--ssl-key-file absolutePath

Задайте абсолютный путь к закрытому ключу SSL PEM файл, что вы раньше генерировали сертификат.

--ssl-ca-file absolutePath

Задайте полный путь к хранилищу сертификатов, где вы храните доверенные центры сертификации. Например, на Linux® Debian® распределение, /etc/ssl/certs/ca-certificates.crt .

Если вы используете самоподписанные сертификаты, используйте тот же файл, который вы задаете для --ssl-cert-file

--restart-gateway

Используйте эту опцию, чтобы перезапустить сервис Gateway, если вы перезапускаете admin-docker-agent и вы вносите изменения в параметры конфигурации HTTPS, или вы задаете различный порт.

Перезапустите сервис Gateway при помощи этой опции, если вы вносите изменения в параметры конфигурации HTTPS или задаете различный порт.

Новые параметры конфигурации узла

Если вы принимаете решение установить Polyspace® Доступ на нескольких машинах, используйте эти опции, чтобы создать узлы на различных машинах. В Cluster Dashboard нажмите Configure Nodes, и затем выберите вкладку Services, чтобы выбрать узел, на который вы хотите запустить сервис.

Прежде чем вы создадите узел, у вас должен быть экземпляр admin-docker-agent уже работая, по крайней мере, на еще одной машине. Эта другая машина размещает master узел.

ОпцияОписание

--master-host hostName:port

Задайте имя хоста и номер порта машины, размещающей master узел.

--node-id nodeName

Имя узла, который вы создаете. После того, как вы запустите Cluster Admin, вы видите этот узел, перечисленный в Node выпадающие списки на вкладке Services настроек Nodes.

Примеры

свернуть все

Cluster Admin использует протокол HTTP по умолчанию. Зашифруйте данные между Cluster Admin и клиентскими машинами путем конфигурирования Cluster Admin с протоколом HTTPS. Эта настройка также включает HTTPS для сервиса Шлюза API, который обрабатывает связи между всеми другими сервисами и клиентскими машинами.

Если вы устанавливаете Polyspace доступ на нескольких узлах, или если вы используете --force-exposing-ports чтобы запустить агента Admin, необходимо сконфигурировать HTTPS для Диспетчера пользователей, Системы отслеживания ошибок и Служб доступа Polyspace отдельно. Чтобы сконфигурировать HTTPS для сервисов, нажмите Configure Nodes на Cluster Dashboard.

Создайте самоподписанный сертификат SSL и файл секретных ключей при помощи openssl инструментарий. 

openssl req -newkey rsa:2048 -new -nodes -x509 -days 365 -keyout self_key.pem -out self_cert.pem
После того, как вы вводите команду, следуете за подсказками на экране. Можно оставить больше всего незаполненные поля, но необходимо обеспечить Common Name CN . CN должен совпадать с полностью определенным доменным именем (FQDN) машины, запускающей admin-docker-agent. Команда выводит файл сертификата self_cert.pem и файл секретных ключей self_key.pem.

Чтобы получить FQDN машины, используйте команду hostname --fqdn на Linux или net config workstation | findstr /C:"Full Computer name" на Windows.

Запустите admin-docker-agent при помощи сертификата и файлов секретных ключей, что вы сгенерировали и задаете hostName, FQDN машины. hostName должен совпадать с FQDN, что вы ввели для CN сертификата SSL. В команде задайте полный путь к файлам.

Windows PowerShell 
admin-docker-agent --hostname hostName`
--ssl-cert-file fullPathTo\self_cert.pem `
--ssl-key-file fullPathTo\self_key.pem.pem `
--ssl-ca-file fullPathTo\self_cert.pem
Linux 
./admin-docker-agent --hostname hostName \
--ssl-cert-file fullPathTo/self_cert.pem \
--ssl-key-file fullPathTo/self_key.pem.pem \
--ssl-ca-file fullPathTo/self_cert.pem

Можно теперь получить доступ к веб-интерфейсу Cluster Admin от браузера при помощи https://hostName:9443/admin.

Смотрите также

Темы

Введенный в R2020b

Документация Polyspace Bug Finder

Поддержка