Подключение существующей БД

  • Не изменяйте конфигурацию сателлитных БД при подключении существующей БД Docsvision!

  • Параметр сортировки (collation) в подключаемой БД должен быть тождественным этому параметру на SQL-сервере.

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

  • Входит в группы Docsvision в Справочнике сотрудников, а указанные группы имеют соответствующие права доступа согласно дискреционной безопасности к следующим папкам:

    • Администраторы УД: полный доступ к папке "Папки"  "Служебные", "Папки"  "Служебные"  "Маршрутизация", "Папки"  "Отчёты", "Папки"  "Договоры"  Служебные".

    • Администраторы КС: полный доступ к папке "Папки"  "Усовершенствованное согласование".

    • Системная для WF: полный доступ к папке "Папки"  "Служебные".

  • Имеет полный доступ согласно дискреционной безопасности к группе "_Системные группы".

Подробнее см. "Подготовка к обновлению системы" в документации по обновлению Docsvision.

  1. Создайте резервную копию базы данных на случай возникновения ошибок при обновлении.

  2. Откройте страницу Серверы  Имя-сервера  Сервер приложений  Базы данных и нажмите кнопку Подключить под таблицей со списком подключенных БД, чтобы запустить Мастер БД Docsvision.

    Таблица БД Docsvision
    Рисунок 1. Таблица БД Docsvision
  3. Укажите данные для подключения к СУБД. Нажмите Далее.

    Мастер БД Docsvision в режиме подключения базы данных
    Рисунок 2. Мастер БД Docsvision в режиме подключения базы данных
    Тип сервера

    Тип СУБД из списка поддерживаемых в системе:

    • Microsoft SQL Server.

    • PostgreSQL.

    Имя сервера

    Сетевое имя сервера или экземпляра СУБД, например sql.company.com.

    Для БД PostgreSQL имя сервера следует указывать без домена, например, postgre, а не postgre.company.com. Не следует использовать IP и имя LOCALHOST.

    Порт

    Только для PostgreSQL. Порт подключения к СУБД, в PostgreSQL по умолчанию используется порт 5432.

    Если не удается найти сервер по имени, или неверно указан порт, появляется ошибка Не удалось подключиться к серверу. Проверьте введённые данные и убедитесь что сервер доступен.

    Проверка подлинности

    Тип проверки подлинности при подключении к СУБД:

    • SQL Server — аутентификация с помощью учётной записи, зарегистрированной в СУБД.

    Логин, Пароль

    Данные учётной записи для подключения к СУБД.

    Доверять сертификату сервера

    Только для Microsoft SQL Server. Когда флаг снят, подключение разрешено только при наличии действительного SSL-сертификата на сервере (значение по умолчанию). Когда флаг установлен, проверка сертификата игнорируется, соединение устанавливается даже с самоподписанным и недействительным сертификатом.

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

  4. Укажите основные параметры БД:

    Параметры БД
    Рисунок 3. Параметры БД
    Имя

    Название БД в СУБД.

    Псевдоним

    Идентификатор, по которому идёт обращение к БД из клиентских программ. Обычно совпадает с именем БД.

  5. Подтвердите параметры подключения базы данных.

    Подтверждение параметров подключения БД
    Рисунок 4. Подтверждение параметров подключения БД

    Параметр Ожидать завершения атомарной операции на SQL Server (сек) определяет максимальное время ожидания завершения отдельного этапа (операции) процедуры создания или подключения БД. Если операция не будет выполнена за указанное время, она завершится с ошибкой.

    Параметр Ожидать завершения атомарной операции на SQL Server (сек) не ограничивает время выполнения пользовательских операций при работе в Windows-клиенте или Web-клиенте. При работе в клиентских приложениях будет применяться стандартное ограничение 600 секунд.

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

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

    Чтобы работать с модулем, необходимо загрузить его собственные библиотеки карточек и зависимые от них. Установите флаг в строке соответствующей библиотеки, чтобы её загрузить, рекомендуется выбрать все доступные библиотеки карточек. При снятии флага с какой либо библиотеки появляется сообщение: У библиотеки есть ссылки. Связанные библиотеки будут сняты. Продолжить? После подтверждения флаги будут сняты с выбранного элемента и со всех связанных. Эти библиотеки не будут загружены в базу данных.

    Выбор модулей для обновления
    Рисунок 5. Выбор модулей для обновления
    Сведения о библиотеках карточек:
    • Библиотеки карточек, версии которых отличаются от установленных в БД, будут автоматически выбраны — данные библиотеки могут быть обновлены.

      Если версия загружаемой библиотеки карточек не отличается от версии в БД или файлы библиотеки карточек отсутствуют в каталоге сервера Docsvision, /usr/lib/docsvision/database для Linux и C:\Program Files\Docsvision\Database для Windows, выбор таких библиотек карточек будет заблокирован. Строчки с такими библиотеками карточек будут серого цвета, а флаг -- неактивен.

    • В строке Пользовательские метаданные указано, была ли модифицирована установленная в БД библиотека карточек (добавлены пользовательские метаданные).

    • В зависимости от изменений в библиотеках карточек может выполняться полное обновление или обновление в лёгком режиме. Подробнее про режимы обновления БД см. "Режимы обновления баз данных".

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

  7. Нажмите кнопку Обновить, чтобы подключить БД и дождитесь завершения загрузки SQL объектов.

    Запуск обновления подключаемой БД
    Рисунок 6. Запуск обновления подключаемой БД

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

    Запущенный процесс обновления может быть прерван кнопкой Прервать. Нажатие кнопки вызовет диалоговое окно с предупреждением При прерывании операции обновления база данных останется в промежуточном состоянии. Для восстановления работоспособности потребуется восстановить её из резервной копии. Продолжить?. Кнопка Отмена закроет диалоговое окно, процесс обновления не будет прерван. Кнопка ОК подтверждает намерение прервать процесс обновления.

    Чтобы закрыть мастер БД с сохранением текущего прогресса используйте кнопку Крестик в верхнем правом углу мастера.

  8. По окончании процесса будет отображено сообщение об успешном завершении операции с БД и необходимости перезапустить службу Сервера Docsvision.

  9. Нажмите Далее. Выберите модули Docsvision, решения которых должны быть загружены в БД и нажмите кнопку Загрузить.

    Выбор модулей
    Рисунок 7. Выбор модулей, решения которых будут загружены в БД

    Существующие в БД решения загружаемых модулей будут перезаписаны.

  10. Дождитесь завершения загрузки решений.

  11. Чтобы назначить подключенную БД основной, следуйте инструкции.