Search In: Doc:Documentation: Altium On-Prem Enterprise Server
Altium DesignerAltium 365Altium MCAD CoDesignerAltium On-Prem Enterprise ServerCompany DashboardAltium Infrastructure ServerAltium Developer Center
Ver: Version: 5.5
8.18.07.27.17.06.05.5
Close
Поиск Search on Documentation

Информация для ИТ-отделов

Updated: декабря 20, 2022 | Applies to version: 5.5
Вы просматриваете версию 5.5. Для самой новой информации, перейдите на страницу Информация для ИТ-отделов для версии 8.1
 

Parent page: Расширенные темы

Хотя установка и использование Altium On-Prem Enterprise Server и связанных с ним служб подробно описаны на других страницах этого сайта документации, цель данной страницы — предоставить единый подробный ресурс для ИТ-отдела организации. Место, где можно найти ответы на часто задаваемые вопросы по этой технологии, включая:

  • What are the hardware requirements to install the Enterprise Server?
  • What is installed?
  • What programs and processes are running?
  • Where is the data stored?
  • What ports are used?
  • What protocol is used for communications?
  • How is data backed up?

Следующие разделы содержат подробные ответы на эти и другие вопросы, включая обзор архитектуры и потоков данных на высоком уровне.

Требования к оборудованию

Enterprise Server следует устанавливать на ПК под управлением одной из следующих официально поддерживаемых операционных систем:

  • Windows Server 2022 Standard Edition (64-bit)
  • Windows Server 2019 Standard Edition (64-bit)
  • Windows Server 2016 Standard Edition (64-bit)
  • Enterprise Server нельзя установить на ПК с 32-битной ОС, а также на 64-битную ОС, которая не поддерживает Windows Authentication (редакции Core, Home, Starter и Base). Ниже приведено краткое резюме поддерживаемых операционных систем:
    • Officially Supported: Windows Server 2022 Standard Edition 64-bit (рекомендуется), Windows Server 2019 Standard Edition 64-bit, Windows Server 2016 Standard Edition 64-bit (минимум).
    • Recommended only for Evaluation: Windows 10 64-bit, Windows 8.1 64-bit — редакции Ultimate или Professional для вариантов ОС, не являющихся серверными.
  • Для корректной работы и доступа Enterprise Server использует ряд компонентов среды выполнения Microsoft; в некоторых случаях они могут отсутствовать на целевой машине. Если при попытке подключиться к anEnterprise Server вы получаете сообщение об ошибке об отсутствующей библиотеке (DLL), это означает, что отсутствуют компоненты среды выполнения Microsoft. Скачайте и установите соответствующий пакет Microsoft Visual C++ Redistributable Package для вашей ОС.

Требования Altium Designer 

Убедитесь, что вы используете Altium Designer 22.8.2 (build 66) или более позднюю версию. Чтобы получить полный доступ и в полной мере использовать функции и технологии, которые постоянно разрабатываются для Altium On-Prem Enterprise Server, связаны с ним и устанавливаются вместе с ним, рекомендуется иметь последнюю версию Altium Designer.

Установка и другое ПО

Из‑за наблюдаемого непредсказуемого поведения антивирусного ПО рекомендуется отключать такое ПО на время установки Enterprise Server.

Если на компьютере также установлен Microsoft Exchange Server, при первой попытке входа вы можете получить ошибку HTTP Error 503. Установка 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 см. в этой статье. Сведения о редактировании файла см. в этой статье.

Дополнительное ПО, устанавливаемое или настраиваемое

  • Internet Information Services (IIS). Для корректной работы Enterprise Server требуется, как минимум, версия 8.0 (IIS 8.0) . Установка Enterprise Server просто установит версию IIS, встроенную в вашу операционную систему:
    • IIS 10.0 – Windows Server 2022 Standard Edition (64-bit), Windows Server 2019 Standard Edition (64-bit), Windows Server 2016 Standard Edition (64-bit), Windows 10 (64-bit)
    • IIS 8.5 – Windows 8.1 (64-bit)
  • СУБД Firebird 3.0 (если выбран вариант установки с базой данных Firebird). Убедитесь, что включена IPv4-адресация — чтобы проверить активные IPv4-адреса, выполните ipconfig /all в командной строке.
  • .NET Framework 4.8 и .NET Core 3.1.2

Конфигурация IIS

В рамках настройки IIS включается функция ISAPI Extensions. Эту функцию можно найти в разделе \Internet Information Services\World Wide Web Services\Application Development Features диалогового окна Windows Features — доступ к нему осуществляется из окна Windows Programs and Features.

