面向 IT 部门的信息

虽然本说明站点的其他页面已详细介绍 Altium On-Prem Enterprise Server 及其相关服务的安装与使用，但本页旨在为组织的 IT 部门提供一份集中且详尽的资源。这里可用于查找关于该技术的常见问题答案，包括：

• 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?

以下各节将对这些及其他问题提供详细解答，并包含架构与数据流的高层概览。

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 配置的一部分。

HTTPS 协议支持

Enterprise Server 支持使用 HTTPS 协议在网络上进行安全通信，以保护数据的隐私性与完整性。

配置证书

对于全新安装，Enterprise Server 会提供一个在 IIS 中生成并配置的自签名证书。出于安全原因，建议生成您自己的证书（使用您标准/偏好的工具），然后在 IIS 中配置该证书。您可以创建证书请求并将其发送给已知的证书颁发机构（CA），例如 VeriSign 或 GeoTrust，或从您内网域中的在线 CA 获取证书。更多信息请参阅 Microsoft 文档中的 How to Set Up SSL on IIS 7 or later 页面。

配置 HTTPS

可从 Windows Internet Information Services (IIS) Manager 面板访问 Enterprise Server 的配置与服务器绑定——该面板可从 Administration Tools 窗口（Control Panel\System and Security\Administrative Tools）打开。在面板的 Connections 列表中选择 “Altium On-Prem Enterprise Server” 条目，然后选择 Features View 选项卡。

访问 Enterprise Server 的配置与服务器绑定设置。

Enterprise Server 可用的端口与服务器名称会在 Actions 窗格中以可选链接显示。使用这些链接可查看并测试服务器连接协议，或通过选择窗格中 Edit Site 部分的 Bindings 链接来访问当前的名称/端口绑定。

可通过 Site Bindings 对话框并使用 Edit button 编辑某个绑定（包括其协议端口号）。

通过 Site Bindings 对话框配置绑定。

请注意，服务器名称 localhost 仅适用于本机，因此除了承载 Enterprise Server 的那台电脑之外，其他 PC other 需要使用该主机的实际（服务器）名称进行连接。

要确认安装并运行 Enterprise Server 的主机 PC 名称，请在该机器上进入 Control Panel\System and Security\System，并记录 Computer name 与 Full computer name（其完全限定域名）——后者将被 Enterprise Server 用于通过网络进行安全连接。

如果您已编辑 Enterprise Server 的站点绑定，使其使用不同于默认值的端口号，那么也需要在 Enterprise Server 的 LocalVault.ini 文件中反映该更改。这是因为当 Altium Designer 连接到 Enterprise Server 时，会读取其中的端口引用。LocalVault.ini 文件位于 Enterprise Server 安装的根目录中——通常为 Program Files (x86)\Altium\Altium365。

例如，如果您已将 Enterprise Server 的站点绑定更改为使用标准 443 端口进行 HTTPS 连接，请将 LocalVault.ini 文件中对应的 HttpsPort=9785 行更新为 HttpsPort=443。

重新配置站点绑定时

如果您为 Enterprise Server 添加了新的 IIS 站点绑定，或编辑了现有站点绑定条目（见上文），应重启服务器 PC 以正确建立新配置。典型的站点绑定更改包括：编辑某个主机条目的端口号，或为域别名添加新的绑定。

当不便重启服务器主机时，替代流程是在 IIS 平台上重启服务器服务——Restart 位于 Manage Website 下——并同时重启 Altium DXP App Server Pinger 服务（Windows 服务）。

通过 HTTPS 访问

要建立到 Enterprise Server 的安全连接：

• 从 Altium Designer ——使用带 HTTPS 前缀的服务器地址以及已配置的 HTTPS 端口。默认情况下为 https://<computername>:9785（其中 [computername] 为主机的计算机名或完全限定域名）。

  Altium Designer 包含所需的安全支持，可在无需干预的情况下接受到 Enterprise Server 的 HTTPS 连接。

• 从浏览器——输入主机计算机名称服务的地址（https://<computername>:9785）。

  如果您选择保留为 Enterprise Server 生成的自签名身份（Identity）证书，浏览器会警告连接不安全/不私密。您可以在浏览器中选择接受以继续。某些浏览器（例如 Firefox）提供永久接受证书的选项，以便后续无需再次操作。

网络

默认端口

Enterprise Server 使用以下默认通信端口号：

• HTTP Port – 9780

• HTTPS Port – 9785

• LDAP Synchronisation Service Port – 9791

• Websocket Port – 4649

  请注意，/websocket/WebService.asmx 是用于 API 调用的 HTTP SOAP 端点，因此与其他 API 端点一样，它使用 HTTPS 端口（默认 9785）。

• Firebird Server Port – 3050

• SVN Port – 3690

• Elasticsearch Ports – 9200 和 9300

列表中的前三项可在初始安装期间于安装程序的 Altium On-Prem Enterprise Server Configuration 页面进行配置。

选择端口时，请注意它不得与其他应用程序使用的 ports used by other applications 冲突——如果某个端口当前正在使用中，安装程序会通知您。

