Bug 967367

Summary: NetworkManager needs to be disabled in some installation methods
Product: Red Hat OpenStack Reporter: Stephen Gordon <sgordon>
Component: doc-Installation_and_Configuration_GuideAssignee: Stephen Gordon <sgordon>
Status: CLOSED CURRENTRELEASE QA Contact: ecs-bugs
Severity: urgent Docs Contact:
Priority: unspecified    
Version: 3.0CC: breeler, sdake
Target Milestone: ---Keywords: Documentation
Target Release: 3.0   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Red_Hat_OpenStack-Installation_and_Configuration_Guide-3-en-US-3-16 Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: 967366 Environment:
Last Closed: 2013-07-01 20:25:03 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:
Bug Depends On: 967366    
Bug Blocks:    

Description Stephen Gordon 2013-05-26 21:31:18 UTC
+++ This bug was initially created as a clone of Bug #967366 +++

Document URL: 

Section Number and Name: 
Software Requirements 2.1

Describe the issue: 
NetworkManager is enabled in some installations of RHEL.  In some cases, NetworkManager must be manually disabled for OpenStack networking to operate correctly.

Suggestions for improvement: 
Add a section after 2.1.2
2.1.3 "Disable NetworkManager if enabled"

Some installation methods of RHEL install NetworkManager which interfere with OpenStack Networking.  If these installation methods are chosen, please manually disable NetworkManager.

No action is needed if the installation chosen is:
* Basic Server
* Database Server
* Web Server
* Identity Management Server
* Virtualization Host
* Minimal Install

NetworkManager must be disabled if the installation chosen is:
* Desktop
* Software Development Workstation

Disable network manager by running the commands

$ sudo chkconfig NetworkManager off
$ sudo service NetworkManager stop

Modify the network script related to the network interfaces in 
/etc/sysconfig/network-scripts/ifcfg-ethX where X is the interface
1. Remove the line NM_CONTROLLED=yes
2. Change ONBOOT=no to ONBOOT=yes

Additional information: 
1.
If chkconfig --list NetworkManager displays:
error reading information on service NetworkManager: No such file or directory

Then the user doesn't have to worry about making this change.

2.
If the results are:
$ chkconfig --list NetworkManager
NetworkManager 	0:off	1:off	2:on	3:on	4:on	5:on	6:off

Then the user needs to take action.

Comment 1 Stephen Gordon 2013-05-29 18:24:36 UTC
"Disabling Network Manager" - ID: 17685 [rev: 456034]