Книга II - Сервер управления (Miracle Base Program)
(рабочее место менеджера системы, часть №02)

Установка Сервера управления

  Следующие указания объяснят вам, как установить Сервер управления на ваш компьютер, работающий с Microsoft Windows 95/98/NT 4.1*/ME и подключенный к локальной сети.
  Данный программный продукт может быть установлен на любой активной машине в сети, отвечающей необходимым техническим требованиям для его работы.
  Для установки Сервера управления запустите программу Setup.exe с дистрибутивных дисков серверной части системы Miracle.

Что делает программа setup.exe

1. Распаковывает ctl3dv2.dll в Windows\SystI (если его там нет и версия Windows не 95).
2. Запускает mirinst.exe.

Что делает программа mirinst.exe

В дальнейшем вместо Miracle следует подставлять путь к каталогу Miracle

1. Проверяет наличие TCP/IP.
2. Проверяет наличие поставленного Сервера управления Miracle, если не находит, то запрашивает Miracle. В случае, если Miracle существует, спрашивает о необходимости замены существующей версии.
3. Проверяет необходимость и достаточность свободного места в Miracle.
4. Создает при необходимости Miracle.
5. Копирует/распаковывает следующие файлы в Miracle:
   • unrar.com
   • unrar.exe
   • unrar.pif
6. Распаковывает с использованием unrar следующие архивы в Miracle:
     С первого диска (если устанавливается сервер):
   • miracle.rar
   • mirconf.rar
   • mirdata.rar
   • picture.rar
   
     Со второго диска (если устанавливается неполный клиент, то первые два):
   • mirdll.rar
   • mirtools.rar
   • mirdbc.rar
   • mirfgen.rar
   • mirtgen.rar
   • mirmath.rar
   • mirmig.rar
   • mirrep.rar
   • mirtrmon.rar
   
     С третьего диска:
   • vbxdll.rar
   • sound.rar
   
     С четвертого диска:
   • idapidll.rar
   • ibasedll.rar - для InterBase
   • sybasdll.rar - для SyBase или MS SQL
   
     С пятого диска:
   • oracledll.rar - для Oracle
   • orac6dll.rar - для Oracle 6
   • orac7dll.rar - для Oracle 7
   • infr4dll.rar - для Informix 4
   • infr5dll.rar - для Informix 5
   • odbcdll.rar - для ODBC
   
     При этом автоматически создаются необходимые подкаталоги.
7. В win.ini добавляет (изменяет) строки:
   • [IDAPI]
     1. CONFIGFILE01=Miracle\miracle\miracle\idapi.cfg
     2. IDAPIDLL=Miracle\miracle\miracle
   • [Borland Language Drivers]
     1. LDPath=Miracle\miracle\miracle
     Старый win.ini сохраняется под именем win.mir
8. Запрашивает и записывает часовой пояс в timezone.mir.
9. Создает в Program Manager (Explorer) группу (папку) Miracle.

  Пункты с 7 по  9 выполняются только для начальной установки сервера.

Рабочий каталог программы Сервер управления

  Структура рабочих каталог программы:

  Структура системы строго задана. Какое-либо изменение, либо переименование, не допускается. После установки программного продукта - Cервер управления, необходимо:

• Создать БД
• Настроить интегрированный интерфейс доступа к БД

Создание БД

  Система Miracle использует для своей работы имеющийся у вас SQL-сервер. (Через настройку интегрированного протокола доступа к БД, IDAPI). При этом система Miracle не создает БД, а только проектирует в ней необходимые объекты (таблицы). Поэтому прежде, чем начать работу с системой, Вам необходимо подготовить БД штатными средствами сервера баз данных. Создание БД включает в себя организацию файла базы данных и настройку режима его работы. Практическое использование этой БД, как то подготовка необходимой структуры таблиц, ввод и извлечение информации, осуществляется средствами системы Miracle.

Установка доступа к СУБД (SQL-серверу)

  Доступ Miracle-решений, работающих с Сервером БД, осуществляется согласно настройкам файла IDAPI.CFG . Следует отметить, что настройка данного конфигурационного файла производится только через специализированную программу, поставляемую с Сервером управления. Все остальные участники получают настройки при авторизации рабочих мест, не участвуя в установке собственных настроек.

