Консольное средство для управления сервером

Вы просматриваете версию 4.1. Для самой новой информации, перейдите на страницу Консольное средство для управления сервером для версии 5.0

This documentation page references Altium Concord Pro, which has been discontinued. All your PCB design, data management and collaboration needs can now be delivered by Altium Designer and a connected Altium 365 Workspace. Check out the FAQs page for more information.

 

Altium Concord Pro предоставляет консольное средство, предназначенное для следующих аспектов конфигурации:

  • Управление пользователями – позволяет в пакетном режиме предварительно загрузить на Altium Concord Pro настройки пользователей и ролей из систем и записей предприятия и таким образом избежать необходимости создания записей через веб-интерфейс Concord Pro по отдельности. Средство поддерживает импорт пользователей, ролей и данных о связи пользователей и ролей из стандартных файлов *.csv.
  • Индексация вариантов выбора компонентов – позволяет вручную провести переиндексацию вариантов выбора управляемых компонентов, полученных через пользовательские источники компонентов (подключения к локальным базам данных компонентов).

    Переиндексацию вариантов выбора компонентов можно настроить на автоматический запуск. Настройте ее с помощью поля Indexing part choices every при определении пользовательской базы данных компонентов. Источники компонентов определяются администратором Altium Concord Pro на странице Part Providers (Admin - Part Providers) веб-интерфейса Concord Pro. Для получения более подробной информации перейдите в раздел Настройка пользовательской базы данных компонентов.

Это средство, avconfiguration.exe, включено в состав установки Altium Concord Pro, и оно находится в папке \Program Files (x86)\Altium\Altium Concord Pro\Tools\VaultConfigurationTool.

Хотя данное средство можно использовать для автоматизированного управления пользователями, рекомендуемым подходом является использование функциональных возможностей LDAP-синхронизации.

Доступ к средству конфигурации

Для использования средства:

  1. Запустите командную строку Windows.
  2. Перейдите к корректной папке. Для установки по умолчанию на диск C хост-компьютера, это будет cd C:\Program Files (x86)\Altium\Altium Concord Pro\Tools\VaultConfigurationTool\.
  3. Для запуска средства и отображения списка доступных опций введите avconfiguration ?
В зависимости от операционной системы ПК сервера, скопированный текст можно вставить в командную строку с помощью контекстного меню, сочетания клавиш Ctrl+V или любым из этих двух способов.

Доступ к средству конфигурации через Командную строку.Доступ к средству конфигурации через Командную строку.

Обратите внимание, что при добавлении параметра ? будет отображена справка по функциям, доступным в средстве конфигурации:

  • usermanagement – импорт пользователей и ролей.
  • suppliers – индексация вариантов выбора компонентов.
  • help – отобразить экран справки (можно использовать ? вместо строки help).

Синтаксис и параметры функции usermanagement

Для функции usermanagement доступны следующие параметры:

avconfiguration usermanagement [-help | params [options]],

где доступными параметрами (params) являются:

  • --url – обязательно. Адрес и порт целевой инстанции Altium Concord Pro.
  • --user – обязательно. Имя пользователя (User Name), которое является частью учетных данных для доступа к Concord Pro.
  • --password – обязательно. Пароль (Password), который является частью учетных данных для доступа к Concord Pro (чувствителен к регистру).
  • --roles – имя файла, который содержит импортируемые роли.
  • --users – имя файла, который содержит импортируемые учетные записи пользователей.
  • --memberships – имя файла, который содержит импортируемые участия пользователей.
Путем поиска по умолчанию для файлов входных данных является текущая директория (где находятся файлы avconfiguration.exe). Если файл данных находится не в текущей директории, путь к файлу данных необходимо указать.

Доступными опциями (options) являются:

  • -d – удалить учетные записи пользователей и роли, которых нет в указанных файлах. Все существующие пользователи и роли в инстанции Altium Concord Pro, которых нет в указанных файлах, будут удалены (за исключением пользователей System и admin и роли Administrators).
  • -o – перезаписать существующие данные. Если пользователь существует в инстанции Altium Concord Pro и он приведен в импортируемом файле, то информация в инстанции Concord Pro будет перезаписана теми данными, которые содержатся в импортируемом файле.

