Bug 980931

Summary: The Virtualization Administration Guide Still Uses UNIX System V Commands
Product: [Retired] Fedora Documentation Reporter: Jaromir Hradilek <jhradile>
Component: virtualization-administration-guideAssignee: Jaromir Hradilek <jhradile>
Status: CLOSED WONTFIX QA Contact: Fedora Docs QA <docs-qa>
Severity: medium Docs Contact:
Priority: unspecified    
Version: develCC: jhradile, me
Target Milestone: ---Keywords: Documentation
Target Release: ---   
Hardware: Unspecified   
OS: Linux   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2017-08-31 19:34:22 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:
Attachments:
Description Flags
Proposed patch none

Description Jaromir Hradilek 2013-07-03 15:11:28 UTC
Description of problem:
The Virtualization Administration Guide for Fedora 18 [1] still uses UNIX System V commands “service” and “chkconfig”. Although these commands still work and will continue to work in the foreseeable future, users are strongly advised to learn and use the new command that is shipped with systemd and is part of the Fedora distribution since version 15.

Version-Release number of selected component (if applicable):
Fedora-Virtualization_Administration_Guide-18-en-US-1.0-1

How reproducible:
Always.

Steps to Reproduce:
Read section 14.3, “Starting and stopping the daemon” [2], to learn how to configure the vhostmd service to start automatically at boot time.

Actual results:
/sbin/chkconfig vhostmd on

Expected results:
systemctl enable vhostmd.service

Additional info:
http://fedoraproject.org/wiki/SysVinit_to_Systemd_Cheatsheet

-----

[1] http://docs.fedoraproject.org/en-US/Fedora/18/html-single/Virtualization_Administration_Guide/index.html

[2] http://docs.fedoraproject.org/en-US/Fedora/18/html-single/Virtualization_Administration_Guide/index.html#idm58208592

Comment 1 Jaromir Hradilek 2013-07-03 15:18:17 UTC
Created attachment 768279 [details]
Proposed patch

Please note that the “service iptables save” command in section 11.1.5.1, “Configuring a software iSCSI target”, is left intact intentionally: systemctl is not able to handle the save command and the use of the service utility is therefore correct in this situation. Refer to bug 748134 for more information.

Comment 3 Pete Travis 2017-08-31 19:34:22 UTC
The virtualization guide has not been maintained for a while, and most of this content will be converted, reviewed, and rewritten before being published again.  I'm hoping whomever does that work will update the commands as basic due dilligence and that we don't need to keep a specific ticket open for it.

For now, I am closing this bug because the work it was filed against is not actively maintained.