[Doc] Quick start guide - Installing Mirantis OpenStack Manually

[Serhii Ovsianikov]

(-) Line should be removed
(+) Line should be added
>>> My comments (only for this bug)

https://docs.mirantis.com/fuel/fuel-8.0/quickstart-guide.html#installing-mirantis-openstack-manually

Virtual Machine Requirements

Fuel Master Node:
(+)CPU: 2
(-)HDD (VDI): 50 GB dynamically allocated
(+)HDD (VDI): 64 GB dynamically allocated

Fuel Slave Nodes:
(-)HDD (VDI): 50+ GB, with dynamic disk expansion
(+)HDD (VDI): 3 discs of 64+ GB each, with dynamic disk expansion

Configuring the Network
VirtualBox creates new Ethernet adapters. For the purpose of example, Ethernet adapters’ names are:
(+)For Linux host:
vboxnet0
vboxnet1
vboxnet2
(+)For Windows host with Cygwin:
(+)VirtualBox Host-Only Ethernet Adapter
(+)VirtualBox Host-Only Ethernet Adapter #2
(+)VirtualBox Host-Only Ethernet Adapter #3

(-)Modify the settings of the vboxnet0 adapter:
(+)Modify the settings of the vboxnet0 (or VirtualBox Host-Only Ethernet Adapter) adapter:

