Merge pull request #13876 from nextcloud/backport/13875/stable32

[stable32] system address book auto disabled, mp3 preview provider disabled, add hint about s3 integrity protection

Author: kesselb

admin_manual/configuration_files/previews_configuration.rst

@@ -13,7 +13,6 @@ The following image shows some examples of previews of various file types.
 By default, Nextcloud can generate previews for the following filetypes:
 
 * Images files
-* Cover of MP3 files
 * Text documents
 
 .. note:: Nextcloud can also generate previews of other file types (such as PDF, SVG,

admin_manual/installation/server_tuning.rst

@@ -222,7 +222,6 @@ Nextcloud to use Imaginary by editing your `config.php`:
 .. code:: php
 
     'enabledPreviewProviders' => [
-        'OC\Preview\MP3',
         'OC\Preview\TXT',
         'OC\Preview\MarkDown',
         'OC\Preview\OpenDocument',

admin_manual/release_notes/upgrade_to_31.rst

@@ -44,4 +44,10 @@ But if you need to set a new custom value you need now to use the system configu
 Monitoring: Counting of active users
 ------------------------------------
 
-Starting with Nextcloud 31.0.6 the monitoring app was adjusted to count the active users in the same way as occ user:report and the support app.
+Starting with Nextcloud 31.0.6 the monitoring app was adjusted to count the active users in the same way as occ user:report and the support app.
+
+Previews
+--------
+
+Starting with Nextcloud 31.0.10, the preview provider for MP3 files, which reads cover images embedded in the files, is disabled by default for performance and stability reasons.
+See :doc:`../configuration_files/previews_configuration` for details on how to enable or disable the preview provider.

admin_manual/release_notes/upgrade_to_32.rst

@@ -18,4 +18,26 @@ Web server configuration
 Monitoring: Counting of active users
 ------------------------------------
 
-The monitoring app was adjusted to count the active users in the same way as occ user:report and the support app.
+The monitoring app was adjusted to count the active users in the same way as occ user:report and the support app.
+
+System address book
+--------------------
+
+During the upgrade to Nextcloud 32 the system address book might become disabled if the amount of system users exceeds the default limit of 5000 users. This is to prevent performance issues. You can re-enable the system address book using the command line or administration interface.
+
+For more information about the system address book, see the documentation. :ref:`System Address Book <system-address-book>`
+
+Previews
+--------
+
+Starting with Nextcloud 32.0.1, the preview provider for MP3 files, which reads cover images embedded in the files, is disabled by default for performance and stability reasons.
+See :doc:`../configuration_files/previews_configuration` for details on how to enable or disable the preview provider.
+
+S3 integrity protections enabled, configuration update may be needed
+--------------------------------------------------------------------
+
+The AWS SDK for PHP was updated and now enables the default integrity protections for S3. If your S3 backend does not support the default integrity protection yet, you can disable it since Nextcloud 32.0.2 by adding ``'request_checksum_calculation' => 'when_required',`` and ``'response_checksum_validation' => 'when_required',`` to the object store configuration.
+
+If your S3 backend does not support this, you may see an error such as ``Checksum Type mismatch occurred, expected checksum Type: null, actual checksum Type: crc32`` in your logs when uploading files.
+
+More details about S3 integrity protection can be found at https://docs.aws.amazon.com/sdkref/latest/guide/feature-dataintegrity.html and https://github.com/aws/aws-sdk-php/discussions/3100.

user_manual/files/access_webgui.rst

@@ -49,16 +49,16 @@ streaming, and it doesn't work in your Web browser, it may be a browser issue. S
 File controls
 -------------
 
-Nextcloud can display thumbnail previews for image files, MP3 covers,
-and text files, if this enabled by your server administrator. Hover your cursor
-over a file or folder to expose the controls for the following operations:
+Nextcloud can display thumbnail previews for various file types, such as images, audio files, and text files.
+The specific types supported are up to the server administrator.
+Hover your cursor over a file or folder to expose the controls for the following operations:
 
 Favorites
   Click the star to the left of the file icon to mark it as a favorite:
-  
+
   .. figure:: ../images/files_page-1.png
    :alt: Marking Favorite files.
-   
+
   You can also quickly find all of your favorites with the Favorites filter on the left
   sidebar.
 
@@ -179,5 +179,5 @@ Creating or connecting to a Federation Share link
 -------------------------------------------------
 
 Federated Cloud Sharing allows you to mount file shares from remote Nextcloud
-servers, and manage them just like a local share. See :doc:`federated_cloud_sharing` 
+servers, and manage them just like a local share. See :doc:`federated_cloud_sharing`
 to learn to how to create and connect to new Federated Cloud shares.