Transfers accelerator plugin

[Sébastien Jodogne]

Dear Orthanc community,

It is my pleasure to announce the official release of a new Orthanc plugin courtesy of Osimis, thanks to the funding from one of our industrial partners.

The "transfers accelerator" plugin provides an efficient way to transfer DICOM files securely over Internet through the HTTP/HTTPS protocol. This plugin improves the Orthanc peers mechanism, by providing parallel transfers, chunking of DICOM files, and a form of storage commitment.

Full documentation is available at the following location:

http://book.orthanc-server.com/plugins/transfers.html

Source code and precompiled binaries for Windows 32bit are available at the following location:

https://www.orthanc-server.com/browse.php?path=/plugin-transfers

A new version of the Osimis installers including this new plugin will soon be available.

We warmly acknowledge our industrial sponsor for making this development possible to the benefit of the global community of medical imaging!

Kind Regards,

Sébastien-

[Ric Smi]

Thank you Sébastien for a wonderful announcement!  This is really exciting news!

Question, could please guide us how the call would be for this new feature under Lua scripting?  Currently, at high traffic location we are using RestApiPost('/peers/{peer}/store', instanceId).

Thank you for your attention!

Regards,

[Sébastien Jodogne]

This is explained in the documentation (check out "sample command line to send the same patient to the remote peer"):

http://book.orthanc-server.com/plugins/transfers.html#rest-api

[Ric Smi]

I apologize if I didn't ask the question clearly. 

Since this new feature can bundle instances together as group, my question is how can we write a Lua script on OnStableStudy() to send entire study at once via this new feature?

In other words, convert following line into Lua?

$ curl -v http://localhost:8042/transfers/send -X POST -d '{"Resources":[{"Level":"Patient","ID":"16738bc3-e47ed42a-43ce044c-a3414a45-cb069bd0"}],"Compression":"gzip","Peer":"remote"}'

Many thanks!

[Sébastien Jodogne]

PEER = 'b'

function OnStableStudy(studyId, tags, metadata)
   print('This study is now stable: ' .. studyId)
     
   local transfer = {}
   transfer['Resources'] = {}
   transfer['Resources'][1] = {}
   transfer['Resources'][1]['Level'] = 'Study'
   transfer['Resources'][1]['ID'] = studyId
   transfer['Compression'] = 'gzip'
   transfer['Peer'] = PEER
  
   local job = ParseJson(RestApiPost('/transfers/send',
                                     DumpJson(transfer, true)))
   print('Transfer job has been added to the queue: ' .. job['ID'])

end

[Ric Smi]

This is fantastic!  I couldn't wait to try this out.

I will report my findings.

Thank you so much!!!

Best regards,

[Ric Smi]

I have question on this...

Since, the Accelerator plugin uses HTTP PUT request shouldn't we be using HttpPut() for "push" mode instead of RestApiPost()?

Thank you!

[Sébastien Jodogne]

As written in the Orthanc Book, transfers are triggered by HTTP POST, so it is normal to use "RestApiPost()":

http://book.orthanc-server.com/plugins/transfers.html#rest-api

[Ric Smi]

Thank you for the answer.  That was good for my learning.

I now will wait for the new release to test this new feature out.

Thank you with best regards,

[Salim Kanoun]

Thank you so much Sebastien,

I was waiting for this plugin to add in my project that we will announce in some months.

With this kind industry sponsored open source plugin, you definitely opened a new era in software and medicine, bringing innovation, interoperability and freedom for users.

Thanks for doing all of this !

[Sébastien Jodogne]

Thanks for your support! :-)

Kind regards,

Sébastien-

[Michael Shen]

So I have an application where the transfer chain is: Modality ---(DICOM)---> Orthanc server 1 ----(transfer accelerator)----> Orthanc server 2 ----(transfer accelerator)----> Orthanc server 3

The Lua Script below works great for the Modality ---(DICOM)---> Orthanc server 1 ----(transfer accelerator)----> Orthanc server 2, but it doesn't make it to Orthanc server 3.

It seems 'function OnStableStudy(studyId, tags, metadata)' isn't triggered after receiving a transfer accelerator study.

Is the a Lua function that is triggered on completion of receiving a transfer accelerator study?

Thanks for any help.

Code:

PEER = 'b'

function OnStableStudy(studyId, tags, metadata)

   print('This study is now stable: ' .. studyId)

      

   local transfer = {}

   transfer['Resources'] = {}

   transfer['Resources'][1] = {}

   transfer['Resources'][1]['Level'] = 'Study'

   transfer['Resources'][1]['ID'] = studyId

   transfer['Compression'] = 'gzip'

   transfer['Peer'] = PEER

   

   local job = ParseJson(RestApiPost('/transfers/send',

                                     DumpJson(transfer, true)))

   print('Transfer job has been added to the queue: ' .. job['ID'])

end

On Wednesday, March 13, 2019 at 12:34:53 PM UTC-4, Sébastien Jodogne wrote:

Thanks for your support! :-)

Kind regards,

Sébastien-

On Sun, 10 Mar 2019 at 17:15, Salim Kanoun <salim...@gmail.com> wrote:

Thank you so much Sebastien,

I was waiting for this plugin to add in my project that we will announce in some months.

With this kind industry sponsored open source plugin, you definitely opened a new era in software and medicine, bringing innovation, interoperability and freedom for users.

Thanks for doing all of this !

Michael 

[Bryan Dearlove]

Quickly answering your one question, OnStableStudy does work on a receiving device using transfer accelerator. I have a HTTP Post script working, a test is to do a PrintRecursive and you'll see that record in your logs. 

[Michael Shen]

Thanks Bryan. I'll take a closer look at the log file and see what is happining. Thanks.

Michael