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 的某处吗？

可以。这取决于你和你的 IT 团队选择将 Enterprise Server 部署在哪里。

如果我们的 VPN 网络很慢，会如何影响工作流？

工作流本身可能影响不大。使用 Workspace 库元器件时，初次浏览和搜索可能会有点慢，但一旦数据被缓存，体验就会更顺畅。至于设计，当你打开一个 Workspace 项目时，你会在本地存储并进行工作。

因此，Enterprise Server 的日常使用不至于受到严重影响。当然，更快的 VPN 会更好，但我们也听到有人说他们的 VPN 并不理想，但仍然能正常使用，因为并不需要与 Enterprise Server 持续不断地交互。

非管理员用户可以更改自己的 Enterprise Server 访问凭据吗？

可以。虽然非管理员用户无法管理其他用户，但如果该用户的认证使用的是 Enterprise Server 的内置认证服务（Built In authentication service），他们可以修改自己的用户资料，包括更改用户名和密码。这可通过 Edit User 窗口完成：在浏览器界面右上角点击当前活动用户区域，然后从相关菜单中选择 Profile 。

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

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

在 Altium Designer 中，你仍然可以 sign in 到旧版 Altium Vault（Vault 2.0 到 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 你是“连接（connect）”而不是“登录（sign in）”——因此成功连接到该类 vault 后，Altium Designer 的界面不会显示你已登录到任何服务器。

一旦你已登录/连接到目标实体，它将列在 Altium Designer 的 Preferences 对话框中 Data Management - Servers page 的 Known Servers 区域内。

我仍然想运行我的 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 GUI 不会显示你已登录到任何服务器。随后你可以重新登录之前处于活动状态的服务器，同时继续保持对 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。该流程的 GUI 呈现出直观的操作流：从最初选定的库开始，将其导入到您的 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 库中导入指定的模型类型。包含多种元件类型的库（整体式/单体库，monolithic libraries）也会被自动检测并处理。

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

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

有没有办法下载 Workspace 库元件的快照，以便在 IT 基础设施可能宕机的日子使用？

没有，目前无法获取 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。因此，Enterprise Server 浏览器界面的 VCS 页面仅用于信息展示——您无法添加新仓库，且该单一 Git 仓库不能以任何方式修改，也不能删除。Where-used 功能由 Enterprise Server 原生的 Git 设计仓库内建支持。

如果您是从 Altium NEXUS Server 1.0（或 Altium Vault 3.0）升级到 Enterprise Server，那么也会启用 SVN 仓库的使用，以便您继续沿用之前（已建立）的设计流程。在这种情况下，您可以继续通过本地 Version Control 服务（仅 SVN）创建仓库，或连接到外部仓库（SVN 或 Git）。因此，如果您需要让设计仓库位于另一台服务器之类的场景，可以使用外部仓库——在 Enterprise Server 中完成设置，让 Enterprise Server 知道它的位置。随后即可利用 Where-Used 功能。

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

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

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

可以，这些都可以通过 Output Job Configuration 文件进行配置。当在已分配的 OutJob 文件中检测到一个或多个 Validation 类型报告时，Validate Project 阶段会在 release process 中自动运行。会执行分配给待发布数据项的 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 中相应的仓库。因此这些设计的历史记录基本会丢失，相当于重新开始，但您可以把数据取出再迁入。

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