Часто задаваемые вопросы по Altium On-Prem Enterprise Server

Общие сведения

Могу ли я использовать Altium On-Prem Enterprise Server для своих компонентов, но хранить проекты разработки локально?

Вы можете использовать Altium On-Prem Enterprise Server только для управления компонентами, но это не рекомендуется. Одна из сильнейших сторон Enterprise Server — управление повседневной работой над PCB «в процессе», включая данные проекта. При правильном использовании Enterprise Server создаёт связи между всем библиотечным и проектным содержимым, обеспечивая такие функции, как «Where-Used». Это крайне полезно при выявлении дубликатов или ошибочных компонентов, которые могли быть по ошибке использованы в одном или нескольких проектах.

Всё ли хранится локально?

Да, всё хранится локально. Всё находится за вашим файрволом, мы к этому не прикасаемся. Единственное, что может выходить в интернет — это данные по цепочке поставок, и даже их использование не является обязательным. Если вы хотите отправлять запросы в Digikey, Farnell и т. п., это и будет единственный тип интернет-доступа, который вам потребуется. Всё остальное — локально.

Могу ли я разместить Enterprise Server на виртуальной машине или где-то в Amazon AWS?

Да. Где будет размещён Enterprise Server — решаете вы и ваша IT-команда.

Если наша VPN-сеть медленная, как это повлияет на рабочий процесс?

Сам рабочий процесс может пострадать не сильно. При работе с библиотечными компонентами Workspace первоначальный просмотр и поиск могут быть немного медленными, но после кэширования данных станет проще. А с проектами: когда вы открываете проект Workspace, вы храните его и работаете с ним локально.

То есть повседневное использование Enterprise Server не должно сильно пострадать. Разумеется, более быстрый VPN был бы лучше, но нам говорили, что у некоторых VPN не очень быстрые, и всё равно это нормально работает, потому что нет постоянного взаимодействия с Enterprise Server.

Может ли пользователь без прав администратора изменить свои учётные данные доступа к Enterprise Server?

Да. Хотя управление пользователями для неадминистративного пользователя недоступно, он может изменить профиль своей учётной записи, если аутентификация этого пользователя выполняется с использованием встроенной службы аутентификации Enterprise Server — включая изменение имени пользователя и пароля. Это делается через окно Edit User, которое открывается нажатием на область активного пользователя в правом верхнем углу интерфейса браузера и выбором пункта Profile в соответствующем меню.

Могу ли я подключаться к нескольким Workspace Enterprise Server?

Одновременно вы можете быть «выполнен вход» только в один Workspace Enterprise Server, поскольку вы подключаетесь к платформе сервисов, а не к одному сервису Enterprise Server. Обычно у организации есть одна установка Enterprise Server. Однако если доступно более одного Enterprise Server, просто выйдите из одного и войдите в другой по мере необходимости.

Из Altium Designer вы по-прежнему можете sign in к устаревшему Altium Vault (Vault 2.0 to 3.0), Altium Concord Pro (снят с поддержки), Altium NEXUS Server (снят с поддержки) или connect к устаревшему Altium Personal Vault:

• Altium Vault/Altium Concord Pro/Altium NEXUS Server - выйдите из активного сервера, затем используйте диалог Sign in, чтобы sign in к целевому серверу.
• Altium Personal Vault - выйдите из активного сервера, затем используйте диалог Sign in, чтобы connect к Personal Vault. Помните, что для Personal Vault вы выполняете подключение, а не вход — поэтому после успешного подключения к такому хранилищу интерфейс Altium Designer не будет показывать, что вы вошли на какой-либо сервер.

После входа/подключения к целевому объекту он будет отображаться в области Known Servers на странице Data Management - Servers page диалога Preferences в Altium Designer.

Я всё ещё хочу использовать Altium Personal Vault — это возможно?

Безусловно. Если на том же ПК запущена предыдущая разновидность сервера, убедитесь, что порты связи не совпадают. Enterprise Server использует порт по умолчанию 9780 (такой же, как у его предшественников Altium Concord Pro/Altium NEXUS Server/Altium Vault ), а Altium Personal Vault использует порт по умолчанию 9680.

Чтобы сделать Personal Vault «Known Server» в Altium Designer — на странице Data Management - Servers page диалога Preferences — выйдите из активного сервера, затем используйте диалог Sign in, чтобы подключиться к Personal Vault. Помните, что для Personal Vault вы выполняете подключение, а не вход — поэтому после успешного подключения к такому хранилищу интерфейс Altium Designer не будет показывать, что вы вошли на какой-либо сервер. Затем вы можете снова войти на сервер, который был активен ранее, продолжая при этом пользоваться подключением к вашему Personal Vault.

