Bug 707362

Summary: MinorMod: Services and Daemons: Incomplete information about running services
Product: [Fedora] Fedora Documentation Reporter: Suvayu <fatkasuvayu>
Component: deployment-guideAssignee: Jaromir Hradilek <jhradile>
Status: CLOSED CURRENTRELEASE QA Contact: Christopher Antila <christopher>
Severity: low Docs Contact:
Priority: unspecified    
Version: develCC: david, dcantrell, dennis, eric, kwade, wb8rcr, zach
Target Milestone: ---   
Target Release: ---   
Hardware: Unspecified   
OS: Linux   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2011-07-12 22:24:00 UTC Type: ---
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:

Description Suvayu 2011-05-24 20:03:17 UTC
Description of problem:
There is a typo which gives confusing/incomplete information for running services

Version-Release number of selected component (if applicable):
Fedora 15

How reproducible:
Typo

Steps to Reproduce:
1. Open section 7.2 ("Running Services") in a browser
2.
3.
  
Actual results:
At the bottom of the page this example is listed:

To display a list of all active system services, type:

~]$ systemctl list-units --type=service
UNIT                      LOAD   ACTIVE SUB     JOB DESCRIPTION
abrt-ccpp.service         loaded active exited      LSB: Installs coredump handler which saves segfault data
abrt-oops.service         loaded active running     LSB: Watches system log for oops messages, creates ABRT dump directories for each oops
abrtd.service             loaded active running     ABRT Automated Bug Reporting Tool
accounts-daemon.service   loaded active running     Accounts Service
atd.service               loaded active running     Job spooling tools
[output truncated]

As you can see, each line consists of the following columns:

- UNIT — Provides information whether the systemd unit was properly loaded.
- ACTIVE — Provides a high-level unit activation state.
- SUB — Provides a low-level unit activation state.
- JOB — Displays a pending job for a unit.
- DESCRIPTION — Provides a brief description of the service. 

In the example above, the abrtd service is loaded, active, and running,
and it does not have any pending jobs.


Expected results:

To display a list of all active system services, type:

~]$ systemctl list-units --type=service
UNIT                      LOAD   ACTIVE SUB     JOB DESCRIPTION
abrt-ccpp.service         loaded active exited      LSB: Installs coredump handler which saves segfault data
abrt-oops.service         loaded active running     LSB: Watches system log for oops messages, creates ABRT dump directories for each oops
abrtd.service             loaded active running     ABRT Automated Bug Reporting Tool
accounts-daemon.service   loaded active running     Accounts Service
atd.service               loaded active running     Job spooling tools
[output truncated]

As you can see, each line consists of the following columns:

- UNIT — Name of the service.
- LOAD — Provides information whether the systemd unit was properly loaded.
- ACTIVE — Provides a high-level unit activation state.
- SUB — Provides a low-level unit activation state.
- JOB — Displays a pending job for a unit.
- DESCRIPTION — Provides a brief description of the service. 

In the example above, the abrtd service is loaded, active, and running,
and it does not have any pending jobs.

Additional info:

Comment 1 John J. McDonough 2011-06-03 19:55:00 UTC
There is no section 7.2 in the Release Notes, nor can I locate any text similar to what you report.

Is it possible this was intended for another document?

Comment 2 John J. McDonough 2011-07-05 23:34:00 UTC
OK, I went searching and figured out this is for the deployment guide

Comment 3 Jaromir Hradilek 2011-07-06 01:47:25 UTC
Hi,

This is indeed an error on my part, many thanks for reporting it! I am going to fix it tomorrow.

Comment 4 Jaromir Hradilek 2011-07-11 23:42:33 UTC
Fixed in commit 764bbf5f779c0cd9b10b3ceab6db4ad6a9eff98a

Comment 5 Jaromir Hradilek 2011-07-12 11:33:39 UTC
The updated version of the book is now public: http://docs.fedoraproject.org/en-US/Fedora/15/html/Deployment_Guide/s1-services-running.html#s3-services-running-checking

Chris,

Do you want to review the section before I close this bug?

Thanks,
Jaromir

Comment 6 Christopher Antila 2011-07-12 21:56:33 UTC
I have verified that the bug is fixed in the Fedora 15 Deployment Guide, so this report can be closed.

The document would be more clear if examples 7.3 and 7.4 were integrated with the paragraphs that explain the commands demonstrated therein. Examples 7.1 and 7.2 are both well-integrated. Perhaps this is a revision for Fedora 16?

Comment 7 Jaromir Hradilek 2011-07-12 22:24:00 UTC
Thanks Chris! You are of course right with those examples, I am going to change that in the source code to make sure it is fixed the next time I republish the book.

Based on comment 6, I am closing this bug.