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

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

<div id="TOC">

</div>

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

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

Минимальные системные требования
	Сервер базы данных	Сервер приложения	Единый сервер	Сервер приложения	Единый сервер
		Без 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 лет.

Установка¶

• Содержание
• Системные требования
• Установка
  • Краткое описание устанавливаемой системы
  • Расположение необходимых компонентов для установки
  • Устанавливаемые компоненты
  • Варианты установки
  • Установка при помощи серверного установщика
    • Перед установкой
    • Установка
  • Руководство по установке клиентских мест
  • Установка компонентов по отдельности
• Схема работы системы
• Приложение
  • Основные файлы и каталоги
  • Пользователи
    • Пользователь администратор:
• Базы данных
  • СУБД
    • Включение/Выключение/Перезагрузка СУБД
  • База Omega Production. Общие понятия, правила, принципы
    • Хранение данных на сервере
  • Изменение размера табличных пространств
    • Oracle
      • Изменение размера OMP_IND и OMP_DB

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

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

Если технические возможности не позволяют иметь 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. Ждём окончания установки. Для улучшения установщика прислать текст из лога установщика bea@omp-system.ru. Желательно в названии письма указать название вашего производства
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 в том же каталоге

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

• Содержание
• Системные требования
• Установка
  • Краткое описание устанавливаемой системы
  • Расположение необходимых компонентов для установки
  • Устанавливаемые компоненты
  • Варианты установки
  • Установка при помощи серверного установщика
    • Перед установкой
    • Установка
  • Руководство по установке клиентских мест
  • Установка компонентов по отдельности
• Схема работы системы
• Приложение
  • Основные файлы и каталоги
  • Пользователи
    • Пользователь администратор:
• Базы данных
  • СУБД
    • Включение/Выключение/Перезагрузка СУБД
  • База Omega Production. Общие понятия, правила, принципы
    • Хранение данных на сервере
  • Изменение размера табличных пространств
    • Oracle
      • Изменение размера OMP_IND и OMP_DB

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

Пояснения к даграмме:

• 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. Общие понятия, правила, принципы
    • Хранение данных на сервере
  • Изменение размера табличных пространств
    • Oracle
      • Изменение размера OMP_IND и OMP_DB

СУБД¶

Проект 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 - это в гигабайтах)

[[]]