Установка Enterprise Server включает функцию Windows ISAPI Extensions, являющуюся частью конфигурации IIS.
Установка Enterprise Server включает функцию Windows ISAPI Extensions, являющуюся частью конфигурации IIS.

Пути установки по умолчанию

Ниже приведён список путей установки по умолчанию при установке Enterprise Server:

  • Enterprise Server Installation Folder – \Program Files (x86)\Altium\Altium365.
  • Firebird Installation Folder – \Program Files (x86)\Firebird\Firebird_3_0.
  • Firebird Database – \ProgramData\Altium\Altium365Data\DXPSERVER.DAT.
  • Revision Files Folder – \Altium\Altium365Data\Revisions. \ProgramData
  • Search Index Data Folder – \Altium\Altium365Data\SearchData. \ProgramData

Порты по умолчанию

Enterprise Server использует следующие номера портов связи по умолчанию:

  • HTTP Port – 9780
  • HTTPS Port – 9785
  • LDAP Service Port – 9791
Порт службы LDAP фактически не используется. Для стандартного LDAP (с URL 'ldap://') используется порт из этого URL. Для защищённого LDAP (с URL 'ldaps://') используется порт 636.
  • Websocket Port – 4649
  • Firebird Server Port – 3050
  • SVN Port – 3690

Первые три пункта в списке можно настроить во время первоначальной установки на странице Altium On-Prem Enterprise Server Configuration установщика.

Если порт уже занят, установщик найдёт следующий доступный и будет использовать его.

При выборе порта учитывайте, что он не должен конфликтовать с какими-либо портами, используемыми другими приложениями — если порт уже используется, установщик уведомит вас.

HTTP Port обслуживается IIS и используется приложениями Enterprise Server. Это основной порт, и он всегда должен быть открыт. Firebird Server Port используется для Firebird RDBMS. По умолчанию он привязан только к localhost. По соображениям безопасности его SHOULD NOT следует открывать наружу. Пользователи не взаимодействуют с этим портом напрямую. Оба порта обеспечивают обычное HTTP-взаимодействие (запрос/ответ). Оба порта можно настроить. HTTP Port можно изменить во время установки. Хотя Firebird Server Port можно изменить вручную, делать это не рекомендуется.
Что касается порта HTTP-коммуникаций: если на том же ПК работает устаревшая технология Vault (Altium Personal Vault или Altium Satellite Vault), убедитесь, что порты связи уникальны. Устаревший Altium Personal Vault использует порт 9680, а устаревший Altium Satellite Vault — порт 9880. Enterprise Server нельзя установить рядом с устаревшим Altium Vault (3.0 и более ранние версии), Altium Concord Pro, Altium NEXUS Server, или Altium Infrastructure Server (т. е. на том же ПК). В случае первых трёх вы можете выполнить обновление до Enterprise Server (как при обновлении до более поздней версии соответствующего продукта).

► См. информацию о портах и IP-адресах для ПО Altium Design.

Поддержка протокола HTTPS

Для тех, кому требуется дополнительный уровень безопасности при обмене данными с Enterprise Server, Enterprise Server обеспечивает защищённую связь по сети с использованием протокола HTTPS для защиты конфиденциальности и целостности данных.

Номер порта, используемого для защищённых подключений к серверу, задаётся в процессе установки на странице Altium On-Prem Enterprise Server Configuration установщика. Используйте порт по умолчанию (9785) или укажите альтернативный.

Доступ к конфигурации и привязкам сервера Enterprise Server можно получить из панели Windows Internet Information Services (IIS) Manager — доступной из окна Administration Tools (Control Panel\System and Security\Administrative Tools). Выберите запись 'Altium On-Prem Enterprise Server' в списке Connections панели и откройте вкладку Features View.

Доступ к настройкам конфигурации и привязок сервера Enterprise Server.
Доступ к настройкам конфигурации и привязок сервера Enterprise Server.

Доступные порты и имена серверов для Enterprise Server отображаются в виде выбираемых ссылок в области Actions. Используйте ссылки, чтобы посмотреть и проверить протоколы подключения к серверу, либо получить доступ к текущим привязкам имени/порта, выбрав ссылку Bindings в разделе Edit Site области.

Привязку, включая номер порта протокола, можно отредактировать в диалоговом окне Site Bindings с помощью кнопки Edit .

Настройка привязок через диалоговое окно Site Bindings.
Настройка привязок через диалоговое окно Site Bindings.

Обратите внимание: имя сервера localhost применяется только к локальной машине, поэтому ПК other, отличные от того, на котором размещён Enterprise Server, должны использовать фактическое (серверное) имя хост-машины для подключения.

