Altium 本地部署企业服务器常见问题解答

常规

我可以使用 Altium On-Prem Enterprise Server 来管理元器件，但将设计项目保留在本地吗？

你可以使用 Altium On-Prem Enterprise Server 仅管理元器件，但不建议这样做。Enterprise Server 最大的优势之一是管理日常 PCB 进行中的工作（work-in-progress），其中包括设计数据。正确使用时，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 的内置认证服务（Built In authentication service），他们可以修改自己的用户资料，包括更改用户名和密码。此操作通过 Edit User 窗口完成：在浏览器界面右上角点击当前登录用户区域，然后从关联菜单中选择 Profile 。

我可以连接到多个 Enterprise Server Workspace 吗？

在任意时刻你只能“登录（signed in）”到一个 Enterprise Server Workspace，因为你连接的是一套服务平台，而不是单一的 Enterprise Server 服务。通常一个组织只会部署一个 Enterprise Server。不过，如果有多个 Enterprise Server 可用，只需按需从一个退出登录，再登录到另一个即可。

在 Altium Designer 中，你仍然可以 sign in 到 Altium NEXUS Server（已停用）、Altium Concord Pro（已停用）、旧版 Altium Vault（Vault 2.0 到 3.0），或 connect 到旧版 Altium Personal Vault：

• Altium NEXUS Server / Altium Concord Pro / Altium Vault - 退出当前活动服务器，然后使用 Sign in 对话框 sign in 到目标服务器。
• Altium Personal Vault - 退出当前活动服务器，然后使用 Sign in 对话框 connect 到 Personal Vault。请记住：对于 Personal Vault，你是“连接（connecting）”而不是“登录（signing in）”——因此成功连接到该类 Vault 后，Altium Designer 的界面不会显示你已登录到任何服务器。

当你登录/连接到目标实体后，它会列在 Known Servers 区域中，位置为 Altium Designer 的 Preferences 对话框里的 Data Management - Servers page。

我仍然想运行我的 Altium Personal Vault，可以吗？

当然可以。如果同一台 PC 上还运行着旧版本的服务器，请确保通信端口不冲突。Enterprise Server 使用默认端口 9780（与其前身 Altium Concord Pro/Altium NEXUS Server/Altium Vault 相同），Altium Personal Vault 使用默认端口 9680。

要在 Altium Designer 中将 Personal Vault 设为“已知服务器（Known Server）”——在 Preferences 对话框的 Data Management - Servers page 上——请先退出当前活动服务器，然后使用 Sign in 对话框连接到 Personal Vault。请记住：对于 Personal Vault，你是“连接”而不是“登录”——因此成功连接到该类 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 功能的权限。每位访问 Enterprise Server 服务的用户都需要一个 Client 许可。

如果我将现有 Enterprise Server 安装升级到更高版本，是否需要刷新许可？

需要，请务必刷新你的 Enterprise Server 许可。在 Enterprise Server Workspace 浏览器界面的 Admin - Licenses 页面中，删除现有许可（Altium Enterprise Server 和 Altium Enterprise Server CAL），然后重新添加新的许可实例。这样可确保你使用的是最新许可，并包含该 Enterprise Server 更高版本中与许可相关的功能变更。

我们的 Enterprise Server 安装可用连接数不够，怎么办？

管理员用户可以通过 Enterprise Server Workspace 的浏览器界面终止某个用户的会话，以强制释放一个连接。该操作在界面的 Sessions page 中完成。

或者，作为更好的长期解决方案，可通过购买额外的 Client Access Licenses（Altium Enterprise Server CAL）来增加更多席位（连接数）。

元器件管理

Workspace 库元器件与 Unified Component 是同一个概念吗？

是也不是。这取决于该 Workspace 库元器件是否为其定义了 Part Choices。当元器件被创建并发布后，它被称为 Workspace 库元器件，它仅代表该元器件的工程/设计视图。从本质上说，它是一个容器，用于存放在设计区（Design Area）中对该元器件建模所需的全部信息。这包括指向所有必需领域模型（原理图符号、PCB 2D/3D 元件、仿真等）的链接，以及参数化信息。它对在板级设计中使用它的设计人员意义重大，但在设计领域之外并没有实际意义。要成为真正“Unified Component”（统一元器件），即打通设计与供应链领域，该元器件必须映射到物理的、真实可制造的器件。实现方式是为该元器件指定 Part Choices。

正是这种将元器件从传统电子设计领域智能映射到组织其他部门所看到的更大“产品领域”的方式，使得普通的 Workspace 库元器件转变为真正的 Unified Component！

如果我已经有很大的库怎么办？

Altium Designer 结合 Enterprise Server Workspace，提供了一个精简、简单的流程，可将您现有的库快速导入到 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 库——也就是只关注 PCB 布局——那么 Library Importer 支持仅导入这些库；或者可切换到“仅模型”导入模式，从 Integrated 或 Database 库中导入指定的模型类型。包含多种元器件类型的库（单体库）也会被自动检测并处理。

