1 ##############################################################################
2 # Copyright (c) 2015 Ericsson AB and others.
3 # stefan.k.berg@ericsson.com
4 # jonas.bjurel@ericsson.com
5 # All rights reserved. This program and the accompanying materials
6 # are made available under the terms of the Apache License, Version 2.0
7 # which accompanies this distribution, and is available at
8 # http://www.apache.org/licenses/LICENSE-2.0
9 ##############################################################################
12 This README file describes how to install the OPNFV BGS Stack
13 =============================================================
14 1.1 Install Fuel Server
15 -----------------------
16 1. Mount the built .iso file (release/opnfv-<version>.iso) as a bootdevice to the fuel server.
18 2. Reboot the fuel server.
19 The system now boots from the ISO image.
21 3. Change the grub boot params
22 When Press Tab to edit . is shown press Tab.
23 Change showmenu=no to showmenu=yes.
24 Change netmask=255.255.255.0 to netmask=255.255.0.0.
27 4 Wait until screen Fuel setup . is shown.
28 Note: This takes about 30 minutes.
30 5. Select PXE Setup and change the following fields to appropriate values (example below):
31 Static Pool Start 10.20.0.3
32 Static Pool End 10.20.0.254
33 DHCP Pool Start 10.20.128.3
34 DHCP Pool End 10.20.128.254
36 6. Select DNS & Hostname and change the following fields to appropriate values:
37 Hostname <CEE Region name>-fuel
39 Search Domain <Search Domain Name>
40 Hostname to test DNS <Hostname to test DNS>
42 7. Select Time Sync and change the following fields to appropriate values:
43 NTP Server 1 <Customer NTP server 1>
44 NTP Server 2 <Customer NTP server 2>
45 NTP Server 3<Customer NTP server 3>
46 Note: This step is only to pass the network test, the actual ntp parameters will be set with the pre_deply script.
48 8. Start the installation.
49 Select Quit Setup and press Save and Quit.
50 Installation starts, wait until a screen with logon credentials is shown.
51 Note: This takes about 15 minutes.
53 10. Enable PXE Booting and put it first in the bios boot order menu.
55 11. Reboot the controller- and compute blades.
57 12. Connect to Fuel wit a browser towards port 8000
59 13. Create and name a new OpenStack environment, to be installed.
61 14. Select Icehouse on Ubuntu . in field OpenStack Release.
63 15. Select deployment mode.
64 Select the Multi-node with HA.
66 16. Select compute node mode.
67 Select KVM as hypervisor.
69 17. Select network mode.
70 Select Neutron with VLAN segmentation.
72 18. Select Storage Backends.
73 Select Ceph for Cinder and default for glance.
76 19. Select additional services.
77 Check option Install Celiometer (OpenStack Telemetry).
79 20. Create the new environment.
81 21. Wait for availability nodes.
82 Wait until all nodes are displayed in top right in <total number of server> TOTAL NODES and <total number of servers> UNALLOCATED NODES.
84 22. Open the created environment.
86 23. Open the networks tab.
88 24. Update the public configuration.
89 Change the following fields to appropriate values:
90 IP Range Start to <Public IP Address start>
91 IP Range End to <Public IP Address end>
92 CIDR to <CIDR for Public IP Addresses>
93 Gateway to <Gateway for Public IP Addresses>
95 Set appropriate VLAN id.
97 25. Update the management configuration.
98 Set CIDR to 172.16.255.128/25.
100 Set appropriate VLAN id.
102 26. Update the storage configuration.
103 Set CIDR to the appropriate value
105 Set appropriate VLAN id.
107 27. Update the Neutron L2 configuration.
110 28. Update the Neutron L3 configuration.
111 Set Internal network CIDR to an appropriate value
112 Set Internal network gateway to an appropriate value
113 Set Floating IP ranges.
118 30. Click "verify network" to check the network set-up
120 31. Update storage configuration.
122 32. Open the nodes tab.
125 Check Controller and Telemetry . MongoDB.
126 Check three nodes to be installed as Controller in pane Assign Role.
129 Check nodes to be installed as Compute nodes in pane Assign Role.
132 34. Configure interfaces.
133 Check Select All to select all nodes with Control, Telemetry . MongoDB and Compute node roles.
134 Click Configure Interfaces.
135 Screen Configure interfaces on number of <number of nodes> nodes is shown.
136 Assign interfaces (bonded) for mgmt-, admin-, private-, public- and storage networks
138 35. Run the pre-deploy script.
139 Log on as root to the Fuel node.
140 Print Fuel environment Id (fuel env)
141 #> id | status | name | mode | release_id | changes <id>| new | <CEE Region name>| ha_compact | 2 | <ite specific information>
143 36. Run the pre-deployment script (/opt/opnfv/pre-deploy.sh <id>)
144 As prompted for-, set the DNS servers to go into /etc/resolv.conf.
145 As prompted for-, set any Hosts file additions for controllers and compute nodes. You will be prompted for name, FQDN and IP for each entry. Press return when prompted for a name when you have completed your input.
146 As prompted for-, set NTP upstream configuration for controllers. You will be prompted for a NTP server each entry. Press return when prompted for a NTP server when you have completed your input.
148 37. Deploy the environment.
149 In the Fuel GUI, click Deploy Changes.
151 38 Verify the OpenStack Environment
152 Open the Health Check tab .