Я не могу войти в Enterprise Server — вместо этого получаю сообщение об ошибке об отсутствующих DLL. Что делать?

Для успешной работы и доступа Enterprise Server использует ряд компонентов среды выполнения Microsoft; в некоторых случаях их может не быть на целевой машине. Если при попытке входа в Enterprise Server вы получаете сообщение об ошибке об отсутствующей библиотеке (DLL), это означает, что отсутствуют компоненты среды выполнения Microsoft. Скачайте и установите соответствующий пакет Microsoft Visual C++ Redistributable Package для вашей ОС.

При попытке входа в Enterprise Server я получаю сообщение об ошибке «HTTP Error 503. The service is unavailable». Что делать?

Эта ошибка может возникать, когда Enterprise Server установлен на компьютере, на котором также работает Microsoft Exchange Server. Установка Exchange Server может изменить конфигурацию Internet Information Services (IIS) таким образом, что она конфликтует с Enterprise Server.

Чтобы устранить проблему, необходимо внести следующие изменения в файл applicationHost.config:

<handlers accessPolicy="Read, Script">
...

<add name="kerbauth" image="C:\Program Files\Microsoft\Exchange Server\V15\Bin\kerbauth.dll" preCondition="bitness64" />
<add name="WSMan" image="C:\Windows\system32\wsmsvc.dll" preCondition="bitness64" />
<add name="exppw" image="C:\Program Files\Microsoft\Exchange Server\V15\ClientAccess\Owa\auth\exppw.dll" preCondition="bitness64" />
<add name="cafe_exppw" image="C:\Program Files\Microsoft\Exchange Server\V15\FrontEnd\HttpProxy\bin\exppw.dll"  preCondition="bitness64" />

...
</handlers>

Сведения о файле ApplicationHost.config см. в this article.

Сведения о редактировании файла см. в this article.

Лицензирование

Какие лицензии требуются?

Лицензирование Enterprise Server состоит из двух компонентов:

• Server License - включает полный набор сервисов Enterprise Server для вашей организации. Требуется одна серверная лицензия на организацию.
• Client Access License - предоставляет пользователям доступ к функциональности Enterprise Server. Требуется одна лицензия Client на каждого пользователя, обращающегося к сервисам Enterprise Server.

Нужно ли обновлять лицензии, если я обновляю существующую установку Enterprise Server до более поздней версии?

Да, пожалуйста, убедитесь, что вы обновили лицензирование Enterprise Server. На странице Admin - Licenses в браузерном интерфейсе Workspace Enterprise Server удалите существующие лицензии (Altium Enterprise Server и Altium Enterprise Server CAL), а затем добавьте их заново. Это обеспечит актуальные лицензии с учётом любых изменений лицензирования и связанных с ним функций в более поздней версии Enterprise Server.

Нам не хватает подключений для нашей установки Enterprise Server — что можно сделать?

Через браузерный интерфейс Workspace Enterprise Server администратор может завершить сессию пользователя, принудительно освободив подключение. Это выполняется на странице Sessions page интерфейса.

Либо, что является гораздо лучшим долгосрочным решением, просто добавьте больше мест (подключений), приобретя дополнительные Client Access Licenses (Altium Enterprise Server CAL).

Управление компонентами

Компонент библиотеки Workspace — это то же самое, что Unified Component?

И да, и нет. Всё зависит от того, определены ли для компонента библиотеки Workspace связанные Part Choices. Когда компонент создан и выпущен, и его называют компонентом библиотеки Workspace, он представляет собой инженерное или проектное представление этого компонента. По сути, это контейнер, в котором хранится вся информация, используемая для моделирования компонента в Design Area. Сюда входят ссылки на все необходимые доменные модели (условное графическое обозначение, PCB 2D/3D-компонент, Sim и т. д.), а также параметрическая информация. Для разработчика, использующего его в проекте платы, он имеет большое значение, но вне среды проектирования он не имеет смысла. Чтобы стать действительно «Unified Component», объединяющим области Design и Supply Chain, компонент должен быть сопоставлен с физическими, реальными производимыми деталями. Это делается путём задания Part Choices для компонента.

И именно это интеллектуальное сопоставление компонента — из традиционной области проектирования электроники в более широкую «продуктовую область», как её видит остальная часть организации — превращает обычный компонент библиотеки Workspace в настоящий Unified Component!