Чтобы подтвердить имя хост‑ПК, на котором установлен и запущен Enterprise Server, на этой машине перейдите в Control Panel\System and Security\System и запишите и Computer name, и Full computer name (его полное доменное имя, FQDN) — именно последнее будет использоваться Enterprise Server для защищённых подключений по сети.

Для ПК, которые не входят в домен (настроены как стандартные ПК рабочей группы), Computer name и Full computer name будут одинаковыми.

Если вы отредактировали привязки сайта (site bindings) Enterprise Server так, чтобы использовать номер порта, отличный от значения по умолчанию, это изменение также нужно отразить в файле LocalVault.ini Enterprise Server. Это связано с тем, что ссылки на порт используются при подключениях к Enterprise Server из Altium Designer. Файл LocalVault.ini находится в корневой папке установки Enterprise Server — обычно Program Files (x86)\Altium\Altium365.

Например, если вы изменили привязку сайта Enterprise Server так, чтобы использовать стандартный порт 443 для HTTPS‑подключений, обновите соответствующую строку HttpsPort=9785 в файле LocalVault.ini на HttpsPort=443.

Чтобы установить защищённое подключение к Enterprise Server:

  • Из Altium Designer — используйте адрес сервера с префиксом HTTPS и настроенный HTTPS‑порт. По умолчанию это https://localhost:9785 при использовании ПК, на котором размещён Enterprise Server, или https://<computername>:9785 для удалённого подключения (где [computername] — это имя компьютера хост‑машины или её полное доменное имя).
