使用 Oracle 后端备份 Altium On-Prem Enterprise Server

Parent page: 使用 Oracle 后端的 Altium On-Prem Enterprise Server

本文档面向在使用 Oracle 数据库后端时对 Altium On-Prem Enterprise Server 进行备份的 IT 管理员。内容包含 Enterprise Server 的相关细节、在 Oracle 使用场景下的备份流程、系统需求的重要信息，以及一个示例。

备份流程概述

在使用 Oracle 后端时，Enterprise Server 的备份方式取决于贵公司如何管理其 Oracle 数据库。有些公司在 Windows Server 操作系统上运行 Oracle 数据库，而另一些公司则拥有完整的 Oracle 数据中心。备份流程通常包含三个步骤，如下图所示。

Enterprise Server 与 Oracle 数据库备份流程的高层概览。

本文档中的假设

1. 安装由 IT 管理员执行。至少，执行 Enterprise Server 安装的用户应对宿主机具有管理员权限。
2. 源 Oracle 服务器与目标 Oracle 服务器上使用的 Oracle Schema 以及 Oracle 应用凭据必须相同。

Enterprise Server 架构高层概览

与其他设计用于在 Microsoft Windows 上运行的软件类似，Enterprise Server 是一个多线程、多服务的服务器应用程序。由于本文档仅关注可能与 Oracle 数据库交互的 Enterprise Server 部分，下图已简化，用于表示整体的 Enterprise Server 后端架构。

Enterprise Server 架构的高层概览。Enterprise Server 的 Backend Storages 包含大部分客户二进制数据，而 Windows Services 是一组支撑服务的集合。

本文档重点关注 Backend Storages，因为该模块中的数据会被备份，可能迁移到另一台机器，然后在同一台或不同机器上恢复。在 Backend Storages 中可以找到以下内容：

• Databases – 包含元数据，例如元件封装与原理图符号关联、参数、文件路径、指向元件供应链数据源的链接等。这些信息可能存储在 Firebird 或 Oracle 数据库中。
• File Storage – 该 File Storage 区域在 Enterprise Server 的 VCS 仓库中保存二进制数据。这些二进制数据包括 PCB 和原理图工程文档、封装、符号、Draftsman 以及其他 Enterprise Server 原生或非原生文档等信息。

Altium 备份工具高层概览

Altium 备份工具名为 avbackup.exe。这是一个命令行工具，IT 管理员可执行它来备份 Enterprise Server 数据。avbackup.exe 在 Enterprise Server 配置为默认 Firebird 数据库后端时用于备份；在使用 Oracle 数据库作为后端时也使用同一工具。

在使用 Oracle 数据库的 Enterprise Server 部署中使用 avbackup.exe 时，管理员应注意以下事项：

1. avbackup.exe NOT 不支持备份 Oracle 数据库。该功能仅适用于使用 Firebird 数据库后端且最初由 Enterprise Server Installer 自动配置的 Enterprise Server 部署。
2. avbackup.exe 将生成一个 Zip 文件，其中包含所有 Enterprise Server 二进制数据。
3. avbackup.exe 在数据备份期间将自动关闭所有 Enterprise Server 服务（包括 IIS 服务），并在备份成功后重启其关闭的所有服务。

Windows 平台上使用 Oracle 后端的 Enterprise Server 备份示例

本示例的说明也适用于没有专职 Oracle 数据库管理员（DBA）的小型企业，但仍需要在其网络中备份 Enterprise Server 及其关联的 Oracle 数据。以下步骤展示了如何执行 Enterprise Server 与 Oracle 数据库的基础备份。

所需项目

• 备份文件夹——用于存放 Enterprise Server 和 Oracle 数据的文件夹需要预先创建。
• 对 Enterprise Server 宿主机的管理员访问权限。这是正确运行 Enterprise Server 备份命令工具（avbackup.exe）所必需的。
• 对 Oracle 服务器的适当 DBA 访问权限（例如：在 Windows 环境中将用户的 Windows 账户加入 DBA 角色）。

备份流程

1. 在 Enterprise Server 宿主机上：
   1. 创建一个备份文件夹（建议使用统一的文件路径，例如：C:\Backups）。
   2. 以管理员身份运行 avbackup.exe 工具来备份 Enterprise Server 数据。该工具位于 C:\Program Files (x86)\Altium\Altium365\Tools\BackupTool 文件夹中。

2. 在 Oracle 数据库服务器宿主机上：
   1. 创建一个备份文件夹（建议使用统一的文件路径，例如：C:\Backups）。
   2. 备份 Oracle 数据（本节假设用户账户与 schema 均名为 AESUSER313，密码为 Altium）：
      1. 以管理员权限启动命令提示符。
      2. 使用命令停止 IIS 服务器：net stop WAS。
      3. 在备份前临时将相关 schema 提升为 DBA 状态。
      4. 备份/导出与 Enterprise Server 关联的 schema。导出命令示例如下：

exp AESUSER313/Altium@xe owner=AESUSER313 file=c:\Backups\AESUSER313.dmp log=c:\Backups\AESUSER313_export.log statistics=none

其中，

AESUSER313 – 对 schema 具有完全权限并拥有访问数据库权限的用户。

Altium – 与 Enterprise Server 关联的 Oracle 用户账户密码。

xe – tnsnames.ora 中包含的目标数据库网络服务名。

owner = AESUSER313 – schema 名称。

file = c:\Backups\AESUSER313.dmp – 备份位置。

log = c:\Backups\AESUSER313_export.log – 备份日志（可选）。

结论

尽管上述示例包含了与 Oracle 数据库处理相关的更多细节，但备份 Enterprise Server 数据只有三个关键步骤：

1. 步骤 1：停止 IIS 服务以及 Enterprise Server IIS 应用程序池。
2. 步骤 2：备份 Enterprise Server 数据。
3. 步骤 3：备份与 Enterprise Server 关联的 Oracle 数据。

按所述顺序执行该流程，可大幅降低因 Oracle 数据库与 Enterprise Server 二进制数据不匹配而导致数据损坏的可能性。