Parent page: Altium On-Prem Enterprise Server с бэкендом Oracle
Этот документ предназначен для ИТ-администратора, который настраивает Altium On-Prem Enterprise Server для работы с Oracle Database в качестве бэкенда. В нём приведены сведения об Enterprise Server, процедура установки, важная информация о системных требованиях, а также пример.
Чтобы следовать этому руководству, у вас должно быть общее понимание концепций баз данных Oracle и среды операционной системы.
Обзор процесса установки
Настройка Enterprise Server для использования Oracle в качестве бэкенда зависит от того, как в вашей компании организовано управление базами данных Oracle. Некоторые компании запускают базы данных Oracle поверх ОС Windows Server, тогда как у других есть целые дата-центры Oracle. Процесс установки обычно включает три шага, как показано на следующем изображении.
Общий обзор процедуры установки Enterprise Server и базы данных Oracle.
Допущения, принятые в этом документе
Хотя конфигурации Oracle могут различаться от площадки к площадке, в этом документе сделаны несколько допущений:
- Установку выполняет ИТ-администратор. Как минимум пользователь, выполняющий установку Enterprise Server, должен иметь административные права на хост-машине.
- Enterprise Server установлен и работает на полноценной ОС Microsoft Windows.
- Oracle Client Connector установлен и работает на той же машине, на которой размещено приложение Enterprise Server.
- .NET Framework 4.8 и .NET Core 3.1.22 установлены и работают на той же машине, на которой размещено приложение Enterprise Server — если они отсутствуют, они автоматически устанавливаются в ходе установки Enterprise Server.
- Oracle Server должен работать на физически отдельной хост-машине по сравнению с приложением Enterprise Server.
- Oracle Schema и учётные данные приложения Oracle, используемые на исходном и целевом серверах Oracle, должны совпадать, если эта установка выполняется в рамках процесса миграции данных.
Обзор архитектуры Enterprise Server на высоком уровне
Как и другое ПО, рассчитанное на работу в Microsoft Windows, Enterprise Server — это многопоточное, многосервисное серверное приложение. Поскольку этот документ сосредоточен исключительно на частях Enterprise Server, которые могут взаимодействовать с Oracle Database, следующее изображение упрощено и отражает общую архитектуру бэкенда Enterprise Server.
Общий обзор архитектуры Enterprise Server. Backend Storages Enterprise Server содержит большую часть бинарных данных заказчика, а Windows Services — это набор вспомогательных служб.
Этот документ фокусируется на Backend Storages, поскольку данные в этом блоке резервируются, потенциально мигрируют на другую машину, а затем восстанавливаются либо на той же, либо на другой машине. В Backend Storages можно найти следующее:
- Databases – содержит метаданные, такие как сопоставление посадочного места компонента и условного графического обозначения, параметры, пути к файлам, ссылки на источники данных цепочки поставок компонентов и многое другое. Эта информация может находиться в базе данных Firebird или Oracle.
- File Storage – эта область File Storage хранит бинарные данные в VCS-репозитории Enterprise Server. Эти бинарные данные включают, например, документы проектов PCB и схем, посадочные места, символы, Draftsman и другие нативные или ненативные документы Enterprise Server.
Пример настройки Enterprise Server с бэкендом Oracle на платформе Windows
В этом примере инструкции также ориентированы на небольшие компании, у которых может не быть выделенного администратора баз данных Oracle (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-bit) или новее.
Рекомендуется: Windows Server 2019 Standard Edition (64-bit) .
- 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:
- Установите 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 на хост-машину 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, которое вы определили там.
- Username: по умолчанию SYSTEM. Если вы выполнили шаг 1-c, введите соответствующее имя пользователя, которое вы определили там (в примере — NEXUSUSER).
- Password: то же, что было задано на шаге 1-a или 1-c.
- Продолжите установку и настройку Enterprise Server, как описано в документе Installing Altium On-Prem Enterprise Server.
Upgrading from a Legacy Vault product to an Enterprise Server
При переходе с устаревшего Altium Vault (2.x, 3.x) на Enterprise Server это просто обновление путём запуска установщика Enterprise Server — так же, как ранее выполнялось обновление Altium Vault.
Одно важное требование для возможности обновления с legacy Vault до Enterprise Server при использовании ORACLE в качестве бэкенда базы данных — должна быть задана переменная окружения 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.