Настройка интегрированного интерфейса IDAPI для доступа к Базе Данных

  IDAPI - интегрированный интерфейс для доступа к Базе Данных фирмы Borland. (http://www.borland.com/bde)

  Настройка интегрированного интерфейса IDAPI осуществляется путем активизации программы Idapi config. Программа входит в комплект штатной поставки серверной части системы Miracle, и после инсталляции располагается в одной папке с программой Сервер управления .

Драйвер доступа к SQL-серверу

  В комплект поставки входят следующие драйвера:

• Borland SQL Links for Connecting to InterBase
• Borland SQL Links for Connecting to Informix
• Borland SQL Links for Connecting to ORACLE
• Borland SQL Links for Connecting to SYBASE and Microsoft SQL-Server

Рисунок 5 Пример IDAPI.CFG, настройка Drivers

  Настройки параметров в режиме Drivers

Пояснение механизма работы параметра SQLPASSTHRU MODE

  Данный параметр может иметь различные настройки, каждая из которых влияет на режим работы с БД.

• NOT SHARED - режим работы без автоматического завершения транзакций. Устанавливая данный режим, доступ к новым записям в БД будет доступен только после повторного подключения к базе.

• SHARED AUTOCOMMIT - режим автоматического завершения транзакций. В данном режиме, доступ к новым записям будет доступен сразу после их создания. Следует отметить, что режим - завершения транзакций, выполняется системой Miracle самостоятельно. Это делает не целесообразным повторное завершение транзакции на уровне интерфейса взаимодействия с БД.

• SHARED NOAUTOCOMMIT - режим неавтоматического завершения транзакций. В данном режиме доступ к новым записям будет доступен сразу после их создания. Данный режим наиболее целесообразен для работы с истемы Miracle.

Настройка доступа к выбранной СУБД (SQL-серверу)

Рисунок 6 Пример IDAPI.CFG, настройка Aliases

  Настройка параметров в режиме Aliases

Настройка системных параметров работы настраиваемого SQL-сервера

Рисунок 7 Пример IDAPI.CFG, настройка SystI

  Настройка параметров в режиме SystI

Настройка параметров типа Дата

Рисунок 8 Пример IDAPI.CFG, настройка Date

  Настройка параметров в режиме Date

Обеспечение соответствия формата Date Базы данных и системы Miracle.

  Производя настройки формата Data, в области SEPARATOR и MODE, вы задаете необходимый формат дата который будет использоваться для общения с БД.
  Следует заметить, что этот формат не влияет как вы будете представлять или позволять вводить информацию типа дата&время, или в каком виде эта информация будет храниться. Синхронизация формата записи Data необходима для корректного построения SQL-предложений.
  Так как система Miracle поддерживает работу с различными SQL-серверами то для программиста ведущего разработку средствами системы Miracle методы работы с полями типа Дата всегда остаются одинаковыми, вне зависимости от типа используемой БД.
  Формат Data понимаемой БД, специфичен для каждой базы данных, как и способ ее настройки.
  Формат Data используемой системой Miracle задается настройками конфигурационного файла IDAPI.CFG
  Система Miracle обеспечивает необходимой совместимостью, проверяя способ записи формата Data на соответствие с форматом принятом в используемой БД.
  Если система находит несоответствие то:

• Производится попытка синхронизации форматов.
• При неуспешной синхронизации - выдается сообщение о невозможности исправления ситуации.

  Для обеспечения совместимости формата Data необходимо самостоятельно провести мероприятия по синхронизации описания в конфигурационном файле IDAPI.CFG и настройки используемого Сервера баз данных.

Спецификации формата Data для разных Серверов баз данных

1. Для MS-SQL, SyBase

   MS-SQL и SyBase поддерживает 3 формата Data, различающихся порядком следования дня, месяца и года. При использовании произвольного разделителя. Одновременно поддерживается только один формат. С инхронизация форматов с MS-SQL, SyBase требует поддержи одного порядка следования и разделителя заданных на сервере БД и установленных в конфигурации IDAPI.

2. Для InterBase
   

   InterBase поддерживает 3 формата Data, отличающихся друг от друга порядком следования и одновременно с этим отличаются используемым разделителем.

   • DD.MM.YYYY
   • MM-DD-YYYY
   • MM/DD/YYYY

   InterBase поддерживает все эти форматы одновременно. Важно что бы в настройках конфигурационного файла IDAPI.CFG порядок следования задаваемый в области MODE соответствовал установленному разделителю - область SEPARATOR.
   InterBase не поддерживает 12-ти часовой формат времени.

3. Для Oracle

   Oracle поддерживает широкий набор формата Data. Используемый формат определяется шаблоном. Одновременно поддерживается только один формат в точности соответствующий описанию шаблона.
   Шаблон может быть задан в файле oracle.ini на каждой клиентской машине. Формат шаблона может иметь следующий вид: htl_data_format=‘dd.mm.yyyy hh24:mi:ss’ или иной в зависимости от ваших потребностей. В любом случае необходимо синхронизировать настройку в конфигурационном файле IDAPI.CFG и используемого шаблона.

4. Для Paradox
   Paradox поддерживает единственный формат Data:
   
   • SEPARATOR - /
   • MODE - соответствующую MM/DD/YYYY
   Paradox не понимает 12-ти часовой формат записи времени.

Общее правило использования настроек конфигурационного файла IDAPI.CFG системой Miracle

• Использует закладку Data для формирования записи Data в SQL-предложениях;
• Использует закладку Time для формирования записи Time в SQL-предложениях;
• Порядок следования в SQL-предложениях следующий:
  “Data Time” (“31.12.1997 23:15:00”)

  Если используется 12-ти часовой формат записи времени, то порядок следования в SQL-предложениях следующий:
  “Data Time” (“31.12.1997 11:15:00 PM”)

Автоматическая настройка провидимая системой Miracle

  В случае обнаружения не соответствия формата Data настроенного в конфигурационном файле IDAPI.CFG и формата Data используемого в SQL-сервере система Miracle предпринимает попытку настройки формат Data Сервера БД, для:

1. Для MS-SQL (SyBase) - SET DATEFORMAT “<шаблон>”, формат шаблона определяется настройкой в конфигурационном файле IDAPI.CFG Данная настройка носит временный характер действующего только в рамках текущей сессии.

2. Для Oracle - настройка формата осуществляется через команду:
   Alter Session set hls_data_format=‘<шаблон>’, формат шаблона определяется настройкой в конфигурационном файле IDAPI.CFG

3. Данная настройка носит временный характер действующего только в рамках текущей сессии.

4. Для всех остальных случаях (для InterBase, Paradox), система Miracle поступает следующим образом:
   Вносятся временные изменения в настройки конфигурационного файла IDAPI.CFG. Т.е. система Miracle изменяет настройки применяя следующий формат - MM/DD/YYYY и устанавливает 12-ти часовой формат записи времени. Все остальные настройки сохраняются. Если этот формат успешно воспринимается базой данных, то на протяжении текущей сессии работы системы Miracle будет использоваться этот формат.

Настройка параметров типа Время

Рисунок 9 Пример IDAPI.CFG, настройка Time

  Настройка параметров в режиме Time

Настройка параметров типа Число

Рисунок 10 Пример IDAPI.CFG, настройка Number

  Настройка параметров в режиме Number

Служебные файлы Сервера управления

  Сервер управления формирует журнал работы и сохраняет его содержание в файле MIRACLE.LOG Данный файл создается в директории запуска и содержит описание работы Сервера управления. Каждое действие, производимое сервером, отражается одной строкой состояния.
  Структура строки состояния:

• [день недели]
• [дата]
• [время]
• <параметры авторизации пользователя>
• <состояние>

Пример содержимого журнала работ

Вт 10-июн-97, 18:57:38, Начало
Вт 10-июн-97, 18:57:44, Структура, Модель фирмы
Вт 10-июн-97, 19:01:20, Модель фирмы, Программисты , Иванов Иван,
	Авторизован
Вт 10-июн-97, 19:01:20, Модель фирмы, Программисты , Иванов Иван,
	Синхронизация времени
Вт 10-июн-97, 19:01:20, Модель фирмы, Программисты , Иванов Иван,
	Список файлов,miracle\miracle\scenario.ini
Вт 10-июн-97, 19:01:21, Модель фирмы, Программисты , Иванов Иван,
	Файл, miracle\miracle\idapi.cfg
Вт 10-июн-97, 19:01:21, Модель фирмы, Программисты , Иванов Иван,
	Файл передан успешно
Вт 10-июн-97, 19:01:33, Модель фирмы, Программисты , Иванов Иван,
	Получение шифрованного пароля
Вт 10-июн-97, 19:01:44, Модель фирмы, Программисты , Иванов Иван,
	Общая задача, Задача N 1
Вт 10-июн-97, 19:01:49, Модель фирмы, Программисты , Иванов Иван,
	Авторизация доступа к БД
Вт 10-июн-97, 19:12:19, Модель фирмы, Программисты , Иванов Иван,
Закончил