opnsense/docs
1
0
Fork 0
mirror of https://github.com/opnsense/docs.git synced 2026-07-07 21:26:07 -05:00
Code Issues Packages Projects Releases Wiki Activity

Add general issue workflow, closes https://github.com/opnsense/docs/issues/208

Browse Source
This commit is contained in:
Ad Schellevis
2019-11-14 18:49:52 +01:00
parent 69d4794747
commit ddd81c2bca
1 changed files with 54 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files

56
source/troubleshooting.rst
View File

@@ -10,8 +10,60 @@ Generally it's always good to check your logs (:menuselection:`System --> Log Fi
but sometimes more help is needed.
Within this chapter we collect some of the common mistakes we have seen over the years, combined with pointers
where to look for solutions.
General issue workflow
...........................
Before reporting issues, please make sure yours still exists on the latest version.
We generally advice to check the existing `issues <https://github.com/opnsense/core/issues>`__ and our `forum <https://forum.opnsense.org/>`__
before reporting new ones.
In case your issue was introduced after a (minor) upgrade, you can use `opnsense-revert <https://docs.opnsense.org/manual/opnsense_tools.html#opnsense-revert>`__
to downgrade specific packages installed on the system.
Using the firmware section (:menuselection:`System --> Firmware --> Updates`) you can perform a health check on the system, in
the right top corner of the page is a button named **Audit now** which can be collapsed into **Health**.
When clicked this outputs something like the following:
.. code-block:: text
***GOT REQUEST TO AUDIT HEALTH***
>>> Check installed kernel version
Version 19.7.3 is correct.
>>> Check for missing or altered kernel files
No problems detected.
>>> Check installed base version
Version 19.7.3 is correct.
>>> Check for missing or altered base files
No problems detected.
>>> Check for and install missing package dependencies
Checking all packages: .......... done
>>> Check for missing or altered package files
Checking all packages: ....
opnsense-19.7.4_1: checksum mismatch for /usr/local/etc/inc/auth.inc
Checking all packages...
Checking all packages......... done
***DONE***
When mismatches are reported, you can reinstall affected packages in the **Packages** section of the firmware screen.
In the case above you would reinstall opnsense, since the :code:`auth.inc` looks tainted.
.. Note::
We advise to include the output of the health check if it seems to report issues when creating bug reports on GitHub.
.. Tip::
Always try to be precise in issue reports, either if their about a possible bug or a feature request, it helps if
intentions are absolutely clear. Our GitHub repositories use templates which should guide you through, we kindly
ask you to use them (tickets not using our templates are treated as low priority).
Topics
...........................
Some of the common mistakes we have seen over the years, combined with pointers where to look for solutions can
be found in the list below.
.. toctree::
:maxdepth: 2