Подключение к базе данных системы "ДБО BS-Client"

[Примечание] Примечание

Для проведения миграции данных из системы "ДБО BS-Client" в систему "Corporate" необходимо иметь доступ под ролью администратора к системе "ДБО BS-Client" и иметь возможность подключаться к базе данных указанной системы.

Формирование значений реквизитов подключения к базе данных системы "ДБО BS-Client" средствами системы "Corporate" выполняется через интерфейс администрирования системы "Corporate". Для доступа к данному интерфейсу администрирования необходимо иметь соответствующие права.

Для работы с системой "ДБО BS-Client" руководствуйтесь документацией на указанную систему.

Для работы с серверами приложений руководствуйтесь документацией на данные сервера приложений.

Для проведения миграции данных из системы "ДБО BS-Client" в систему "Corporate" необходимо установить подключение к базе данных системы "ДБО BS-Client". Особенности настройки данного подключения описаны в разд. «Подключение к БД системы "ДБО BS-Client"».

Для настройки подключения к базе данных "ДБО BS-Client":

  1. Выберите пункт Администрирование системы → Миграция ДБО3 → Конфигурация главного меню.

  2. Откроется форма Конфигурация.

    Рис. 4.1239. Форма Конфигурация

    Нажмите для масштабирования

  3. На форме Конфигурация представлены реквизиты подключения к базе данных системы "ДБО BS-Client".

    Заполнение данных реквизитов производится в два этапа: значения данных реквизитов формируются определенным образом и затем указываются в полях формы Конфигурация.

    Значения реквизитов подключения к базе данных могут быть сформированы средствами системы "Corporate" и средствами сервера приложений (подробнее см. в разд. «Подключение к БД системы "ДБО BS-Client"»).

  4. Сформируйте значения реквизитов подключения к базе данных:

    • Средствами системы "Corporate":

      1. Авторизуйтесь в интерфейсе администрирования платформы.

        [Примечание] Примечание

        Для работы с интерфейсом администрирования платформы необходимо иметь соответствующие полномочия.

      2. В блоке Вспомогательные функции выберите пункт Сформировать строку соединения с БД.

      3. Система откроет страницу формирования параметров соединения с базой данных.

      4. Укажите значения требуемых параметров и нажмите кнопку Сформировать.

        [Примечание] Примечание

        В зависимости от типа СУБД синтаксис строки соединения с БД может меняться.

      5. Система сформирует XML-текст, в котором будут указаны параметры подключения к требуемой базе данных согласно указанным условиям.

        Тег "url" содержит искомое значение строки подключения к требуемой базе данных.

    • Средствами выбранного сервера приложений:

      [Примечание] Примечание

      В данном руководстве в качестве серверов приложений рассматриваются Apache Tomcat и IBM WebSphere Application Server.

      • Средствами Apache Tomcat:

        1. Откройте на редактирование файл context.xml и укажите в данном файле параметры подключения к базе данных. В качестве значения тега Resource name произвольным образом задайте наименование JNDI-ресурса.

          Сохраните изменения установленным образом.

        2. Необходимо запомнить наименование JNDI-ресурса, данное значение необходимо будет указать при настройке подключения в форме Конфигурация в системе "Corporate".

      • Средствами IBM WebSphere Application Server:

        1. Откройте административную консоль IBM WebSphere Application Server.

        2. Выберите пункт Resources → JDBC → JDBC providers главного меню консоли.

          [Примечание] Примечание

          Наименование создаваемой сущности может различаться в зависимости от терминологии, принятой в версии используемого сервера приложений. Наименования пунктов меню также могут несколько изменяться в зависимости от того какой язык используется в IBM WebSphere Application Server. Также возможны некоторые изменения в зависимости от версии IBM WebSphere Application Server. Подробное расположение пунктов меню уточняйте в документации на используемую версию и локализацию IBM WebSphere Application Server.

        3. Создайте источник данных (фабрику подключений к БД) стандартным образом. Создание источника данных для проведения процедуры миграции аналогично тому, как создается источник данных при развертывании системы "Corporate". Инструкции по созданию источника данных представлены в документации по развертыванию, предоставляемой в дистрибутиве системы "Corporate" (документ "02 Установка и начальная настройка Corporate Corporate (IBM) WAS_8_5_5.docx", раздел 4.2.1 "Настройка фабрики подключений к БД").

          [Примечание] Примечание

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

        4. Запомните наименование JNDI-ресурса созданного источника данных, данное значение необходимо будет указать при настройке подключения в форме Конфигурация в системе "Corporate".

  5. В полях формы Конфигурация укажите полученные значения реквизитов подключения к базе данных системы "ДБО BS-Client".

    В зависимости от того, каким образом были получены значения реквизитов подключения – средствами системы "Corporate" или средствами выбранного сервера приложений, выполните следующее:

    • Если значения реквизитов подключения были получены средствами системы "Corporate":

      1. Поле JNDI оставьте незаполненным. При данном способе настройки соединения наименование JNDI-ресурса не требуется.

      2. В поле Строка подключения укажите соответствующее значение.

        Строка подключения к базе данных может быть сформирована вручную либо автоматически. Автоматически строка подключения может быть сформирована с помощью интерфейса администрирования платформы, Вам будет достаточно только скопировать сформированное значение и вставить его в поле Строка подключения.

        Формирование строки подключения к базе данных с помощью интерфейса администрирования платформы выполняется согласно п. 4.1 данной инструкции.

      3. В поле Имя пользователя укажите пользователя, от имени которого производится соединение с базой данных.

      4. Укажите соответствующее значение в поле Пароль.

        [Внимание!] Внимание!

        После первичного указания пароля для подключения к БД, он сохраняется в системе и отображается при последующих вызовах окна конфигурации мигратора в хешированном виде,

    • Если значения реквизитов подключения были получены средствами сервера приложений:

      1. В поле JNDI укажите наименование JNDI-ресурса.

        Значение JNDI-ресурса было получено при формировании значений реквизитов соединения с базой данных средствами выбранного сервера приложений.

        При формировании значений реквизитов подключения через Apache TomCat наименование JNDI-ресурса определялось значением тега Resource name в файле context.xml (согласно п. 4.2.1 данной инструкции).

        При формировании значений реквизитов подключения через IBM WebSphere Application Server наименование JNDI-ресурса указывается при создании источника данных (согласно п. 4.2.2).

      2. Прочие поля оставьте незаполненными – значения всех необходимых параметров подключения уже были указаны при формировании реквизитов подключения к базе данных средствами выбранного сервера приложений.

  6. Заполните поле выбора Остановка при ошибке в случае, если требуется останавливать процесс миграции при любой ошибке процесса миграции. В противном случае снимите заполнение с поля.

  7. Укажите коды схем подписей, используемые в системе "Corporate". Это нужно для того, чтобы знать какие коды схем подписей используются в системе "Corporate" и сопоставлять им соответствующие коды схем подписей документов системы "ДБО BS-Client".

    1. В блоке полей Схема подписи по умолчанию для документов, требующих укажите коды схем подписей: код схемы одной подписи в поле одну подпись, код схемы двух подписей в поле две подписи.

      [Примечание] Примечание

      Значения кодов схем подписей документов указаны в записях о схемах подписей, поле Код. Список записей о схемах подписей доступен при выборе пункта Администрирование → Настройка безопасности → Схемы подписи главного меню системы.

  8. После того как все необходимые значения были указаны, сохраните изменения с помощью кнопки  .

  9. Установите соединение с базой данных с помощью кнопки  .

  10. Система "Corporate" выполнит попытку подключения к базе данных "ДБО BS-Client". О результатах подключения будет выведено информационное окно.

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

  11. После того, как соединение с базой данных "ДБО BS-Client" было установлено, перейдите к созданию и настройке задач на миграцию согласно разд. «Создание задач на первичную миграцию» данной инструкции.

В процессе выполнения указанных действий будет выполнено подключение к базе данных системы "ДБО BS-Client".