Что делать, если у меня уже есть большие библиотеки?

Altium Designer в сочетании с Workspace Enterprise Server предоставляет упрощённый и удобный процесс, позволяющий быстро импортировать существующие библиотеки в Workspace — Library Importer. Графический интерфейс этого процесса предлагает интуитивно понятный сценарий: выбранные на первом шаге библиотеки импортируются в ваш экземпляр Enterprise Server. Поддерживаются все типы библиотек, относящиеся к более старым методологиям управления компонентами — SCHLIB, PCBLIB, INTLIB, DBLIB, SVNDBLIB — поэтому Library Importer является идеальным решением для быстрого формирования корпоративного набора компонентов библиотек Workspace и получения всех преимуществ таких компонентов (высокая целостность, управление жизненным циклом, централизованное хранение и администрирование, функция where-used, удобство повторного использования в проектах).

Library Importer предлагает минималистичный режим интерфейса Simple, в котором выбранные файловые библиотеки компонентов импортируются в компоненты библиотек Workspace за один шаг, при этом импортёр автоматически выполняет классификацию по типам, выбирает целевую папку-источник, добавляет параметры и их типы значений, а также переносит все релевантные данные. Интерфейс также доступен в режиме Advanced, который предоставляет полный предварительный просмотр предполагаемого импорта библиотеки и доступ к связанным данным и настройкам. И хотя по умолчанию импорт выполняется одним щелчком, импортёр также предлагает расширенные параметры конфигурации через панель Properties panel, обеспечивая более точный контроль над тем, как именно выполняется импорт.

Вся информация, присутствующая в исходной библиотеке, импортируется в компоненты библиотек Workspace, включая все связанные доменные модели (условные графические обозначения, посадочные места PCB, модели симуляции), параметрические данные, назначенные варианты Part Choices, файлы даташитов и т. д. При необходимости также создаются Component Templates, которые затем можно доработать и использовать для последующих импортов библиотек. Если в исходных компонентах определено несколько посадочных мест PCB, Library Importer перенесёт эти модели и сохранит текущее посадочное место по умолчанию. А если вы работаете только с PCB-библиотеками — и вас интересует лишь разводка платы — то Library Importer поддерживает импорт только таких библиотек, либо его можно переключить в режим импорта только моделей, когда указанные типы моделей импортируются из Integrated или Database библиотек. Библиотеки, включающие несколько типов компонентов (монолитные библиотеки), также автоматически обнаруживаются и обрабатываются.

Можно ли ограничить круг пользователей, которые могут изменять компоненты в Workspace Enterprise Server?

Да, можно задать разные права доступа — кто и что может делать. Вы можете создать роль библиотекаря, а также указать, кто может или не может читать (иметь доступ) к любой папке. Можно даже создать «песочницу» (sandbox) — папку, к которой имеют доступ некоторые инженеры, если они хотят создавать собственные компоненты, а затем официально выпущенные компоненты размещать в другой папке, доступной всем. То есть всё очень хорошо контролируется.

Есть ли способ скачать «снимок» компонентов библиотек Workspace на случай, если ИТ-инфраструктура будет недоступна?

Нет, в настоящее время нет способа получить локальный образ Enterprise Server.

При использовании панели Components данные компонентов библиотек Workspace кэшируются с Workspace на локальную машину. Это обеспечивает офлайн-доступ к компонентам библиотек Workspace, когда Altium Designer не подключён к Enterprise Server, и, следовательно, позволяет выполнять обычный просмотр и размещение компонентов и т. п. Обратите внимание, что Filters в этом режиме не включены.

Это состояние обозначается предупреждающим текстом «Offline mode – cached data is being used» в нижней части панели, в области списка компонентов.

Можно ли сделать локальную библиотеку из Enterprise Server?

Да, в Content Cart есть функция, позволяющая получить компоненты из вашего локального Enterprise Server в Integrated Library (*.IntLib). При размещении компонентов из такой Integrated Library фактические ссылки ведут обратно на Component Items в Enterprise Server. Это даёт возможность эффективно использовать корпоративные компоненты библиотек Workspace в офлайн-режиме, при этом гарантируя, что проект сохраняет реальную связь с этими компонентами в исходном Enterprise Server.

Управление проектами

Зависит ли функциональность Where-Used от того, что проекты были закоммичены в локальную службу Version Control Enterprise Server?

Enterprise Server должен «знать» о существовании репозитория проекта, в котором хранится ваш дизайн.

