Администрирование (Linux) > Сопровождение работы системы > Хранилища > Утилита S3Tool > Переход на использование объектного хранилища

1.Разверните второй сервис хранилищ и настройте его на использование объектного хранилища. Подробнее см. в разделе «Развертывание дополнительного сервиса хранилищ на одном сервере».

2.В справочнике Хранилища создайте запись с настройками доступа для нового сервиса.

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

флажок Хранилище по умолчанию.

3.В справочнике Политики хранения перенастройте политики хранения и перемещения документов, чтобы их содержимое попадало в объектное хранилище. Для этого укажите его в карточке каждой записи в поле Хранилище.

4.Настройте утилиту S3Tool. Для этого в конфигураторе Directum Launcher добавьте секцию Утилита S3Tool (S3Tool). В ней укажите параметры:

•STORAGE_PATH – адрес файлового хранилища, из которого требуется перенести данные;

•S3_STORAGE_SERVICE_ADDRESS – адрес объектного хранилища, полученный от провайдера при его создании;

•S3_STORAGE_ACCESS_KEY – ключ доступа, полученный от провайдера при создании объектного хранилища;

•S3_STORAGE_SECRET_KEY – секретный ключ, полученный от провайдера при создании объектного хранилища;

•S3_STORAGE_BUCKET_NAME – имя бакета (выделенной части) объектного хранилища, в котором размещается содержимое. Необязательный параметр. По умолчанию используется код системы, который задан в параметре PRIMARY_TENANT. При необходимости имя можно изменить.

ВАЖНО. При изменении имени учитывайте, что оно должно соответствовать требованиям, которые заданы провайдером объектного хранилища. Например, используйте имя, в котором от 3 до 63 символов и первый символ – буква или цифра.

•S3_FORCE_PATH_STYLE – указывать имя бакета объектного хранилища после URI-адреса. Необязательный параметр. По умолчанию значение false. Подробнее см. в документации используемого объектного хранилища.

Пример настройки в config.yml:

S3Tool:
    <<: *base
    STORAGE_PATH: '{{ home_path }}/storageservice'
    S3_FORCE_PATH_STYLE: 'false'
    S3_STORAGE_SERVICE_ADDRESS: 'https://s3.cloud.ru'
    S3_STORAGE_ACCESS_KEY: '1fQF2lHcxkHQmFDfKGU34W'
    S3_STORAGE_SECRET_KEY: 'bDV9vQZ5Eu7uc8b4gsB8NSgdt4C6b7dLZ4s3YNj2Jkhu'
    S3_STORAGE_BUCKET_NAME: 'bucket1'

5.Проверьте соединение с объектным хранилищем. Для этого из папки с Directum Launcher выполните команду:

./do.sh s3tool check-connection

Если команда выполняется успешно, то соединение установлено.

6.Запустите перенос документов. Для этого из папки с Directum Launcher выполните команду:

./do.sh s3tool upload --source_storage <ИД исходного хранилища> --destination_storage <ИД хранилища для переноса> --parallel <количество потоков>

Где:

•--source_storage (или -s) – идентификатор хранилища, из которого требуется перенести данные. Он указан в карточке записи справочника;

•--destination_storage (или -d) – идентификатор хранилища, в которое переносятся данные;

•--parallel (или -p) – количество параллельных потоков обработки данных. Если значение не указано, то по умолчанию используется 10;

•batch_size (или -b) – количество файлов, которое утилита берет для переноса за один раз. По умолчанию 1000. Необязательный параметр;

•remove_after_transfer (или -r) – признак того, что нужно удалить файлы из исходного хранилища после переноса. По умолчанию файлы не удаляются (false). Необязательный параметр.

Пример команды:

./do.sh s3tool upload --source_storage 1 --destination_storage 2 --parallel 50

Примечание. Чтобы прервать процесс, вы можете использовать сочетание клавиш CTRL+C или CTRL+BREAK. В результате перенесенные файлы сохраняются в объектном хранилище, оставшиеся – в файловом. Чтобы перенести их, повторно выполните команду upload.