Nearline Storage

Обзор

На этой странице кратко описано, как можно перемещать объекты / исследования из локальных кэш-архивов в долгосрочное nearline-хранилище. Nearline-хранилище может потребоваться для резервного копирования исследований и, в конечном счёте, освобождения места в локальных архивах, выступающих в роли кэша.

Базовая конфигурация

Вплоть до версии архива 5.23.3 экспорт объектов исследований из локальных кэш-архивов в долгосрочное nearline-хранилище использовал Java Messaging Service от Wildfly. Требуется добавить соответствующую очередь в конфигурацию Wildfly (если её там ещё нет) [standalone@localhost:9993 /] jms-queue add --queue-address=Export5 --entries=java:/jms/queue/Export5
Начиная с версии архива 5.24.0 Java Messaging Service от Wildfly заменена собственным механизмом планирования задач архива, поэтому добавление указанной конфигурации JMS-очереди в Wildfly не требуется.

Через UI архива

Перейдите на страницу Configuration, вкладку Devices и отредактируйте устройство dcm4chee-arc. Выполните Edit extension у Device Extension, далее Edit extension у Archive Device. Создайте новый Child Object для
Storage Descriptor
Exporter Descriptor
Export Rule
Queue

Примечание: - Конфигурация Queue отличается в зависимости от установленной версии архива. - Export Rule может быть настроена, если объекты исследований должны экспортироваться в nearline-хранилище по триггеру получения исследований.

Через LDAP

Можно - создать LDIF-файл (например):

    version: 1
    dn: dcmStorageID=nearline,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
    dcmInstanceAvailability: NEARLINE
    dcmProperty: pathFormat={now,date,yyyy/MM/dd}/{0020000D,hash}/{0020000E,hash}/{00080018,hash}
    dcmProperty: checkMountFile=NO_MOUNT
    objectClass: dcmStorage
    dcmStorageID: nearline
    dcmURI: ${jboss.server.data.url}/nearline/

    dn: dcmExporterID=CopyToNearlineStorage,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
    dcmExporterID: CopyToNearlineStorage
    dicomDescription: Copy to NEARLINE Storage
    dcmQueueName: Export5
    objectClass: dcmExporter
    dicomAETitle: DCM4CHEE
    dcmURI: storage:nearline

    dn: cn=Copy to NEARLINE Storage,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
    dcmExporterID: CopyToNearlineStorage
    dcmDuration: PT1M
    dcmEntity: Series
    dcmProperty: SendingApplicationEntityTitle=NEARLINE
    objectClass: dcmExportRule
    cn: Copy to NEARLINE Storage

Конфигурация Queue для версий архива вплоть до 5.23.3

    dn: dcmQueueName=Export5,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
    dicomDescription: Nearline Storage Export Tasks
    dcmQueueName: Export5
    dcmMaxRetries: 10
    dcmRetryDelayMultiplier: 200
    dcmRetryDelay: PT30S
    objectClass: dcmQueue
    dcmMaxRetryDelay: PT10M
    dcmPurgeQueueMessageCompletedDelay: P1D
    dcmJndiName: jms/queue/Export5

Конфигурация Queue для версии архива 5.24.0 и выше

    dn: dcmQueueName=Nearline Storage Export,dicomDeviceName=dcm4chee-arc,cn=Devices,cn=DICOM Configuration,dc=dcm4che,dc=org
    dcmPurgeQueueMessageCompletedDelay: P1D
    dcmRetryDelay: PT30S
    dcmMaxRetries: 10
    dicomDescription: Nearline Storage Export Tasks
    dcmQueueName: Nearline Storage Export
    objectClass: dcmQueue
    dcmRetryDelayMultiplier: 200
    dcmMaxRetryDelay: PT10M

и импортировать его на LDAP-сервер с помощью утилиты командной строки ldapmodify.

Можно обратиться к - Storage Descriptor, - Exporter Descriptor, - Export Rule, - Queue, чтобы понять описание атрибутов.

Обратитесь к формату длительностей ISO-8601 за дополнительной информацией о длительностях. Перейдите на вкладку Control на странице Configuration в UI архива и перезагрузите конфигурацию.

Тесты

Если настроена Export Rule, исследования будут экспортироваться в nearline-хранилище при получении их локальным архивом. - Сохраните исследования в архив с помощью инструмента storescu. - Проверьте создание задач экспорта на странице Monitoring, вкладке Export. Альтернативно можно вручную экспортировать исследования в nearline-хранилище - Перейдите на страницу Navigation, вкладку Studies и найдите нужные исследования, используя один или несколько специфичных фильтров запроса. - Выберите экспорт одного исследования / серии / объекта в nearline-хранилище. Альтернативно экспортируйте исследования, соответствующие
указанным фильтрам запроса, с помощью Export Matching Studies из выпадающего списка More Functions. - Проверьте создание задач экспорта на странице Monitoring, вкладке Export.

После истечения Task Polling Interval задачи экспорта обрабатываются и объекты исследований записываются в настроенное nearline-хранилище в указанное scheduledTime. При успешном экспорте исследований в nearline-хранилище проверьте, что Storage IDs of Study для каждого из исследований обновлён и отражает storage ID настроенного nearline-хранилища.

Storage IDs of Study    (7777,1028) LO  fs1,nearline