Если ввести только avconfiguration usermanagement, будет приведен список этих параметров в качестве справки.

Параметры, доступные при использовании средства в режиме usermanagement.Параметры, доступные при использовании средства в режиме usermanagement.

Примеры файлов CSV

Пример каждого файла *.csv включен в директорию средства (\Program Files (x86)\Altium\Altium Concord Pro\Tools\VaultConfigurationTool). Описания содержимого файла каждого типа и требования показаны ниже.

users.csv

Содержит данные профилей пользователей.

Имя поля Описание Требования
FIRSTNAME Имя Необходимо (должен быть по крайней мере один символ)
LASTNAME Фамилия Необходимо (должен быть по крайней мере один символ)
USERNAME Имя пользователя Необходимо
PASSWORD Пароль Необходимо для встроенного ('Built In') режима аутентификации
PHONE Номер телефона  
AUTHTYPE Тип аутентификации Необходимо. 0 для встроенной ('Built In') аутентификации, 1 для доменной ('Windows') аутентификации
EMAIL Адрес электронной почты  
DOMAIN Доменное имя Необходимо для режима аутентификации 'Windows'.
  • Каждый пользователь должен быть определен на новой строке файла.
  • Никакие записи не будут импортированы в Altium Concord Pro, если в файле users.csv отсутствует какое-либо из обязательных полей.
  • Записи пользователей не будут импортированы, если существует ошибка в данных, например включен домен при некорректно заданном значении 0 параметра AUTHTYPE ('Built In').
  • Все поля, представленные в файле CSV, должны быть разделены запятыми. Данные для необязательных полей следует оставлять пустыми (например поле1,,поле2,...).
roles.csv

Содержит данные о ролях.

Имя поля Описание
ROLENAME Название роли (должен быть по крайнем мере один символ)
  • Каждая роль должна быть определена на новой строке файла.
memberships.csv

Содержит данные об участии пользователей в ролях (т.е. какой пользователь входит в какие роли)

Имя поля Описание
ROLENAME Название роли
USERNAME Имя пользователя
  • Каждая запись должна быть определена на новой строке файла.
  • Поля должны быть разделены запятыми.
  • Некорректные соответствия USERNAME–ROLENAME не пройдут, но корректные соответствия при этом будут импортированы.

Синтаксис и параметры функции suppliers

Для функции suppliers доступны следующие параметры:

avconfiguration suppliers [-help | params]

где доступными параметрами (params) являются:

  • --url – обязательно. Адрес и порт целевой инстанции Altium Concord Pro.
  • --user – обязательно. Имя пользователя (User Name), которое является частью учетных данных для доступа к Concord Pro.
  • --passwordMD5 – обязательно. Пароль (Password), который является частью учетных данных для доступа к Concord Pro в виде хеш-значения MD5.
  • --reindexPartChoice – обязательно. Имя (имена) поставщиков для начала индексации вариантов выбора компонентов. Это имя пользовательской базы данных Part Source, которая была настроена для подключения к локальной базе данных компонентов предприятия. Разделите множество поставщиков (Part Source) с помощью запятой. Обратите внимание, что поскольку запятая используется в качестве разделителя, она не должна содержаться в имени Part Source.
Источники компонентов определяются администратором Altium Concord Pro на странице Part Providers (Admin - Part Providers) веб-интерфейса Concord Pro. Для получения более подробной информации перейдите в раздел Настройка пользовательской базы данных компонентов.

Если ввести только avconfiguration suppliers, будет приведен список этих параметров в качестве справки.

Параметры, доступные при использовании средства в режиме suppliers.Параметры, доступные при использовании средства в режиме suppliers.

Пример возможной записи:

avconfiguration suppliers --url=http://localhost:9780 --user=admin --passwordMD5=21232f297a57a5a743894a0e4a801fc3 --reindexPartChoice=MySQLODBC,MsSQL

If you find an issue, select the text/image and pressCtrl + Enterto send us your feedback.
Content