Parent page: 使用 Oracle 后端的 Altium On-Prem Enterprise Server
本文档面向需要将 Altium On-Prem Enterprise Server 配置为使用 Oracle Database 作为后端的 IT 管理员。内容包含 Enterprise Server 的相关细节、安装流程、系统要求的重要信息,以及一个示例。
要遵循本指南,你应对 Oracle 数据库概念和操作系统环境有基本了解。
安装流程概述
将 Enterprise Server 配置为使用 Oracle 后端,取决于贵公司如何管理 Oracle Databases。有些公司在 Windows Server 操作系统上运行 Oracle Databases,而另一些公司则拥有完整的 Oracle 数据中心。安装过程通常包含三个步骤,如下图所示。
Enterprise Server 与 Oracle 数据库安装流程的高层概览。
本文档中的假设前提
尽管 Oracle 配置在不同站点之间可能有所差异,本文档仍基于以下若干假设:
- 安装由 IT 管理员执行。至少,执行 Enterprise Server 安装的用户应对宿主机具有管理员权限。
- Enterprise Server 安装并运行在完整的 Microsoft Windows 操作系统上。
- Oracle Client Connector 安装并运行在承载 Enterprise Server Application 的同一台机器上。
- .NET Framework 4.8 和 .NET Core 3.1.22 安装并运行在承载 Enterprise Server Application 的同一台机器上——如果未安装,这些组件会在 Enterprise Server 安装期间自动安装。
- Oracle Server 应运行在与 Enterprise Server application 物理上不同的主机上。
- 如果本次安装是数据迁移流程的一部分,则源与目标 Oracle 服务器上使用的 Oracle Schema 以及 Oracle 应用凭据必须相同。
Enterprise Server 架构高层概览
与其他运行在 Microsoft Windows 上的软件类似,Enterprise Server 是一个多线程、多服务的服务器应用。由于本文档仅关注 Enterprise Server 中可能与 Oracle Database 交互的部分,下图已做简化,用于表示整体的 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 原生或非原生文档等信息。
Windows 平台上使用 Oracle 后端的 Enterprise Server 示例配置
本示例的说明也适用于没有专职 Oracle Database Administrator (DBA) 的中小型企业,但仍需要在其网络中实施 Enterprise Server-Oracle 配置。以下步骤展示了如何部署一个基础的 Enterprise Server 与 Oracle 安装。
假设安装使用 Oracle 内置的 SYSTEM 账户完成,并且不创建自定义 SCHEMA。不过,建议更有经验的用户或 DBA 创建合适的用户账户,并建立相应的 SCHEMA,同时授予正确的权限。
所需项目
- Oracle Database Server 宿主机,运行 Windows 7 Professional 或更高版本。
推荐:Windows Server 2012 R2。
- Enterprise Server 宿主机,运行 Windows Server 2016 Standard Edition(64 位)或更高版本。
推荐:Windows Server 2019 Standard Edition(64 位)。
- Oracle Database 版本 19c。
- Oracle Data Access Components (ODAC) 客户端连接器,例如
ODTwithODAC122011(见下文)。
- Altium On-Prem Enterprise Server。
Enterprise Server 的安装通过 Altium NEXUS Server Setup 向导完成。要访问该向导,你需要先获取并运行一个可执行文件——Altium NEXUS Server <VersionNumber>.exe。该可执行文件可保存到硬盘上的任意位置。
安装步骤
- 在 Oracle DB server 宿主机上:
- 安装 Oracle Database 19c。记录你设置的名称/密码。
- 确保 NLS_CHARACTERSET 配置设置为
AL32UTF8。
- Optional:为 Enterprise Server 设置一个数据库用户账户,以替代默认的
SYSTEM 账户。记录你设置的用户名和登录信息。可以使用 Oracle SQL Developer 应用通过以下 SQL 命令创建新的数据库用户账户及文件(例如,新用户账户的名称/密码为 NEXUSUSER/NEXUSPASS):
create tablespace NEXUSUSER datafile 'C:\app\odb19\oradata\orcl\NEXUS.dbf' size 100M autoextend on;
create tablespace TEMP datafile 'C:\app\odb19\oradata\orcl\TEMP.dbf' size 100M autoextend on;
CREATE USER NEXUSUSER IDENTIFIED BY NEXUSPASS DEFAULT TABLESPACE NEXUSUSER;
GRANT CONNECT TO NEXUSUSER;
GRANT CONNECT, RESOURCE, DBA TO NEXUSUSER;
GRANT CREATE SESSION TO NEXUSUSER;
GRANT UNLIMITED TABLESPACE TO NEXUSUSER;
GRANT ALL PRIVILEGES TO NEXUSUSER;
- 在 Enterprise Server 宿主机上:
- 首先,安装 Oracle Data Access Components (ODAC) 软件:ODTwithODAC122011。
- 将
tnsnames.ora 文件从 Oracle DB Server 宿主机复制到 Enterprise Server 宿主机。
- 该文件通常位于
%ORACLE_HOME%\Network\Admin 目录中,其中 ORACLE_HOME 环境变量由 Oracle 的安装位置决定——例如: C:\app\odb19\product\19.x.x\dbhome_1
- Enterprise Server 机器上的目标位置同样是
%ORACLE_HOME%\Network\Admin,其中 ORACLE_HOME 路径为 ODAC 的安装位置——例如:C:\app\product\12.2.0\client_1\Network\Admin
或者,DBA 也可以在此步骤中配置 ORACLE_HOME 环境变量。
- 安装 Enterprise Server。
- 在 Enterprise Server 安装期间,输入以下内容:
- TNS Alias:默认值为 ORCL。如果你执行了步骤 1-a,请在此输入你定义的相应 TNS Name。
- Username:默认值为 SYSTEM。如果你执行了步骤 1-c,请在此输入你定义的相应 Username(示例中为 NEXUSUSER)。
- Password:与步骤 1-a 或 1-c 中定义的相同。
- 继续按照文档 Installing Altium On-Prem Enterprise Server 中所述完成 Enterprise Server 的安装与配置。
Upgrading from a Legacy Vault product to an Enterprise Server
如果要从旧版 Altium Vault(2.x、3.x)切换到 Enterprise Server,只需运行 Enterprise Server 安装程序进行升级——就像过去更新 Altium Vault 时所做的一样。
当使用 ORACLE 作为数据库后端时,从旧版 Vault 更新到 Enterprise Server 的一个重要要求是必须设置 ORACLE_HOME 环境变量 must。这属于 Enterprise Server 的安装流程之一,但在从先前的 Altium Vault 升级到 Altium On-Prem Enterprise Server 时是必需的。
结论
尽管上述示例包含了与 Oracle Database 处理相关的额外细节,但将 Enterprise Server 配置为使用 Oracle 后端只有三个关键步骤:
- 步骤 1:创建 Oracle 账户和 SCHEMA。
- 步骤 2:建立 tnsnames.ora 参数。
- 步骤 3:安装 Enterprise Server。