(-)Modify the settings of the vboxnet1 adapter:
(+)Modify the settings of the vboxnet1 (or VirtualBox Host-Only Ethernet Adapter #2) adapter:

(-)Modify the settings for the vboxnet2 adapter:
(+)Modify the settings for the vboxnet2 (or VirtualBox Host-Only Ethernet Adapter #3) adapter:

Creating Virtual Machines
2. In the Fuel Master node network settings, configure the following network adapters:
(+)For Linux host:
Adapter 1: Host-only adapter vboxnet0
Adapter 2: Host-only adapter vboxnet1
Adapter 3: NAT
(+)For Windows host with Cygwin:
(+)Adapter 1: Host-only adapter "VirtualBox Host-Only Ethernet Adapter"
(+)Adapter 2: Host-only adapter "VirtualBox Host-Only Ethernet Adapter #2"
(+)Adapter 3: NAT

(+)3. Right-click on a Fuel Master node VM and select System - Processor, enable checkbox "Enable PAE/NX" and increase number of CPU=2 Click OK.

(-)In Boot Order, select Network
(+)In Boot Order, select Network and remove check-box from Floppy and Optical

(+)Change priority boot: 1-Network, 2-Hard disk
(+)Select System - Processor, enable checkbox "Enable PAE/NX"

Configure the following network adapters:
(+)For Linux host:
Adapter 1: Host-only adapter vboxnet0
Adapter 2: Host-only adapter vboxnet1
Adapter 3: Host-only adapter vboxnet2
(+)For Windows host with Cygwin:
(+)Adapter 1: Host-only adapter "VirtualBox Host-Only Ethernet Adapter"
(+)Adapter 2: Host-only adapter "VirtualBox Host-Only Ethernet Adapter #2"
(+)Adapter 3: NAT

(+)Add 2 HDD to the Slave nodes:
(+) Right-click on a Fuel Slave node VM and select Storage
(+)Select "Controller SATA" and "Add Hard Disk" - Create new disk - VDI - Dynamically allocated - size 64 Gb.

Installing Fuel
(-)When prompted, select DVD Fuel Install.
(+)When prompted, select 1. Fuel Install (Static IP).

(-)Fuel installs on the virtual machine. It may take some time. The network configuration screen displays:
(+)Fuel installs on the virtual machine. It may take some time. The network configuration screen displays (the menu does not appear by default).

>>>Need update the image https://docs.mirantis.com/fuel/fuel-8.0/_images/src_network_setup.png from Fuel 8.0 (see attachment)

5. Log in to the Fuel Master Node CLI using the default credentials

>>>Add all the commands below
Follow the steps to configure network interfaces:

Make backups, remove network manager options, disable defaults, enable boot and disable network manager
sed -i.orig '/^UUID=\\\|^NM_CONTROLLED=/d;s/^\\\(.*\\\)=yes/\\\1=no/g;s/^ONBOOT=.*/ONBOOT=yes/;/^ONBOOT=/iNM_CONTROLLED=no' /etc/sysconfig/network-scripts/ifcfg-eth{0,1,2}

eth1 should be static with private ip address and provided netmask
sed -i 's/^BOOTPROTO=.*/BOOTPROTO=static/;/^BOOTPROTO/aIPADDR=172.16.0.1\nNETMASK=255.255.255.0' /etc/sysconfig/network-scripts/ifcfg-eth1

eth2 should get ip address via dhcp and used default route
sed -i 's/^BOOTPROTO=.*/BOOTPROTO=dhcp/;s/^DEFROUTE=.*/DEFROUTE=yes/;/^BOOTPROTO/aPERSISTENT_DHCLIENT=yes' /etc/sysconfig/network-scripts/ifcfg-eth2

Make backup and disable zeroconf at all because we should use only DHCP on eth2
sed -i.orig '/NOZEROCONF/d;aNOZEROCONF=yes' /etc/sysconfig/network

Remove default route from eth0 and system wide settings if exists
sed -i '/^GATEWAY=/d' /etc/sysconfig/network /etc/sysconfig/network-scripts/ifcfg-eth0

Fix bug https://bugs.centos.org/view.php?id=7351
sed -i.orig '/^DEVICE=lo/aTYPE=Loopback' /etc/sysconfig/network-scripts/ifcfg-lo

Enable NAT (MASQUERADE) and forwarding for the public network
iptables -I FORWARD 1 --dst 172.16.0.0/24 -j ACCEPT
iptables -I FORWARD 1 --src 172.16.0.0/24 -j ACCEPT
iptables -t nat -A POSTROUTING -s 172.16.0.0/24 \! -d 172.16.0.0/24 -j MASQUERADE
service iptables save

Disable NetworkManager and apply the network changes
nmcli networking off &>/dev/null ; service network restart

Check internet connection from the Fuel master node
[root@fuel ~]# ping -c 3 google.com
PING google.com (216.58.214.206) 56(84) bytes of data.
64 bytes from bud02s23-in-f14.1e100.net (216.58.214.206): icmp_seq=1 ttl=54 time=31.0 ms
64 bytes from bud02s23-in-f14.1e100.net (216.58.214.206): icmp_seq=2 ttl=54 time=30.1 ms
64 bytes from bud02s23-in-f14.1e100.net (216.58.214.206): icmp_seq=3 ttl=54 time=30.0 ms

(+)Create bootstrap image for slave nodes

(+)[root@fuel ~]# fuel-bootstrap -v --debug build --activate

(+)Check bootstrap images
(+)[root@fuel ~]# fuel-bootstrap list
(+)+--------------------------------------+--------------------------------------+--------+
(+)| uuid | label | status |
(+)+--------------------------------------+--------------------------------------+--------+
(+)| dd2f45bf-08c2-4c39-bd2d-6d00f26d6540 | dd2f45bf-08c2-4c39-bd2d-6d00f26d6540 | active |
(+)| centos | deprecated | |
(+)+--------------------------------------+--------------------------------------+--------+

(+)Start slave nodes in VirtualBox

>>>All lines below should be deleted
6. Verify the eth1 configuration:
1. Type:
vi /etc/sysconfig/network-scripts/ifcfg-eth1
2. Verify that the lines listed below have the following values:
DEVICE=eth1
TYPE=Ethernet
ONBOOT=yes
NM_CONTROLLED=no
BOOTPROTO=static
IPADDR=172.16.0.1
NETMASK=255.255.255.0
3. Modify if needed.
Save changes and quit:
:qw!
7. Configure the IP tables rerouting:
iptables -t nat -A POSTROUTING -s 172.16.0.0/24 \! -d 172.16.0.0/24 -j MASQUERADE

P.S. May be you can find the best way for describing network interfaces for Linux and Windows

[Fuel Devops McRobotson (fuel-devops-robot)]

Fix proposed to branch: master
Change author: Svetlana Karslioglu <email address hidden>
Review: https://review.fuel-infra.org/17670

[Fuel Devops McRobotson (fuel-devops-robot)]

Reviewed: https://review.fuel-infra.org/17670
Submitter: Svetlana Karslioglu <email address hidden>
Branch: master

Commit: 5498caf88448e6c4eb209c8f05fc9f05850a7988
Author: Svetlana Karslioglu <email address hidden>
Date: Wed Mar 9 21:22:01 2016

Update QuickStart for 8.0

Updated QuickStart Guide to address changes in 8.0.

Change-Id: Idbb73209342b6815831e888df4398a29aab7394c
Closes-bug: #1551685

[Fuel Devops McRobotson (fuel-devops-robot)]

Fix proposed to branch: stable/8.0
Change author: Svetlana Karslioglu <email address hidden>
Review: https://review.fuel-infra.org/17941

[Fuel Devops McRobotson (fuel-devops-robot)]

Reviewed: https://review.fuel-infra.org/17941
Submitter: Svetlana Karslioglu <email address hidden>
Branch: stable/8.0

Commit: 68961275327e9c8df293068492f4c26417eedc96
Author: Svetlana Karslioglu <email address hidden>
Date: Thu Mar 10 17:50:07 2016

Update QuickStart for 8.0

Updated QuickStart Guide to address changes in 8.0.

Change-Id: Idbb73209342b6815831e888df4398a29aab7394c
Closes-bug: #1551685
(cherry picked from commit 5498caf88448e6c4eb209c8f05fc9f05850a7988)