Skip to content

Commit

Permalink
Mention debug logs in the troubleshooting section
Browse files Browse the repository at this point in the history
Also add bullet points for readability.
  • Loading branch information
vvolkl authored and jblomer committed Jan 17, 2023
1 parent 6cfbef6 commit 536c0d2
Show file tree
Hide file tree
Showing 2 changed files with 11 additions and 9 deletions.
2 changes: 2 additions & 0 deletions cpt-configure.rst
Original file line number Diff line number Diff line change
Expand Up @@ -1218,6 +1218,8 @@ For the `Nagios monitoring system <http://www.nagios.org>`_ [Schubert08]_, a
checker plugin is available `on our website
<http://cernvm.cern.ch/portal/filesystem/downloads>`_.

.. _sct_debug_logs:

Debug Logs
----------

Expand Down
18 changes: 9 additions & 9 deletions cpt-quickstart.rst
Original file line number Diff line number Diff line change
Expand Up @@ -220,43 +220,43 @@ Example code for building CernVM-FS with locally built Fuse3 and including the C
Troubleshooting
---------------

In order to check for common misconfigurations in the base setup, run
- In order to check for common misconfigurations in the base setup, run

::

cvmfs_config chksetup

CernVM-FS gathers its configuration parameter from various configuration files that can overwrite each others settings (default configuration, domain specific configuration, local setup, ...).
To show the effective configuration for *repository*.cern.ch, run
- CernVM-FS gathers its configuration parameter from various configuration files that can overwrite each others settings (default configuration, domain specific configuration, local setup, ...). To show the effective configuration for *repository*.cern.ch, run

::

cvmfs_config showconfig repository.cern.ch

In order to exclude autofs/automounter as a source of problems, you can try to mount *repository*.cern.ch manually with the following
- In order to exclude autofs/automounter as a source of problems, you can try to mount *repository*.cern.ch manually with the following

::

mkdir -p /mnt/cvmfs
mount -t cvmfs repository.cern.ch /mnt/cvmfs

In order to exclude SELinux as a source of problems, you can try mounting after SELinux has been disabled by
- In order to exclude SELinux as a source of problems, you can try mounting after SELinux has been disabled by

::

/usr/sbin/setenforce 0

Once the issue has been identified, ensure that the changes are taken by restarting autofs
- Once the issue has been identified, ensure that the changes are taken by restarting autofs

::

systemctl restart autofs

If the problem is that a repository can be mounted and unmounted but
later cannot be remounted, see :ref:`sct_remounting_namespaces_containers`.
- If the problem is that a repository can be mounted and unmounted but later cannot be remounted, see :ref:`sct_remounting_namespaces_containers`.

In order to exclude a corrupted local cache as a source of problems, run
- In order to exclude a corrupted local cache as a source of problems, run

::

cvmfs_config wipecache

- Finally running with debug logs enabled can provide additional information for bug reports. This can be done by specifying a log file path in the client settings, e.g: ``CVMFS_DEBUGLOG=/tmp/cvmfs.log``. See :ref:`sct_debug_logs` for more details.

0 comments on commit 536c0d2

Please sign in to comment.