另请参阅关于 ports and IP addresses for Altium Design software 的信息。

服务到服务通信所用协议

基于 HTTP 的 SOAP。

数据存储

默认安装路径

以下为安装 Enterprise Server 时的默认安装路径列表：

• Enterprise Server Installation Folder – \Program Files (x86)\Altium\Altium365。

• Firebird Installation Folder – \Program Files\Firebird\Firebird_3_0。

• Firebird Database – \ProgramData\Altium\Altium365Data\DXPSERVER.DAT。

• Revision Files Folder – \ProgramData\Altium\Altium365Data\Revisions。

• Search Index Data Folder – \ProgramData\Altium\Altium365Data\SearchData。

本地 SVN 设计仓库——存储

通过本地版本控制服务创建的设计仓库，其内部数据存储在 \ProgramData\Altium\Altium365Data\Repository 文件夹中对应的子文件夹内（针对 Enterprise Server 的默认安装）。

服务架构 – 概览

Enterprise Server 会安装若干核心服务，以及基于浏览器的管理控制台和一个 Explorer（同样基于浏览器）。要访问这些服务中的任何一个，必须识别并验证用户身份。Enterprise Server 自带一个预定义用户（Username：admin，Password：admin）。Enterprise Server Workspace 浏览器界面中的 Users 页面可用于添加和管理更多用户。可注册访问并使用 Enterprise Server 的用户数量不受限制，但同时连接数受所需许可的确定与强制限制。

Altium Designer 使用未加密通道（SOAP over 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 文件夹（\ProgramData\Altium\Altium365Data\Revisions）。

以下基于浏览器的应用使用 SOAP API 与相应服务通信——它们不需要访问 Enterprise Server 数据库，也不需要任何其他文件即可运行：

• User Management – Enterprise Server Workspace 浏览器界面中 Users 页面及其子页面背后的应用。

• Vault Explorer – Enterprise Server Workspace 浏览器界面中 Explorer 页面背后的应用。 – Enterprise Server Workspace 浏览器界面中 Part Providers 页面背后的应用。

• Projects Management – Enterprise Server Workspace 浏览器界面中 Projects 页面背后的应用。

• TC2 Console – Enterprise Server Workspace 浏览器界面中 Configurations 页面背后的应用。

运维

服务器数据的备份/还原

Enterprise Server 数据的备份与还原通过命令行以自动化方式执行，使用专用的 Backup & Restore Tool。该工具——avbackup.exe——可在文件夹 \Program Files (x86)\Altium\Altium365\Tools\BackupTool\ 中找到（针对 Enterprise Server 的默认安装）。

更多信息请参阅 Backing up & Restoring Your Installation 页面。

数据迁移后重新索引服务器内容

要重新索引 Enterprise Server 内容（例如在数据迁移后）：

1. 停止所有与 Enterprise Server 相关的 IIS 应用程序池。

2. 停止 Elasticsearch (AltiumElasticSearch) 服务。这可在 Windows Services 面板中执行——从 Windows 的 Administrative Tools 窗口进入。

3. 删除 SearchData 文件夹中的内容，该文件夹包含搜索索引数据（默认安装为 \ProgramData\Altium\Altium365Data\SearchData）。

4. 重启 Elasticsearch (AltiumElasticSearch) 服务。

5. 重启与 Enterprise Server 相关的 IIS 应用程序池。

当检测到 SearchData 文件夹为空时，Enterprise Server 启动后将重新索引其内容。

增大 Java 堆大小

Java 堆大小不足可能会破坏元件搜索索引，并导致在 Altium Designer 中无法获取元件数据。如果你遇到搜索索引问题（Health Monitor Status Report 的日志中有 SearchService Schema not found: 'vault1ex2_04 错误），请考虑增大 Java 堆大小。

可在托管 Enterprise Server 的机器上打开 http://localhost:9200/_cat/nodes?h=heap*&v 来检查当前 Java 堆大小。如果 heap.max 的值约为 1 GB，请按下述说明增大该值。

1. 以管理员模式运行命令提示符。

2. 运行以下命令：

   "C:\Program Files (x86)\Altium\Altium365\Services\ElasticSearch\bin\service-nexus-server.bat" manager AltiumElasticsearch

3. 在打开的对话框的 Java 选项卡中，进行以下更改：

   • 在 Java Options 字段中，将 -Xms1g 更新为 -Xms4g，并将 -Xmx1g 更新为 -Xmx4g。

   • 在 Initial memory pool 和 Maximum memory pool 字段中，将值更新为 4096。

   当将 Java 堆大小增大到不同于 4 GB 的值时，请相应更改上述选项（例如，如果要将大小增至 6 GB，则将 Java options 更新为 -Xms6g 和 -Xmx6g ，并为 Initial memory pool 和 Maximum memory pool 指定 6144）。

   

4. 在对话框中点击 Apply 和 OK。

5. 在 Windows Services 面板中（从 Windows 的 Administrative Tools 窗口进入），重启 AltiumElasticsearch 服务。

6. 打开 http://localhost:9200/_cat/nodes?h=heap*&v 并检查 heap.max 参数值，以验证更改已应用。