You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: doc/sphinx-guides/source/admin/big-data-administration.rst
-1Lines changed: 0 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -302,7 +302,6 @@ There are a broad range of options (that are not turned on by default) for impro
302
302
- :ref:`:DisableSolrFacetsWithoutJsession` - disables facets for users who have disabled cookies (e.g. for bots)
303
303
- :ref:`:DisableUncheckedTypesFacet` - only disables the facet showing the number of collections, datasets, files matching the query (this facet is potentially less useful than others)
304
304
- :ref:`:StoreIngestedTabularFilesWithVarHeaders` - by default, Dataverse stores ingested files without headers and dynamically adds them back at download time. Once this setting is enabled, Dataverse will leave the headers in place (for newly ingested files), reducing the cost of downloads
305
-
- :ref:`dataverse.bagit.zip.max-file-size`, :ref:`dataverse.bagit.zip.max-data-size`, and :ref:`dataverse.bagit.zip.holey` - options to control the size and temporary storage requirements when generating archival Bags - see :ref:`BagIt Export`
Copy file name to clipboardExpand all lines: doc/sphinx-guides/source/installation/config.rst
-40Lines changed: 0 additions & 40 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2259,22 +2259,10 @@ These archival Bags include all of the files and metadata in a given dataset ver
2259
2259
2260
2260
The Dataverse Software offers an internal archive workflow which may be configured as a PostPublication workflow via an admin API call to manually submit previously published Datasets and prior versions to a configured archive such as Chronopolis. The workflow creates a `JSON-LD <http://www.openarchives.org/ore/0.9/jsonld>`_ serialized `OAI-ORE <https://www.openarchives.org/ore/>`_ map file, which is also available as a metadata export format in the Dataverse Software web interface.
2261
2261
2262
-
The size of the zipped archival Bag can be limited, and files that don't fit within that limit can either be transferred separately (placed so that they are correctly positioned according to the BagIt specification when the zipped bag in unzipped in place) or just referenced for later download (using the BagIt concept of a 'holey' bag with a list of files in a ``fetch.txt`` file) can now be configured for all archivers. These settings allow for managing large datasets by excluding files over a certain size or total data size, which can be useful for archivers with size limitations or to reduce transfer times. See the :ref:`dataverse.bagit.zip.max-file-size`, :ref:`dataverse.bagit.zip.max-data-size`, and :ref:`dataverse.bagit.zip.holey` JVM options for more details.
2263
-
2264
2262
At present, archiving classes include the DuraCloudSubmitToArchiveCommand, LocalSubmitToArchiveCommand, GoogleCloudSubmitToArchive, and S3SubmitToArchiveCommand , which all extend the AbstractSubmitToArchiveCommand and use the configurable mechanisms discussed below. (A DRSSubmitToArchiveCommand, which works with Harvard's DRS also exists and, while specific to DRS, is a useful example of how Archivers can support single-version-only semantics and support archiving only from specified collections (with collection specific parameters)).
2265
2263
2266
2264
All current options support the :ref:`Archival Status API` calls and the same status is available in the dataset page version table (for contributors/those who could view the unpublished dataset, with more detail available to superusers).
2267
2265
2268
-
Two settings that can be used with all current Archivers are:
2269
-
2270
-
- \:BagGeneratorThreads - the number of threads to use when adding data files to the zipped bag. The default is 2. Values of 4 or more may increase performance on larger machines but may cause problems if file access is throttled
2271
-
- \:ArchiveOnlyIfEarlierVersionsAreArchived - when true, requires dataset versions to be archived in order by confirming that all prior versions have been successfully archived before allowing a new version to be archived. Default is false
2272
-
2273
-
These must be included in the \:ArchiverSettings for the Archiver to work
2274
-
2275
-
Archival Bags are created per dataset version. By default, if a version is republished (via the superuser-only 'Update Current Version' publication option in the UI/API), a new archival bag is not created for the version.
2276
-
If the archiver used is capable of deleting existing bags (Google, S3, and File Archivers) superusers can trigger a manual update of the archival bag, and, if the :ref:`dataverse.bagit.archive-on-version-update` flag is set to true, this will be done automatically when 'Update Current Version' is used.
2277
-
2278
2266
.. _Duracloud Configuration:
2279
2267
2280
2268
Duracloud Configuration
@@ -3727,14 +3715,6 @@ The email for your institution that you'd like to appear in bag-info.txt. See :r
3727
3715
3728
3716
Can also be set via *MicroProfile Config API* sources, e.g. the environment variable ``DATAVERSE_BAGIT_SOURCEORG_EMAIL``.
3729
3717
3730
-
.. _dataverse.bagit.archive-on-version-update:
3731
-
3732
-
dataverse.bagit.archive-on-version-update
3733
-
+++++++++++++++++++++++++++++++++++++++++
3734
-
3735
-
Indicates whether archival bag creation should be triggered (if configured) when a version is updated and was already successfully archived,
3736
-
i.e via the Update-Current-Version publication option. Setting the flag true only works if the archiver being used supports deleting existing archival bags.
3737
-
3738
3718
.. _dataverse.files.globus-monitoring-server:
3739
3719
3740
3720
dataverse.files.globus-monitoring-server
@@ -3897,21 +3877,6 @@ This can instead be restricted to only superusers who can publish the dataset us
A boolean that, if true, will cause the BagIt archiver to create a "holey" bag. In a holey bag, files that are not included in the bag are listed in the ``fetch.txt`` file with a URL from which they can be downloaded. This is used in conjunction with ``dataverse.bagit.zip.max-file-size`` and/or ``dataverse.bagit.zip.max-data-size``. Default: false.
3904
-
3905
-
.. _dataverse.bagit.zip.max-data-size:
3906
-
3907
-
``dataverse.bagit.zip.max-data-size``
3908
-
The maximum total (uncompressed) size of data files (in bytes) to include in a BagIt zip archive. If the total size of the dataset files exceeds this limit, files will be excluded from the zipped bag (starting from the largest) until the total size is under the limit. Excluded files will be handled as defined by ``dataverse.bagit.zip.holey`` - just listed if that setting is true or being transferred separately and placed next to the zipped bag. When not set, there is no limit.
3909
-
3910
-
.. _dataverse.bagit.zip.max-file-size:
3911
-
3912
-
``dataverse.bagit.zip.max-file-size``
3913
-
The maximum (uncompressed) size of a single file (in bytes) to include in a BagIt zip archive. Any file larger than this will be excluded. Excluded files will be handled as defined by ``dataverse.bagit.zip.holey`` - just listed if that setting is true or being transferred separately and placed next to the zipped bag. When not set, there is no limit.
3914
-
3915
3880
.. _feature-flags:
3916
3881
3917
3882
Feature Flags
@@ -5405,11 +5370,6 @@ This setting specifies which storage system to use by identifying the particular
5405
5370
5406
5371
For examples, see the specific configuration above in :ref:`BagIt Export`.
5407
5372
5408
-
:ArchiveOnlyIfEarlierVersionsAreArchived
5409
-
++++++++++++++++++++++++++++++++++++++++
5410
-
5411
-
This setting, if true, only allows creation of an archival Bag for a dataset version if all prior versions have been successfully archived. The default is false (any version can be archived independently as long as other settings allow it)
0 commit comments