Проект

Общее

Профиль

Действия
История

TechnicalDocumentation » История » Редакция 30

« Предыдущее | Редакция 30/49 (Разница(diff)) | Следующее »
BEA, 23.10.2024 19:36

Руководство по Omega Production для пользователей-администраторов

Данная документация является сборником вики страниц с сайта по поддержке пользователей Omega Production.
Если есть возможность воспользоваться онлайн веерсией то рекомендуется воспользоваться ей: Вики Omega Production

link text

Системные требования

Для соблюдения минимальных системных требований возможно использование единого сервера для приложения и для базы данных
Не рекомнедуется использовать виртуальные локальные сети так как зачастую скорость сети Интернет не даёт необходимой скорости без задержек

Минимальные системные требования
Сервер базы данных Сервер приложения Единый сервер Сервер приложения Единый сервер
Без REST сервера и планировщика С REST севером и планировщиком
Процессор (схожий по зарактеристикам с указанным) Intel i7 6700K Intel i3 4Gen Intel i7 6700K Intel i7 4Gen Intel i7 8Gen
Оперативная память 16 Гб 4 Гб 16 Гб 16 Гб 32 Гб
Дисковая память SSD 500 Гб 2 Гб свободного места SSD 500 Гб + 2 Гб свободного места 2 Гб свободного места SSD 500 Гб + 2 Гб свободного места
Сеть локальная сеть (физическая или виртуальная) со скоростью 100 Мбит/с
Рекомендуемые системные требования
Сервер базы данных Сервер приложения
Без REST сервера и планировщика С REST севером и планировщиком
Процессор (схожий по зарактеристикам с указанным) Intel Xeon Silver 4208 Intel i7 4Gen Intel i7 8Gen
Оперативная память 128 Гб 16 Гб 64 Гб
Дисковая память SSD 2 Тб 2 Гб свободного места 2 Гб свободного места
Сеть физическая локальная сеть со скоростью 1 Гбит/с

Для новых клиентов:
Данные характеристики указаны с расчётом постепенного роста базы пользователей в периоде 2-5 лет.

Установка

Краткое описание устанавливаемой системы

Для понимания куда необходимо устанавливать компоненты ПО ниже представлена краткая схема работы системы:

Если технические возможности не позволяют иметь 2 сервера то можете установить систему на 1 одном сервере.

Расположение необходимых компонентов для установки