我可以限制谁能在 Enterprise Server Workspace 中修改元器件吗？

可以，您可以为不同人员设置不同权限，规定谁能做什么。您可以创建一个馆员（librarian）组，并且还能指定谁可以或不可以读取（访问）任何文件夹。您甚至可以创建一个沙盒文件夹，让部分工程师在需要创建自定义器件时可以访问；而正式发布的器件则放在另一个所有人都能访问的文件夹中。因此一切都非常可控。

当 IT 基础设施可能宕机时，有办法下载 Workspace 库元器件的快照吗？

不，目前没有办法获取 Enterprise Server 的本地镜像。

使用 Components panel 时，Workspace 库元器件的数据会从 Workspace 缓存到本地机器。这在 Altium Designer 未连接到 Enterprise Server 时提供了 Workspace 库元器件的离线访问模式，因此仍可正常浏览与放置元器件等。请注意，Filters 在该模式下不可用。

该状态会在面板元器件列表窗格的底部栏显示“Offline mode – cached data is being used”警告文字来指示。

我可以从 Enterprise Server 制作一个本地库吗？

可以，通过 Content Cart 提供的功能，您可以将本地 Enterprise Server 中的元器件获取到一个 Integrated Library（*.IntLib）中。而当从该 Integrated Library 放置元器件时，实际链接仍会指向 Enterprise Server 中的 Component Items。这使您能够以离线方式有效使用公司 Workspace 库元器件，同时确保设计仍与源 Enterprise Server 中的这些元器件保持真实连接。

设计管理

Where-Used 功能是否依赖于设计已检入 Enterprise Server 的本地 Version Control Service？

Enterprise Server 需要知道存放您设计的设计仓库的存在。Enterprise Server 的新安装会提供一个基于 Git 的单一设计仓库，用于容纳您所有的 Workspace 设计项目——仅此而已！这避免了关于 Enterprise Server 本地 Version Control 服务的任何设置与复杂性。您拥有一个单一设计仓库——Versioned Storage——供所有设计人员访问并发布。该单一 Git 仓库不能以任何方式修改，也不能删除。Where-used 功能由 Enterprise Server 原生的 Git 设计仓库天然支持。

当我对某个元器件做更改时，是否可以只让更改在设计中本地生效？

当然可以。本地设计更改是 Altium Designer 核心功能的重要组成部分。不过不建议这样做。如果您在某个阶段使用 Altium Designer 的某个更新功能去更新该元器件，它会从 Enterprise Server 拉取下一版修订，从而覆盖任何本地更改。因此，更好的做法是直接在 Enterprise Server 中修改您的 Workspace 库元器件。

我能否控制在提交任何修订到 Enterprise Server 之前必须通过哪些设计违规检查？

可以，这些都可以通过 Output Job Configuration 文件进行配置。当在已分配的 OutJob 文件中检测到一个或多个 Validation 类型报告时，release process 的 Validate Project 阶段会自动运行。会执行分配给待发布数据项的 Output Job 文件中定义的所有验证输出生成器。这包括运行以下任意检查：

• Differences Report – 使用比较器判断源文档与 PCB 设计文档是否正确同步。
• Electrical Rules Check – 检查已捕获的源设计在电气/制图方面的有效性。
• Design Rules Check – 根据指定的板级设计约束检查 PCB 文档的有效性。
• BOM Checks - 检查源 BOM 文档（*.BomDoc）中与 Design Items 或 Part Choices 相关的潜在违规（如可用）。
• Footprint Comparison Report – 将板上的封装与其源库进行对比，确保其为最新且匹配。
• Component State Checking - 检查处于受限状态的元器件。作为配置的一部分，您需要为目标 Enterprise Server 中每个已定义 Lifecycle Definition 的每个已定义状态，指定要采取的动作：不处理、警告或生成错误。选择“错误”将阻止设计发布。此外，运行该检查会生成一个便于查看的基于 HTML 的报告，让您一眼看出哪些设计元器件不处于有效状态。
• Environment Configuration Compliance Check – 检查是否仅使用了环境配置中允许您所属组（如适用）使用的数据项。该检查也可确保所有设计项都来源于 Enterprise Server。

如果通过 Output Job 文件的某些验证未通过，Enterprise Server 能阻止提交吗？

可以，如果验证步骤失败，则不会将数据提交并发布到 Enterprise Server。

我可以将现有设计导入到 Enterprise Server 吗？

您可以将现有设计迁移到 Enterprise Server，但目前无法迁移现有的 subversion 仓库。如果要迁移设计数据，您必须将其拉取出来并重新提交到 Enterprise Server 中相应的仓库。因此这些设计的历史记录基本会丢失，相当于重新开始；但您可以把数据导出再导入回去。

您还可以借助强大的 Item Manager 提供的自动匹配能力，将旧式元器件管理方法中的元器件转换为 Workspace 库元器件。