S3Tool – это утилита Directum RX, с помощью которой при переходе с файлового хранилища на объектное можно перенести содержимое документов. Она входит в дистрибутив системы Directum RX.

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

Схема работы утилиты:

1.Утилита S3Tool получает из базы данных порцию идентификаторов бинарных данных и связанных с ними сущностей. Например, содержимого документов или записей справочников со свойством типа «Бинарные данные в хранилище». Выбираются только идентификаторы из того хранилища, которое указывается при запуске утилиты. В базе данных на выбранные бинарные данные устанавливаются блокировки.

2.Бинарные данные загружаются в указанное объектное хранилище параллельно в несколько потоков.

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

•на бинарные данные не удалось установить блокировку. Например, они заблокированы другим процессом;

•в файловом хранилище отсутствуют данные;

•при загрузке файла в объектное хранилище произошла ошибка.

4.В базе данных идентификатор хранилища успешно перенесенных бинарных данных обновляется на тот, который указан при запуске утилиты.

5.Все установленные блокировки снимаются.

6.Выбирается следующая порция идентификаторов. Перенос выполняется до тех пор, пока утилита не обработает все доступные бинарные данные.

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

Перед запуском утилиты S3Tool ознакомьтесь с рекомендациями:

•для переноса данных из одного хранилища запускайте только один экземпляр утилиты. Чтобы ускорить процесс, настройте параллельные потоки обработки данных. Количество потоков можно указать больше, чем число ядер процессора. Скорость переноса зависит от пропускной способности сети и скорости обработки со стороны объектного хранилища;

•перенос из хранилища с активно используемыми документами запускайте на отдельном сервере в нерабочее время, чтобы избежать конфликтов с блокировками. Для этого можно настроить автоматический запуск переноса по расписанию с помощью планировщика заданий, например cron;

•перенос содержимого из хранилища редко используемых документов можно запускать в рабочее время. Утилита не создает нагрузки на СУБД и сервисы Directum RX;

•если бинарные данные для переноса заблокированы другими пользователями или процессами, то принудительно снимите блокировки и запустите утилиту повторно.