diff --git a/doc/common/tables/swift-swift-swift-constraints.xml b/doc/common/tables/swift-swift-swift-constraints.xml index 7f5a51495c..34a63f877c 100644 --- a/doc/common/tables/swift-swift-swift-constraints.xml +++ b/doc/common/tables/swift-swift-swift-constraints.xml @@ -15,38 +15,71 @@ - max_file_size=5368709122No help text available for this option + max_file_size=5368709122 + The largest normal object that can be + saved in the cluster. This is also the + limit on the size of each segment of a + large object when using the large object + manifest support. This value is set in + bytes. Setting it to lower than 1MiB will + cause some tests to fail. It is STRONGLY + recommended to leave this value at the + default (5 * 2**30 + 2). - max_meta_name_length=128No help text available for this option + max_meta_name_length=128 + The maximum number of bytes in the utf8 + encoding of the name portion of a metadata + header. - max_meta_value_length=256No help text available for this option + max_meta_value_length=256 + The max number of bytes in the utf8 + encoding of a metadata value. - max_meta_count=90No help text available for this option + max_meta_count=90 + The maximum number of metadata keys that can + be stored on a single account, container, + or object. - max_meta_overall_size=4096No help text available for this option + max_meta_overall_size=4096 + The maximum number of bytes in the utf8 + encoding of the metadata (keys + + values). - max_header_size=8192No help text available for this option + max_header_size=8192 + The maximum number of bytes in the utf8 + encoding of each header. - max_object_name_length=1024No help text available for this option + max_object_name_length=1024 + The maximum number of bytes in the utf8 + encoding of an object name. - container_listing_limit=10000No help text available for this option + container_listing_limit=10000 + The default (and maximum) number of items + returned for a container listing + request. - account_listing_limit=10000No help text available for this option + account_listing_limit=10000 + The default (and maximum) number of items + returned for an account listing request. - max_account_name_length=256No help text available for this option + max_account_name_length=256 + The maximum number of bytes in the utf8 + encoding of an account name. - max_container_name_length=256No help text available for this option + max_container_name_length=256 + The maximum number of bytes in the utf8 + encoding of a container name. - \ No newline at end of file + diff --git a/doc/config-reference/object-storage/section_object-storage-features.xml b/doc/config-reference/object-storage/section_object-storage-features.xml index 2b64411f52..2fe49fe964 100644 --- a/doc/config-reference/object-storage/section_object-storage-features.xml +++ b/doc/config-reference/object-storage/section_object-storage-features.xml @@ -162,95 +162,21 @@
Constraints - The swift-constraints section in - swift.conf allows modification - of internal limits within swift. These are advanced - features for tuning the performance of the cluster and - should be altered with caution. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Configuration options for swift-constraints - in swift.conf
OptionDefaultDescription
max_file_size5368709122the largest "normal" object that can be - saved in the cluster. This is also the - limit on the size of each segment of a - "large" object when using the large object - manifest support. This value is set in - bytes. Setting it to lower than 1MiB will - cause some tests to fail. It is STRONGLY - recommended to leave this value at the - default (5 * 2**30 + 2).
max_meta_name_length128the max number of bytes in the utf8 - encoding of the name portion of a metadata - header.
max_meta_value_lenth256the max number of bytes in the utf8 - encoding of a metadata value
max_meta_count90the max number of metadata keys that can - be stored on a single account, container, - or object
max_meta_overall_size4096the max number of bytes in the utf8 - encoding of the metadata (keys + - values)
max_object_name_length1024the max number of bytes in the utf8 - encoding of an object name
container_listing_limit10000the default (and max) number of items - returned for a container listing - request
max_account_name_length256the max number of bytes in the utf8 - encoding of an account name
max_container_name_length256the max number of bytes in the utf8 - encoding of a container name
+ To change the OpenStack Object Storage internal + limits, update the values in the + swift-constraints section in the + swift.conf file. Use caution when you + update these values because they affect the performance in + the entire cluster. +
Cluster Health - There is a + Use the swift-dispersion-report tool - for measuring overall cluster health. This is - accomplished by checking if a set of deliberately + to measure overall cluster health. This tool checks + if a set of deliberately distributed containers and objects are currently in their proper places within the cluster. For instance, a common deployment has three replicas of each object.