Skip to content

Commit cfcb6ac

Browse files
committed
Fixed comments from JanaH.
1 parent b74a66e commit cfcb6ac

File tree

1 file changed

+19
-28
lines changed

1 file changed

+19
-28
lines changed

tasks/systemd-journald-troubleshooting.xml

Lines changed: 19 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -30,22 +30,27 @@ in the assembly -->
3030
<title>View &systemd; errors</title>
3131
<step><para>View the list of failed &systemd; units:</para>
3232
<screen>systemctl --failed</screen>
33-
<para>The list of all failed services appear.</step>
33+
<para>The list of all failed services appear.</para></step>
3434
<step><para>Identify the severity and content of the error.</para>
3535
<screen>journalctl -p 0..7 -b</screen>
36-
<para>The list of errors with priority level <literal>0 to 7 appears. The errors are marked with priority level:</para>
37-
<itemizedlist><listitem><para><guimenu>0-2</guimenu>: <command>emerg, alert, crit</command>: Critical issues, system collapse imminent.</para></listitem>
36+
<para>The list of errors with priority level <literal>0 to 7</literal> appears. The errors are marked with priority level:
37+
</para>
38+
<itemizedlist>
39+
<listitem><para><guimenu>0-2</guimenu>: <command>emerg, alert, crit</command>: Critical issues, system collapse imminent.</para></listitem>
3840
<listitem><para><guimenu>3</guimenu>: <command>err (Error)</command>: A service or application failed to complete a requested operation.</para></listitem>
39-
<listitem><para><guimenu>4</guimenu>: <command>warning </command>: Something undesirable happened but is not an immediate failure.</para></listitem>
40-
<listitem><para><guimenu>5-7</guimenu>: <command>notice, info, debug</command>: Normal operational information and developer diagnostics.</para></listitem></itemizedlist>
41+
<listitem><para><guimenu>4</guimenu>: <command>warning </command>: Something undesirable happened but is not an immediate failure.</para></listitem>
42+
<listitem><para><guimenu>5-7</guimenu>: <command>notice, info, debug</command>: Normal operational information and developer diagnostics.</para></listitem>
43+
</itemizedlist>
4144
</step>
4245
<step><para>View the error log for the failing service using the following command:</para>
4346
<screen>journalctl -u &lt;failing_service_name&gt;</screen>
4447
<para>The lines preceding the termination message includes information on the error.</para>
45-
<itemizedlist><listitem><para><guimenu>Exit Status</guimenu>: f a service stops, look for a message like Process xxx exited with status 1/FAILURE. A status of 0 is success. Any non-zero status indicates an error. </para></listitem>
48+
<itemizedlist>
49+
<listitem><para><guimenu>Exit Status</guimenu>: f a service stops, look for a message like Process xxx exited with status 1/FAILURE. A status of 0 is success. Any non-zero status indicates an error. </para></listitem>
4650
<listitem><para><guimenu>Configuration Errors</guimenu>: Messages containing phrases like No such file or directory, Permission denied, or Address already in use usually point to a problem in the service's configuration file</para></listitem>
47-
<listitem><para><guimenu>Out-of-Memory (OOM)</guimenu>: Out-of-Memory (OOM)</para></listitem>
48-
</itemizedlist></step>
51+
<listitem><para><guimenu>Out-of-Memory (OOM)</guimenu>: Out-of-Memory (OOM)</para></listitem>
52+
</itemizedlist>
53+
</step>
4954
<step><para>Use detailed views of logs to get detailed information on the error.</para>
5055
<screen>journalctl -xe</screen>
5156
<para>For example, to view all messages from the Apache service during the current boot, with detailed explanations, run the following command:</para>
@@ -56,45 +61,31 @@ in the assembly -->
5661
<procedure>
5762
<para>
5863
This section introduces an example to illustrate how to find and fix
59-
the error reported by &systemd; during <command>apache2</command> start-up.
60-
</para>
64+
the error reported by &systemd; during <command>apache2</command> start-up.</para>
6165
<step>
62-
<para>
63-
Start the apache2 service:
64-
</para>
66+
<para>Start the apache2 service:</para>
6567
<screen>systemctl start apache2
6668
Job for apache2.service failed. See 'systemctl status apache2' and 'journalctl -xn' for details.</screen>
6769
</step>
68-
<step>
69-
<para>
70-
View the service status:
71-
</para>
70+
<step><para>View the service status:</para>
7271
<screen>&prompt.sudo;systemctl status apache2
7372
apache2.service - The Apache Webserver
7473
Loaded: loaded (/usr/lib/systemd/system/apache2.service; disabled)
7574
Active: failed (Result: exit-code) since Tue 2025-09-03 11:08:13 EDT; 7min ago
7675
Process: 11026 ExecStop=/usr/sbin/start_apache2 -D SYSTEMD -DFOREGROUND \
7776
-k graceful-stop (code=exited, status=1/FAILURE)</screen>
78-
<para>
79-
The ID of the process causing the failure is 11026.
80-
</para>
77+
<para>The ID of the process causing the failure is 11026.</para>
8178
</step>
8279
<step>
83-
<para>
84-
View the verbose version of messages related to process ID 11026:
85-
</para>
80+
<para>View the verbose version of messages related to process ID 11026:</para>
8681
<screen>&prompt.sudo;journalctl -o verbose _PID=11026
8782
[...]
8883
MESSAGE=AH00526: Syntax error on line 6 of /etc/apache2/default-server.conf:
8984
[...]
9085
MESSAGE=Invalid command 'DocumenttRoot', perhaps misspelled or defined by a module
9186
[...]</screen>
9287
</step>
93-
<step>
94-
<para>
95-
Fix the typo inside <filename>/etc/apache2/default-server.conf</filename>,
96-
start the apache2 service, and print its status:
97-
</para>
88+
<step><para>Fix the typo inside <filename>/etc/apache2/default-server.conf</filename>, start the apache2 service, and print its status:</para>
9889
<screen>&prompt.sudo;systemctl start apache2 &amp;&amp; systemctl status apache2
9990
apache2.service - The Apache Webserver
10091
Loaded: loaded (/usr/lib/systemd/system/apache2.service; disabled)

0 commit comments

Comments
 (0)