Новая установка Enterprise Server предоставляет один Git-репозиторий для размещения всех ваших проектов Workspace — и всё! Это исключает настройку и сложность, связанные с локальной службой Version Control Enterprise Server. У вас один репозиторий проектов — Versioned Storage — к которому все разработчики могут получать доступ и в который могут выполнять release. Таким образом, страница VCS в браузерном интерфейсе Enterprise Server становится чисто информационной — вы не можете добавить новый репозиторий, а единственный Git-репозиторий нельзя каким-либо образом изменить или удалить. Функциональность where-used изначально поддерживается встроенным Git-репозиторием Enterprise Server.

Если вы обновили Enterprise Server с Altium NEXUS Server 1.0 (или Altium Vault 3.0), то также будет включена поддержка SVN-репозиториев, чтобы вы могли продолжать использовать прежний (и уже отлаженный) процесс разработки. В этом случае вы можете продолжать создавать репозитории через локальную службу Version Control (только SVN) или подключаться к внешним репозиториям (SVN или Git). Поэтому, если вам нужно, чтобы репозиторий проекта находился на другом сервере или что-то подобное, вы можете сделать это через внешний репозиторий — настроив его в Enterprise Server так, чтобы Enterprise Server знал, где он расположен. После этого вы сможете использовать функциональность Where-Used.

Если я вношу изменения в компонент, можно ли сделать их только локальными для проекта?

Да, это возможно. Локальные изменения в проекте — часть базовой функциональности Altium Designer. Однако это не рекомендуется. Если вы позже обновите этот компонент, используя одну из функций обновления в Altium Designer, будет подтянута следующая ревизия из Enterprise Server, которая перезапишет любые локальные изменения. Поэтому гораздо лучше вносить изменения в компоненты библиотек Workspace напрямую в Enterprise Server.

Могу ли я контролировать, какие нарушения правил проектирования должны быть пройдены перед коммитом любой ревизии в Enterprise Server?

Да, и всё это настраивается через файл Output Job Configuration. Этап Validate Project процесса release process запускается автоматически, когда в назначенных OutJob-файлах обнаруживаются один или несколько отчётов типа Validation. Запускаются все определённые генераторы выходных данных валидации, заданные в Output Job файле, назначенном выпускаемому элементу данных. Это включает выполнение любого из следующих пунктов:

• Differences Report – использование компаратора для определения, корректно ли синхронизированы исходные документы и документы PCB.
• Electrical Rules Check – проверка электрической/чертёжной корректности захваченного исходного проекта.
• Design Rules Check – проверка корректности документа PCB относительно заданных ограничений проектирования на уровне платы.
• BOM Checks - проверка возможных нарушений, связанных с Design Items или Part Choices в исходном документе BOM (*.BomDoc), если доступно.
• Footprint Comparison Report – сравнение посадочных мест на плате с их исходной библиотекой, чтобы убедиться, что они актуальны и совпадают.
• Component State Checking - проверка компонентов, находящихся в ограниченных состояниях. В рамках конфигурации вы определяете действие для каждого текущего состояния каждой текущей Lifecycle Definition в целевом Enterprise Server: не выполнять действий, выдать предупреждение или сформировать ошибку. Последний вариант предотвратит выпуск (release) проекта. Кроме того, выполнение проверки сформирует удобный HTML-отчёт, позволяющий с первого взгляда увидеть, какие компоненты проекта находятся в недопустимых состояниях.
• Environment Configuration Compliance Check – проверка того, что используются только те элементы данных, которые разрешены конфигурацией среды для вашей назначенной роли (если применимо). Эта проверка также может гарантировать, что все элементы проекта берутся из Enterprise Server.

Может ли Enterprise Server предотвращать коммиты, если определённые проверки валидации через Output Job файл не пройдены?

Да, если шаги валидации не пройдены, то коммит и выпуск данных в Enterprise Server не произойдут.

Могу ли я импортировать существующие проекты в Enterprise Server?

Вы можете перенести существующие проекты в ваш Enterprise Server, но в настоящее время нельзя перенести существующий subversion-репозиторий. Если вы хотите перенести данные проекта, их нужно извлечь и заново закоммитить в соответствующий репозиторий в Enterprise Server. То есть вы фактически потеряете историю этих проектов и по сути начнёте заново, но сами данные можно выгрузить и загрузить обратно.

Вы также можете преобразовать свои компоненты из старых методологий управления компонентами в компоненты библиотек Workspace, используя возможности автоматического сопоставления, предоставляемые мощным Item Manager.