Altium Designer включает необходимую поддержку безопасности, чтобы принимать HTTPS‑подключение к Enterprise Server без вмешательства пользователя.
  • Из браузера — введите адрес локальной службы (https://localhost:9785) или эквивалент с именем хост‑компьютера (https://<computername>:9785).
В настоящее время Enterprise Server предоставляет самоподписанный сертификат идентификации (Identity Certificate) для защищённых подключений; вы можете принять его в браузере, чтобы продолжить. Некоторые браузеры (например, Firefox) предлагают возможность принять сертификат навсегда, чтобы дальнейшие действия не требовались.

При перенастройке привязок сайта

Если вы добавили новую привязку IIS Site Binding для Enterprise Server или отредактировали существующую запись Site Binding (см. выше), ПК сервера следует перезагрузить, чтобы корректно применить новую конфигурацию. Типичные изменения Site Binding — это редактирование номера порта для записи хоста или добавление новой привязки для доменного псевдонима.

Когда перезагрузка хост‑машины сервера непрактична, альтернативный процесс — перезапустить службу сервера на платформе IIS — Restart в разделе Manage Website — а также перезапустить службу Altium DXP App Server Pinger (служба Windows).

Выполните описанный выше процесс запуска, если при попытке запустить функцию Health Monitor Enterprise Server вы получаете сообщение об ошибке «SignalR Hub "healthmonitorHub" not found!».

Протокол, используемый для межсервисных коммуникаций (Service-to-Service Communications)

SOAP поверх HTTP.

Архитектура служб — обзор

Enterprise Server устанавливает ряд базовых служб, а также браузерные консоли управления и Explorer (также браузерный). Чтобы получить доступ к любой из этих служб, личность пользователя должна быть распознана и аутентифицирована. Enterprise Server поставляется с одним предопределённым пользователем (Username: admin, Password: admin). Страница Users браузерного интерфейса Workspace Enterprise Server может использоваться для добавления и управления другими пользователями. Ограничений на количество пользователей, которые могут быть зарегистрированы для доступа и использования Enterprise Server, нет, но есть ограничение на число одновременных подключений, определяемое и обеспечиваемое требуемым лицензированием.

Один и тот же пользователь может одновременно обращаться к Enterprise Server разными способами (например, подключён через Altium Designer AND и открыт через внешний браузер), и с точки зрения лицензирования это считается одним подключением, если доступ выполняется с одного и того же ПК. Если тот же пользователь обращается к Enterprise Server с разных ПК, каждый доступ с другого ПК потребует отдельного подключения (то есть дополнительного места Connector Access License).

Altium Designer использует незашифрованный канал (SOAP поверх HTTP) для связи со следующими службами:

  • Applications Registry Service (когда Network Installation Service используется как источник расширений/обновлений)
  • Collaboration Service
  • Comments Service
  • Data Acquisition Service
  • Data Storage Service (DSS)
  • Identity Service (IDS)
  • Notifications Service
  • Part Catalog Service
  • Projects Service
  • Simple Lock Service (SLS)
  • SVN (через протокол SVN://)
  • Tasks Service
  • Team Configuration Service (TC2)
  • Vault Service

Все остальные службы обмениваются данными друг с другом.

Большинству служб требуется доступ к одной и той же базе данных Enterprise Server, чтобы хранить относящиеся к ним данные. Ниже приведены примеры данных, которые хранят некоторые из этих служб:

  • Part Catalog Service – хранит позиции поставщиков и производителей, историю изменений цен и количества и т. п.
  • Identity Service – хранит пользователей, роли, конфигурацию лицензирования и информацию о сессиях.
  • Vault Service – хранит свою структуру (папки, элементы, ревизии, типы контента, состояния жизненного цикла и т. п.).

Фактические документы хранятся в файловой системе, в папке Revisions (\Altium\Altium365Data\Revisions). \ProgramData

Службе Part Catalog Service также требуется прямое подключение (без прокси) к Интернету для обновления цен в реальном времени.

Следующие браузерные приложения используют SOAP API для взаимодействия с соответствующими службами — им не требуется доступ к базе данных Enterprise Server, и для их работы не нужны какие-либо другие файлы:

  • User Management – приложение, стоящее за страницей Users и подстраницами в браузерном интерфейсе Workspace Enterprise Server.
  • Vault Explorer – приложение, стоящее за страницей Explorer браузерного интерфейса Workspace Enterprise Server.
  • Catalog Management – приложение, стоящее за страницей Part Providers браузерного интерфейса Workspace Enterprise Server.
  • Projects Management – приложение, стоящее за страницей Projects браузерного интерфейса Workspace Enterprise Server.
  • TC2 Console – приложение, стоящее за страницей Configurations браузерного интерфейса Workspace Enterprise Server.

Файлы лицензий

Related page: Лицензирование

Лицензирование Enterprise Server по сути состоит из следующих двух компонентов, которые вместе образуют двухуровневую систему лицензирования:

  • Server License – эта лицензия делает функции и службы установленного Enterprise Server доступными для организации.
  • Client Access License – эта лицензия позволяет пользователям внутри организации получать доступ к Enterprise Server организации.

Лицензирование Enterprise Server может выполняться через облако или локально с помощью файлов лицензий (*.alf). Получение последних выполняется через Company Dashboard (доступ через пункт Company Dashboard в меню учётной записи AltiumLive в правом верхнем углу сайта Altium). На вкладке Licenses найдите соответствующую лицензию (в группе лицензий Server Applications), затем перейдите на страницу детального управления лицензией. Там нажмите кнопку Activate , чтобы сгенерировать и скачать связанный файл лицензии.

ПО каждый час проверяет наличие действительных файлов лицензий. Без действующей Server License доступ к Enterprise Server будет невозможен. Если Server License действительна, но нет действующих Client Access Licenses (нет доступных подключений), допускается одно административное подключение для целей резервного копирования и конфигурации. Кроме того, и Server, и Client Access Licenses являются срочными лицензиями. Подписку необходимо продлевать для обеспечения непрерывного доступа пользователей организации к Enterprise Server, а также для доступа к новым возможностям и функциональности, разрабатываемым Altium в рамках Enterprise Server. Если продление подписки прекращается, будет предоставлена одна лицензия Server и одна CAL для доступа к вашим данным в целях резервного копирования и конфигурации.

Резервное копирование/восстановление данных сервера

Резервное копирование и восстановление данных вашего Enterprise Server выполняется из командной строки в автоматизированном режиме с помощью специализированного Backup & Restore Tool. Этот инструмент — avbackup.exe — находится в папке \Program Files (x86)\Altium\Altium365\Tools\BackupTool\ (при установке Enterprise Server по умолчанию).

  • Чтобы использовать Backup and Restore tool, необходимо запускать командную строку в режиме администратора.
  • Восстановление резервной копии возможно только в ту же версию Enterprise Server, из которой эта копия была сделана. В этом смысле полезно хранить установщик соответствующей версии Enterprise Server и соответствующие файлы лицензий вместе с Zip‑архивом резервной копии.
Если вы обновляете Enterprise Server до более поздней версии, резервное копирование выполняется в рамках процесса установки. Однако, хотя установщик Enterprise Server включает автоматическое резервное копирование существующего Enterprise Server, всегда рекомендуется самостоятельно сделать резервную копию данных перед обновлением — условно говоря, создать дополнительную копию «в стороне». Это обеспечивает дополнительную безопасность на случай непредвиденных технических трудностей. Кроме того, рекомендуется протестировать новый релиз Enterprise Server на другой машине перед обновлением рабочей (production) инстанции. В этом отношении виртуальные машины могут быть крайне полезны.

Повторная индексация содержимого сервера после миграции данных

Чтобы повторно проиндексировать содержимое Enterprise Server, например после миграции данных:

  1. Остановите все пулы приложений IIS, связанные с Enterprise Server.
  2. Остановите службу Elasticsearch (AltiumElasticSearch). Это выполняется из панели Windows Services — доступ к ней осуществляется из окна Windows Administrative Tools.
  3. Удалите содержимое папки SearchData, которая содержит данные поисковой индексации ( \Altium\Altium365Data\SearchData при установке по умолчанию). \ProgramData
  4. Перезапустите службу Elasticsearch (AltiumElasticSearch).
  5. Перезапустите пулы приложений IIS, связанные с Enterprise Server.

Обнаружив, что папка SearchData пуста, Enterprise Server выполнит повторную индексацию своего содержимого после запуска.

Локальный репозиторий проектирования SVN — хранение

Репозиторий проектирования, созданный через локальную службу контроля версий, хранит свои внутренние данные в соответствующей подпапке в папке \ProgramData\Altium\Altium365Data\Repository (для установки Enterprise Server по умолчанию).

  • Новая установка Enterprise Server предоставляет один репозиторий проектирования на базе Git для размещения всех ваших проектов Workspace — и на этом всё! Это исключает необходимость настройки и снижает сложность, связанную с локальной службой контроля версий Enterprise Server. У вас есть один репозиторий проектирования — Versioned Storage — к которому все ваши разработчики могут получать доступ и в который могут выполнять выпуск (release). В результате страница VCS в браузерном интерфейсе Workspace Enterprise Server становится исключительно информационной — вы не можете добавить новый репозиторий, а единственный Git-репозиторий нельзя каким-либо образом изменить или удалить.
  • К папке \ProgramData\Altium\Altium365Data\Repository не следует обращаться каким-либо образом, кроме как ИТ-персоналу для обслуживания.

Использование Oracle для базы данных Enterprise Server

Related page: Enterprise Server с Oracle в качестве бэкенда

При установке Enterprise Server тип базы данных Oracle обеспечивает упрощённую установку Enterprise Server в организациях, которые уже используют этот тип базы данных в качестве бэкенда для своих существующих систем. Размещение Enterprise Server на уже имеющейся инфраструктуре снижает сложность установки и администрирования.

При использовании Enterprise Server с Oracle в качестве бэкенд-базы данных Enterprise Server поддерживает Oracle версии 19c.

Установка и запуск Enterprise Server с Oracle в качестве бэкенд-базы данных по сути представляет собой двухэтапный процесс:

  1. Настройка базы данных Oracle
  2. Настройка Enterprise Server.
Рекомендуется устанавливать Enterprise Server на отдельной машине, отличной от той, на которой размещена сама база данных Oracle. Кроме того, убедитесь, что выделенная машина, на которую устанавливается Enterprise Server, имеет достаточный объём хранилища и вычислительных ресурсов.

Подготовка Enterprise Server

Для успешной установки и работы Enterprise Server требуется не только клиент OCI, но и соответствующие коннекторы .Net. Рекомендуется установить соответствующие 32-битные Oracle Data Access Components (ODAC) с Oracle Developer Tools for Visual Studio в соответствии с версией Oracle, которую вы используете. Загрузку ODAC 12c Release 1 and Oracle Developer Tools for Visual Studio (12.1.0.1.0) рекомендуется установить как минимум на выделенную машину, предназначенную для размещения Enterprise Server.

  • Enterprise Server также требует настройки tnsnames.ora.
  • Структура базы данных Enterprise Server создаётся и обновляется в процессе установки, поэтому при наличии строгих политик со стороны DBA на выполнение DDL структуру базы данных можно создать во временном пространстве или на временном сервере, проверить, а затем вручную перенести на целевой продуктивный сервер. Если это сделано, Enterprise Server потребуется перенастроить для использования этого продуктивного сервера.
Инструмент Backup & Restore Enterprise Server не поддерживает резервное копирование базы данных при использовании Oracle в качестве бэкенда. Поэтому резервное копирование необходимо выполнять совместно с DBA Oracle. Дополнительные сведения см. в разделе Backing up with an Oracle Backend.
AI-LocalizedЛокализовано с помощью ИИ
Если вы обнаружили проблему, выделите текст/изображение и нажмитеCtrl + Enter, чтобы отправить нам свой отзыв.
Content