comparison Sphinx/source/plugins/object-storage.rst @ 1084:337bbecf74c0

notes about precompiled aws s3 binaries
author Sebastien Jodogne <s.jodogne@gmail.com>
date Thu, 27 Jun 2024 11:21:32 +0200
parents e1f7f1e2d148
children ceeab11899ee
comparison
equal deleted inserted replaced
1083:e1f7f1e2d148 1084:337bbecf74c0
28 28
29 29
30 Pre-compiled binaries 30 Pre-compiled binaries
31 --------------------- 31 ---------------------
32 32
33 These 3 plugins are provided as part of the ``orthancteam/orthanc`` :ref:`Docker images <docker-orthancteam>`. 33 Note about proprietary cloud storage
34 The AWS plugin is available in the default Docker images while the Azure and Google plugins are available 34 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
35 in the ``-full`` images.
36
37 The Azure plugin is also available as part of the `Windows Installer
38 <https://orthanc.uclouvain.be/downloads/windows-64/installers/index.html>`__
39 (only for 64bits platform).
40 35
41 These plugins are used to interface Orthanc with commercial and 36 These plugins are used to interface Orthanc with commercial and
42 proprietary cloud services that you accept to pay. As a consequence, 37 proprietary cloud services that you accept to pay. As a consequence,
43 the Orthanc project usually doesn't freely update them or fix them 38 the Orthanc project usually doesn't freely update them or fix them
44 unless the requester purchases a support contract, e.g., at `Orthanc 39 unless the requester purchases a support contract, e.g., at `Orthanc
46 41
47 Although you are obviously free to compile these plugins by 42 Although you are obviously free to compile these plugins by
48 yourself (instructions are given below), purchasing such support 43 yourself (instructions are given below), purchasing such support
49 contracts makes the Orthanc project sustainable in the long term, to 44 contracts makes the Orthanc project sustainable in the long term, to
50 the benefit of the worldwide community of medical imaging. 45 the benefit of the worldwide community of medical imaging.
46
47
48 ``orthancteam/orthanc`` Docker image
49 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
50
51 All the 3 plugins are provided as part of the ``orthancteam/orthanc``
52 :ref:`Docker images <docker-orthancteam>`. The AWS plugin is available
53 in the default Docker images, while the Azure and Google plugins are
54 available in the ``-full`` images.
55
56
57 AWS S3 plugin
58 ^^^^^^^^^^^^^
59
60 Because the AWS S3 plugin is compatible with free and open-source
61 implementations of the S3 protocol (notably MinIO and Ceph), we
62 provide pre-compiled binaries of the AWS S3 plugin, which can be found
63 at the following locations:
64
65 * In the `official Microsoft Windows installers <https://orthanc.uclouvain.be/downloads/windows-64/installers/index.html>`__, starting with release 24.6.3.
66 * For `Microsoft Windows 32 <https://orthanc.uclouvain.be/downloads/windows-32/orthanc-aws-s3/index.html>`__,
67 * For `Microsoft Windows 64 <https://orthanc.uclouvain.be/downloads/windows-64/orthanc-aws-s3/index.html>`__,
68 * For `cross-distribution Linux <https://orthanc.uclouvain.be/downloads/linux-standard-base/orthanc-aws-s3/index.html>`__,
69 * In the :ref:`backport Debian repository <binaries>` (notably compatible with Ubuntu 22.04 and 24.04),
70 * In the :ref:`jodogne/orthanc Docker images <docker>`,
71 * In the :ref:`orthancteam/orthanc Docker images <docker-orthancteam>`.
72
73
74 Microsoft Azure plugin
75 ^^^^^^^^^^^^^^^^^^^^^^
76
77 The Azure plugin is also available as part of the `Windows Installer
78 <https://orthanc.uclouvain.be/downloads/windows-64/installers/index.html>`__
79 (only for 64bits platform).
80
81
51 82
52 83
53 Configuration 84 Configuration
54 ------------- 85 -------------
55 86
424 455
425 456
426 **NB:** If you don't want to use vcpkg, you can use the following 457 **NB:** If you don't want to use vcpkg, you can use the following
427 command (this syntax is not compatible with Ninja yet):: 458 command (this syntax is not compatible with Ninja yet)::
428 459
429 $ cmake -DCMAKE_BUILD_TYPE=Debug -DUSE_VCPKG_PACKAGES=OFF -DUSE_SYSTEM_GOOGLE_TEST=OFF ../../orthanc-object-storage/Aws 460 $ cmake -DCMAKE_BUILD_TYPE=Debug -DUSE_VCPKG_PACKAGES=OFF -DUSE_SYSTEM_GOOGLE_TEST=OFF -DUSE_SYSTEM_ORTHANC_SDK=OFF ../../orthanc-object-storage/Aws
430 $ make 461 $ make
431 462
432 Crypto++ must be installed (on Ubuntu, run ``sudo apt install libcrypto++-dev``). 463 Crypto++ must be installed (on Ubuntu, run ``sudo apt install libcrypto++-dev``).
433 464
434 465