Expand known issues and make it more prominent

Author: vvolkl

apx-issues.rst

@@ -1,8 +1,47 @@
 Known Issues
 ============
 
+These pages mentions known limitations that won't be fixed, and bugs affecting certain verisons that can interfere with operations. For a more details see the changelog pages and issue tracker.
+
+Known Issues By Version
+-----------------------
+
+CernVM-FS 2.13.2
+^^^^^^^^^^^^^^
+
+* Race condition in auto-mounts/umounts can lead to stuck cvmfs processes
+
+CernVM-FS 2.13.1
+^^^^^^^^^^^^^^^^^^
+
+* Race condition in auto-mounts/umounts can lead to stuck cvmfs processes
+* Crashes due to Page Cache Tracker Mismatches
+
+
+CernVM-FS 2.12.7
+^^^^^^^^^^^^^^^^^^
+
+* [server] ingesting a tarball with double slashes in base_dir corrupts repository
+* Crashes due to Page Cache Tracker Mismatches
+
+
+Description
+----------
+
+
+Race condition in auto-mounts/umounts can lead to stuck cvmfs processes
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+
+The feature of pre-mounting the fuse device introduced in 2.13.0 can make issues when autofs unmounts the repository just as another process remounts it. This can be especially noticeable with short autofs timeouts and automatic checks that may remount the repositories. Github issue: `3993 <https://github.com/cvmfs/cvmfs/issues/3993>`__
+
+Crashes due to Page Cache Tracker Mismatches
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+A mismatch in internal data structures triggered by repository updates can throw an assert, crashing cvmfs. Github issue: `3520 <https://github.com/cvmfs/cvmfs/issues/3520>`__
+
 Slow Performance with a Very Large File Descriptor Limit
---------------------------------------------------------
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 Before CernVM-FS 2.11, having the file descriptor limit set to a very large number
 will result in a very slow ``cvmfs`` performance in certain situations.
@@ -11,7 +50,7 @@ instead of just the used/opened ones.
 This issue is resolved in CernVM-FS 2.11.
 
 Publisher nodes with AUFS and XFS
----------------------------------
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 If the ``/tmp`` file system is on xfs, the publisher node cannot be used with AUFS.
 On such systems, adding the mount option ``xino=/dev/shm/aufs.xino`` can be

cpt-releasenotes.rst

@@ -4,6 +4,9 @@
 Release Notes for CernVM-FS 2.13.2
 ==================================
 
+.. note::
+  In CernVM-FS 2.13.2 there is a race when automounting/-unmounting repositories that lead to clients. A new patch release is in preparation. This issue can be mitigated by increasing the autofs timeout. See the "Known Issues" page for more details 
+
 CernVM-FS 2.13.2 is a fairly large patch release. It fixes two long standing issues in the core client code that have caused crashes in some rare circumstances.
 A regression in 2.13 that has led to spurious "failed to umount (errno 22)" log messages is fixed as well.
 Furthermore this patch release includes some important improvements for stratum one operations (As a reminder, the versioning of CVMFS is semantic mostly for the client.

index.rst

@@ -32,9 +32,12 @@ CernVM-FS is actively used by small and large HEP collaborations. In many
 cases, it replaces package managers and shared software areas on cluster file
 systems as means to distribute the software used to process experiment data.
 
+
 Contents
 ^^^^^^^^
 
+We recommend to consult the Release Notes and Known Issues pages before doing any upgrades.
+
 .. toctree::
    :maxdepth: 2