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

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

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

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

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

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

Установка¶

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

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

Обязательно ознакомиться с системными требованиями!

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

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

• сервер базы данных - Oracle Database или PostgreSQL Server + БД Omega Production
• сервер приложений:
  • [Опционально: только для Oracle] Oracle Client
  • файлы приложения Omega Production

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

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

FTP сервер: компоненты для установки¶

Использовать данный раздел только в случае если это не первичная установка и вам не было отпрвлено ни ссылки ни архива с файлами установки.

Все материалы для начала работы с Omega Production можно загрузить с нашего FTP сервера (ftp://demo:demo@internal.omp-system.ru):

• Каталог ServerInstaller - каталог с серверным установщиком ПО Omega Production.
• Архив omp_docs - архив с документацией по работе с ПО
• Каталог ServerDistr - содержит устанавливаемые компоненты по отдельности (не установщик). Подробнее смотрите в

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

Можно установить двумя способами:

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

Для версии с СУБД PostgreSQL пока что возможен только такой способ установки "Установка компонентов по отдельности"

Установка при помощи серверного установщика (Только для Oracle версии)¶

ПоказатьСкрыть

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

Сервер базы данных¶

1. Устанваливаем СУБД и подготавливаем СУБД для работы с БД Omega Production
   • Oracle: СУБД Oracle приобретаем самостоятельно на ресурсах компании Oracle. Для помощи в этом вопросе можете связаться с нашим отделом поддержки. Процесс установки Ссылка на инструкцию
   • PostgreSQL: Ссылка на инструкцию
2. Импорт дампа:
   • Oracle: взять из скачанного дистрипутива по пути DB\omp\dmp\oracle\ 4 файла CLR_ADM<N>.DMPDP и импортировать по инструкции (ссылка)
   • PostgreSQL: взять из скачанного дистрипутива по пути DB\omp\dmp\postgres\ файл omp_adm.sql и импортировать по инструкции (ссылка)

Сервер приложений¶

1. Создать каталог для приложения Omega Production и сделать доступным по сети
2. Поместить содержимое каталога OMEGA из скачанного дистрибутива в созданный каталог в пункте 1
3. Внутри папок приложения скопированных в пункте 2 в каждой разрядности (App32, App64) создать каталог ini
4. В папках созданных в пункте 3 создать файл OMP_DB.ini и настроить согласно шаблону OMP_DB_TEMPLATE.ini из скачанного дистрибутива
5. В папки созданные в пункте 3 скопировать TLE.ini из скачанного дистрибутива
6. Поместить в папку созданную в пункте 3 файл лиценизии
7. Провести первый запуск Omega Production для инициализации

Установка Omega Production на компьютеры пользователей¶

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

Перед установкой клиентских мест нужно откорректировать файл OMPINST.INI:

• Oracle параметры ( для PostgreSQL в Install указать 0 и пропустить ):
  • в секциях [Oracle] и [Oracle 64]:
    • указать Имя базы указанное при установке СУБД ранее (обычно это omega)
    • в переменной PATH указать путь как в ORACLE_HOME
    • в переменной Install указать 1 если использовать данную версию Oracle или 0 если не использовать
• Общие настройки:
  • в секции [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

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

• Содержание
• Системные требования
• Установка
  • Перед установкой
  • Краткое описание устанавливаемой системы
  • FTP сервер: компоненты для установки
  • Варианты установки
  • Установка при помощи серверного установщика (Только для Oracle версии)
  • Установка компонентов по отдельности
    • Сервер базы данных
    • Сервер приложений
  • Установка Omega Production на компьютеры пользователей
• Схема работы системы
• Приложение
  • Основные файлы и каталоги
  • Пользователи
    • Пользователь администратор:
• Базы данных
  • СУБД
    • Включение/Выключение/Перезагрузка СУБД
  • База 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.
Внимание: пароль данного пользователя не шифруется! Сделано это для упрощенного доступа этому же пользователю через инструменты СУБД

Базы данных¶

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

СУБД¶

Проект Omega Production поддерживает 2 вида СУБД:

• Oracle
• PostgreSQL - бета версия

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

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

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

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

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

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

Имеет логин соответствующий названию базы данных Omega Production. Данный пользователь является владельцем логического объекта в СУБД который хранит всю базу данных. В случае с Oracle это schema. В случае с PostgreSQL это database. Данный метод хранения базы позволяет использовать несколько баз на одном сервере СУБД будь то база Omega Production или любая другая (1С и прочие)

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

Данные базы 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 - это в гигабайтах)

[[]]