Bug 250930

Summary: Chapter 19.17. Laptop Configurations, mentions nonexistent file /etc/rc3.d/S99XenLaptopNAT
Product: Red Hat Enterprise Linux 5 Reporter: Marcelo Giles <mgiles>
Component: doc-Virtualization_GuideAssignee: Don Domingo <ddomingo>
Status: CLOSED NEXTRELEASE QA Contact: Content Services Development <ecs-dev-list>
Severity: low Docs Contact:
Priority: medium    
Version: 5.0CC: ddomingo
Target Milestone: ---Keywords: Documentation
Target Release: ---   
Hardware: All   
OS: Linux   
URL: http://www.redhat.com/docs/manuals/enterprise/RHEL-5-manual/Virtualization-en-US/ch-virt-laptop-configurations.html
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2008-01-15 01:26:56 UTC Type: ---
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
Original script
none
Proposed script none

Description Marcelo Giles 2007-08-05 14:53:39 UTC
From Bugzilla Helper:
User-Agent: Mozilla/5.0 (X11; U; Linux i686; en-US; rv:1.8.0.12) Gecko/20070529 Red Hat/1.5.0.12-1.el5 Firefox/1.5.0.12

Description of problem:
Chapter 19.17. Laptop Configurations of the Virtualization Guide reads:

"It is a good idea to enable NAT in domain0 so that domU can access the
public net. This way, even wireless users can work around the Red Hat
Virtualization wireless limitations. To do this, you must modify the
S99XenLaptopNAT  file that resides in the /etc/rc3.d directory to
reflect the example below:"

- Script attached.

I couldn't find the S99XenLaptopNAT file that was supposed to be in
/etc/rc3.d (I'm using RHEL5 Client). But, even if this file existed, it should be a symbolic link pointing to a shell script located in /etc/rc.d/init.d, instead of being the script itself.

This should also take care of the next paragraph, which is innacurate:

"If you want to automatically have the network setup at boot time, you
must create a softlink to /etc/rc3.d/S99XenLaptopNAT."

Because if you already have a script in /etc/rc3.d, it would start the setup anyway (at least in runlevel 3) and because the contents of the /etc/rcX.d directories should be symbolic links only.

- See next attachment for proposed script.

To make the script effective, the steps would be:

1) Create a XenLaptopNAT script file in /etc/rc.d/init.d/ and make it executable, chmod +x XenLaptopNAT.
2) run chkconfig --add XenLaptopNAT. 
3) run chkconfig XenLaptopNAT on.
4) run service XenLaptopNAT start, or reboot the machine to test it.

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


How reproducible:
Always


Steps to Reproduce:
Not applicable.

Actual Results:


Expected Results:


Additional info:

Comment 1 Marcelo Giles 2007-08-05 14:55:59 UTC
Created attachment 160710 [details]
Original script

Comment 2 Marcelo Giles 2007-08-05 14:57:03 UTC
Created attachment 160711 [details]
Proposed script

Comment 3 Red Hat Bugzilla 2007-10-03 01:15:30 UTC
User bcleary's account has been closed

Comment 4 David O'Brien 2007-10-03 03:11:16 UTC
Reassigning to Don. Virtualization now part of RHEL.

Comment 5 Don Domingo 2007-10-03 05:26:35 UTC
fixed in source. setting as MODIFIED