Все материалы для начала работы с Omega Production можно загрузить с нашего FTP сервера (ftp://demo:demo@internal.omp-system.ru):
  • Архив omp_install.rar - архив с серверным установщиком ПО Omega Production.
    Содержит OmegaSetup.exe и все прочие файлы необходимые для установки (включая исходную базу данных Omega Production)
  • Архив omp_docs - архив с документацией по работе с ПО
  • Каталог ServerDistr - содержит устанавливаемые компоненты по отдельности (не установщик). Подробнее смотрите в
  • Архив win32_12201_client.zip - СУБД клиент х32 Oracle
  • Архив winx64_12201_client.zip - СУБД клиент х64 Oracle
  • Архив winx64_12201_database.zip - СУБД сервер х64 Oracle

Устанавливаемые компоненты

  • сервер базы данных
    • Oracle Database + исходная база данных для Omega Production
  • сервер приложений:
    • Oracle Client
    • файлы приложения Omega Production

Варианты установки

Можно установить двумя способами:
  • Серверный установщик (omp_install.rar). Включает в себя все компоненты
  • Установка компонентов по отдельности. Удобен при частичной установке (например, создание тестовой базы)

Установка при помощи серверного установщика

Перед установкой

Обязательно ознакомиться с системными требованиями!
Перед запуском установщика можно расположить License.dat (выданный файл с лицензии) рядом с OmegaSetup.exe

Установка

  1. Запустить установщик OmegaSetup.exe (откуда брать смотреть раздел Расположение необходимых компонентов для установки)
  2. Вкладка Каталог установки. Указываем путь куда установить файлы:
    • В случае установки компонента Oracle и БД для Omega - файлы администрирования установки и файлы инструменты по администрированию БД
    • В случае установки компонента Omega Production - файлы администрирования установки и файлы самого приложения
      !!!Внимание. Каталог указанный по умолчанию не всегда оптимальный выбор!!!
  3. Вкладка Выбор компонентов. Компоненты могут устанавливаться на одну машину но рекомендуется для распределения нагрузки на разные.
    • Omega Production - сервер приложений. Устанавливается приложение Omega Production которое будут использовать остальные пользователи и откуда будет запускаться REST-сервер
    • Oracle и БД для Omega - сервер баз данных. Устанавливается СУБД Oracle и устанавливаются база данных Omega Production
    • VC Redist - компонент программ Майкрософт для корректной работы компонента Omega Production
  4. На вкладке Лицензия:
    • Если файл лицензии не найден автоматически то указываем путь к файлу лицензии (для автоматического определения необходимо расположить License.dat рядом с OmegaSetup.exe)
  5. На вкладке Oracle и БД для Omega:
    • ORACLE_BASE - путь куда устанавливается весь комплект СУБД Oracle ( такое имя ему дается в регистре )
    • ORACLE_HOME - путь куда устанавливается основные инструменты СУБД Oracle ( Заполняется автоматически. Такое имя ему дается в регистре )
    • Пароль от sys - системный пользователь в СУБД Oracle. Необходимо соблюдать политику паролей oracle. Ссылка на документацию: ссылка (если не открывается то ищите в сети Интернет вручную)
    • Пароль от system - системный пользователь в СУБД Oracle. Необходимо соблюдать политику паролей oracle. Ссылка на документацию: ссылка (если не открывается то ищите в сети Интернет вручную)
    • Путь к файлам данных Oracle - путь к файлам формата .dbf где лежат все данные СУБД Oracle.
    • Имя базы - наименование одного из управляющих БД объектов в Oracle. Обычно мы именуем этот объект omega
    • Объём выделяемой ОЗУ - объём оперативной памяти которое будет использовать Oracle. !!!Внимание!!! Для выставления данного значения ознакомиться с системными требованиями!
      Данные настройки рекомендуется запомнить. В дальнейшем будут использоваться в прочих настройках.
  6. При установке СУБД Oracle откроется отдельная консоль. При окончании установки консоль ждёт чтобы вы нажали любую клавишу. (специфика установщика Oracle)
  7. Ждём окончания установки. Для улучшения установщика прислать текст из лога установщика . Желательно в названии письма указать название вашего производства
  8. [Для версии x32] Установить клиентскую версию x32 СУБД Oracle. (откуда брать смотреть раздел Расположение необходимых компонентов для установки) Сделать папку с установленным клиентом доступной в вашей сети производства
  9. [Опционально] Установить клиентскую версию x64 СУБД Oracle. (откуда брать смотреть раздел Расположение необходимых компонентов для установки) Сделать папку с установленным клиентом доступной в вашей сети производства
  10. Если не сделали пункт 7 то сделать папку ORACLE_HOME с установленной серверной версией Oracle доступной в вашей сети производства.
  11. Настроить клиентский установщик в папке <путь куда установили через установщик>\Omega\Install по readme

Руководство по установке клиентских мест

Инсталляция на клиентские места делается при помощи клиентского установщика. Обычно он поставляется вместе с файлами приложения. (каталог ClientInstaller)
Если у вас такого установщика нет то его можно скачать из FTP сервера (ftp://demo:demo@internal.omp-system.ru) ClientInstaller_2017.rar в каталоге ServerDistr

Перед установкой клиентских мест нужно откорректировать файл OMPINST.INI:
  • в секциях [Oracle] и [Oracle 64]:
    • указать Имя базы указанное при серверной установке выше (обычно это omega)
    • в переменной PATH указать путь как в ORACLE_HOME
  • в секции [Omega Production]
    • в переменной PATH указать путь к папке Omega, в которой находятся папки App32 и App64 с исполняемыми файлами Omega
  • в секции [Omega Production Doc]
    • в переменной PATH указать путь к документации

После запустить на клиентском месте OmegaSetup.exe

Для использования msi версии установщика msi\OmegaSetup.msi применяются следующие параметры (и их значения по умолчанию, если переменная не задана):
  • OMEGA32INSTALL=1 - устанавливать x86 версию Омеги
  • OMEGA64INSTALL=1 - устанавливать x64 версию Омеги
    Обязательно требуется задать один или оба параметра OMEGA32INSTALL и OMEGA64INSTALL
  • OMEGADIR - путь к папке, содержащей папки App32 и App64. Обязательный параметр
  • DOCINSTALL=1 - устанавливать документацию
  • DOCDIR - путь к папке с документацией. Используется если DOCINSTALL=1
  • ORA32INSTALL=1 - использовать x86 версию oracle
  • ORA32DIR - путь к x86 версии oracle. Используется если ORA32INSTALL=1
  • ORA32SID=OMEGA - имя базы данных. Используется если ORA32INSTALL=1
  • ORA64INSTALL=1 - использовать x64 версию oracle
  • ORA64DIR - путь к x64 версии oracle. Используется если ORA64INSTALL=1
  • ORA64SID=OMEGA - имя базы данных. Используется если ORA64INSTALL=1
  • FONTINSTALL=1 - Устанавливать шрифты

Пример запуска:

c:\omega\OmegaSetup.msi /q /L*v c:\omega\install.log OMEGADIR=\\omp04\Omega\Daily ORA32DIR=\\omp03\client_1\ ORA64DIR=\\omp03\dbhome_1 DOCDIR=\\omp03\Docs\DocPDF\Doc

msi установщик не ставит vcredist и .net, их нужно установить дополнительно из папки vcredist

Установка компонентов по отдельности

Как устанавливать отдельно описано в документе OmegaProductionInstall.doc в том же каталоге

Схема работы системы

Подробная диаграмма работы системы:


Пояснения к даграмме:
  • REST Сервер (он же RestWeb.exe в файлах приложения Omega Production) - фоновая программа-служба (может управляться при помощи ПО "Службы" Windows) которая предоставляет API для взаимодействия с системой Omega Production иным ПО. К примеру часть интеграций с другими системами реализовано через REST сервер.
  • Планировщик (он же OmpJobService.exe в файлах приложения Omega Production) - фоновая программа-служба (может управляться при помощи ПО "Службы" Windows) которая позволяет автоматически выполнять отложенные операции заданные в Omega Production в "Планировщике задач". К примеру разного рода расчёты которые нужно производить ежедневно помле определённой работы сотрудников в системе.
  • Инструмент управления REST сервером и планировщиком (он же OmpJobRunner.exe в файлах приложения Omega Production) - приложение с графическим интерфейсом позволяющее включать/выключать/настраивать REST сервер и Планировщик
  • Механизмы СУБД здесь не рассмотрены. Рассмотрена только та часть механизма которая затронута нами(а также только то что схоже в различных СУБД).
    С механизмами работы СУБД можно ознакомится в их документации в сети Интернет
  • В сервере приложений упоминается драйвер при помощи которого отправляются SQL запросы. Данный драйвер может различаться у разных СУБД.
    Данная диаграмма отталкивается в основном от работы с СУБД Oracle в котором драйвером является клиент базы данных.

Приложение

Основные файлы и каталоги

  • Каталог ini - в нём сожержаться настройки текущего инстанса Omega Production. Подробнее: ссылка
  • Логи работы Omega Production можно найти в стандартном временном каталоге Windows: %TEMP% (C:\Пользователи\<Имя пользователя>\AppData\Local\Temp)
    • Логи работы приложения:
    • Логи работы рест сервера:
    • Логи работы планировщика:

Пользователи

Пользователь администратор:

Имеет логин соответствующий названию базы данных Omega Production. Пароль при импорте базы в СУБД изначально также соответствует логину. Однако позднее можно поменять. К примеру:
Имя базы по умолчанию OMP_ADM. Логин и пароль пользователя администратора старте работы с базой Omega Production соответственно OMP_ADM.
Внимание: пароль данного пользователя не шифруется! Сделано это для упрощенного доступа этому же пользователю через инструменты СУБД

Базы данных

СУБД

Проект Omega Production поддерживает 2 вида СУБД:
  • Oracle
  • PostgreSQL - бета версия

Что такое СУБД? СУБД - Система Управления Базами Данных. Подробнее с понятием СУБД можно ознакомится в сети интернет

Включение/Выключение/Перезагрузка СУБД

Как СУБД Oracle так и СУБД PostgreSQL включаются/выключаются посредством служб.
К примеру в Windows системная программа "Службы"("Services"):
Ниже на скриншоте представлены 2 службы (название может немного отличаться) которые надо перезапустить (OracleOraDB12HomeTNSListener желательно но не обязательно). Название у остальных служб СУБД схожее

Если на данном сервере нет ничего важного кроме СУБД, то можно просто перезагрузить сервер

База Omega Production. Общие понятия, правила, принципы

Хранение данных на сервере

Данные базы Omega Production храняться в табличных пространствах. Табличные пространства - объект в СУБД управляющий физическим хранилищем. Логически мы делим БД на 2 или 3 табличных пространства:
  • OMP_DB - основное хранилище данных
  • OMP_IND - хранилище для идексов(объекты управляющие поиском и ограничениями по данным)
  • [Опционально] OMP_FLS - хранилище файлов. Обычно используется либо для распределния объёма данных или ради безопасности

По мере роста данных в Omega Production необходимо расширять табличные пространства. Подробнее...

Изменение размера табличных пространств

Oracle

Пускать все запросы под пользователем sys.

Проверить размер табличных пространств можно:
  • SQL Developer:
    ПКМ по подключению через sys и опция manage database
  • SQL запрос:
    select 
  df.tablespace_name "Tablespace",
  totalusedspace "Used MB",
  (df.totalspace - tu.totalusedspace) "Free MB",
  df.totalspace "Total MB" 
from 
  (
    select 
      tablespace_name,
      round(sum(bytes) / 1048576) TotalSpace
    from dba_data_files
    group by tablespace_name
  ) df,
  (
    select round(sum(bytes)/(1024*1024)) totalusedspace, tablespace_name
    from dba_segments
    group by tablespace_name
  ) tu
  where df.tablespace_name = tu.tablespace_name ;

Запрос который напомнит где файлы .dbf лежат:

select name from v$datafile;

Изменение размера OMP_IND и OMP_DB

SQL запрос для изменения размера табличного пространства (одного .dbf файла)
alter database datafile '<filePath>' resize <newSize>M;

Где:
  • <filePath> - абсолютный путь файла .dbf размер которого собираетесь изменить
  • <newSize> - новый размер в мегабайтах (можно указывать и в других размерностях но тогда нужно изменить букву которая следует после этого значения. К примеру если указать G - это в гигабайтах)

Oracle

Версия Oracle

Наиболее используемая версия и та что выдаётся по умолчанию для новых клиентов: Oracle Enterprise Edition 12c Release 2
Также наш функционал ещё поддерживается на таких версиях как:
  • Oracle Enterprise Edition 12c Release 1
  • Oracle Enterprise Edition 11g

БД Omega Production в Oracle

В Oracle все объекты принадлежат какому либо пользователю. Учётная запись пользователя + объекты принадлежащие ей называется схемой в Oracle.
Для сокращения и простоты понимания для заказчиков под базой данных Omega Production подразумевается схема в Oracle содержащая разработанные нами объекты.
Схема именуется также как и пользователь владеющий объектами в ней. Пользователь владеющий всеми объектами схемы в ПО Omega Production является пользователем администратором.

Файловая архитектура важных файлов в Oracle

У Oracle есть 2 понятия где установлено их ПО:
  • ORACLE_BASE - путь где установлен набор программ одной версии
  • ORACLE_HOME - путь где установлена конкретная программа (к примеру: клиент х32, клиент х64, сервер х64)

Пример: при установке Oracle ORACLE_BASE был выбран как C:\app тогда

Каталог product - по умолчанию где будут устанавливаться основные программы от Oracle. Остальноые каталоги содержат прочие конфигурации и логи.
В самом же каталоге product по умолчанию расположены программы от Oracle по относительному пути такого формата: <версия>/<программа_N>. Данное расположение и будет являться ORACLE_HOME. Пример на скриншотах ниже.
Скриншот из проводника:

Скриншот из рееста со значениями ORACLE_BASE и ORACLE_HOME:

Для администрирования и настройки в работе с Omega нас интересуют лишь несколько путей:
  • Исполняемые файлы: ORACLE_HOME/bin Папка где расположены бинарные файлы (.exe, .dll и прочие) для запуска установленных приложений от Oracle.
    В частности: для запуска запросов нам нужны SQL developer (sqldeveloper.exe) и SQL Plus (sqlplus.exe), для импорта/экспорта дампов баз отсюда вызывается impdp.exe и expdp.exe.
    Путь к данной папке должен присутствовать в PATH и в реестре как ORACLE_HOME.
  • Сетевые настройки: ORACLE_HOME/network Папка где расположены нужные настройки для сети. Базовые файлы настроек необходимые нам расположены в подпапке admin.
    В частности: файл tnsnames.ora, файл sqlnet.ora. Подробнее в Oracle: Настройка.
  • Настройки СУБД: ORACLE_HOME/database расположены файлы настроек работы Oracle. В случае невозможности включения Oracle из за настроек можно подправить здесь
  • Удаление СУБД: ORACLE_HOME/deinstall здесь расположен инструмент для правильного удаления Oracle. Крайне не рекомендуется прибегать к ручному удалению а использовать именно этот инструмент.
  • Логгирование: ORACLE_BASE/diag/rdbms/<имя базы>/<имя базы>/trace путь где лежит alert_<имя базы>.log который в серверном Oracle Database ведёт подробный лог работы СУБД
    С остальной информацией о логах предоставляемых Oracle вы можете ознакомится в разделе Логов Oracle

Установка

Сервер Oracle Database 12c

Установку нужно производить под пользователем из группы Administrators. Обычно это Administrator.
Имя пользователя не должно содержать русские буквы.

  1. Указываем почтовый ящик или оставляем поле незаполненным. Галочку I wish to receive security updates via My Oracle Support снимаем.
  2. Если почтовый ящик не указан, то появится диалог:

    Жмем кнопку 'Yes'.
  3. Выбираем пункт Create and configure a database
  4. Выбираем Server class
  5. Выбираем Single instance database installation
  6. Выбираем Advanced install
  7. Выбираем Enterprise Edition
  8. Выбираем Use Virtual Account
  9. Указываем размещение файлов Oracle – Oracle base. Software location не трогаем.
  10. Выбираем General Purpose / Transaction Processing
  11. Указываем Global database name: omega. SID такой же.
    Галочку Create as Container database снимаем.
  12. Выделяем под oracle память, сколько не жалко и сколько есть возможность. Не забываем оставить системе несколько гигабайт.
    Галочку Enable Automatic Memory Management снимаем
  13. Выбираем пункт с кодировкой CL8MSWIN1251
  14. Указываем расположение файлов данных. В идеале это должен быть другой физический диск
  15. Галочку не ставим
  16. Обычно мы не включаем Enable Recovery, но если у заказчика есть опытный DBA, то они могут это использовать.
  17. Указываем пароли. Если используется один пароль, то выбираем второй пункт
  18. Проходим проверки
  19. Переходим непосредственно к установке
  20. Далее будет произведена установка и настройка служб oracle. Если выдаст ошибку, что не удалось установить Enterprise Manager Database Control, то это игнорируем и настраиваем из toad.
  21. После установки oracle обязательно нужно запустить батник after_oracle_12_install.cmd (вместе с ним необходим after_oracle_12_install.sql)
  22. Далее требуется создать табличные пространства omp_db и omp_ind, размером по 10Gb или более. Это делается при помощи cre_tablespaces.cmd (вместе с ним необходим cre_tablespaces.sql)

Клиент Oracle Client 12c

  1. Выбираем пункт Administrator.
  2. По умолчанию выбираем use windows built-in account. Если хотите можете задать конкретнго юзера
  3. Выбираем путь установки
  4. Нажать кнопку «Готово»
  5. Процесс установки
  6. Финиш
  7. Настроить tnsnames.ora
    Посмотреть параметры подключения к базе в tnsnames.ora серверной части (ORACLE_HOME/network/admin) и прописать их в клиентской

OracleInstall ]] ]]

Обновлено BEA 4 месяца назад · 30 изменени(я, ий)