fuel/build/DOC/INSTALL/README

   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 ##############################################################################
  10
  11
  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.
  17
  18 2. Reboot the fuel server.
  19    The system now boots from the ISO image.
  20
  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.
  25    Press Enter.
  26
  27 4  Wait until screen Fuel setup . is shown.
  28    Note: This takes about 30 minutes.
  29
  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
  35
  36 6. Select DNS & Hostname and change the following fields to appropriate values:
  37    Hostname <CEE Region name>-fuel
  38    Domain <Domain Name>
  39    Search Domain <Search Domain Name>
  40    Hostname to test DNS <Hostname to test DNS>
  41
  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.
  47
  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.
  52
  53 10. Enable PXE Booting and put it first in the bios boot order menu.
  54
  55 11. Reboot the controller- and compute blades.
  56
  57 12. Connect to Fuel wit a browser towards port 8000
  58
  59 13. Create and name a new OpenStack environment, to be installed.
  60
  61 14. Select Icehouse on Ubuntu . in field OpenStack Release.
  62
  63 15. Select deployment mode.
  64     Select the Multi-node with HA.
  65
  66 16. Select compute node mode.
  67     Select KVM as hypervisor.
  68
  69 17. Select network mode.
  70     Select Neutron with VLAN segmentation.
  71
  72 18. Select Storage Backends.
  73     Select Ceph for Cinder and default for glance.
  74
  75
  76 19. Select additional services.
  77     Check option Install Celiometer (OpenStack Telemetry).
  78
  79 20. Create the new environment.
  80
  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.
  83
  84 22. Open the created environment.
  85
  86 23. Open the networks tab.
  87
  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>
  94     Check  VLAN tagging.
  95     Set appropriate VLAN id.
  96
  97 25. Update the management configuration.
  98     Set CIDR to 172.16.255.128/25.
  99     Check VLAN tagging.
 100     Set appropriate  VLAN id.
 101
 102 26. Update the storage configuration.
 103     Set CIDR to the appropriate value
 104     Check VLAN tagging.
 105     Set appropriate VLAN id.
 106
 107 27. Update the Neutron L2 configuration.
 108     Set VLAN ID range.
 109
 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.
 114     Set DNS Servers
 115
 116 29. Save Settings.
 117
 118 30. Click "verify network" to check the network set-up
 119
 120 31. Update storage configuration.
 121
 122 32. Open the nodes tab.
 123
 124 33. Assign roles.
 125     Check Controller and Telemetry . MongoDB.
 126     Check three nodes to be installed as Controller in pane Assign Role.
 127     Click Apply Changes.
 128     Check Compute.
 129     Check nodes to be installed as Compute nodes in pane Assign Role.
 130     Click Apply Changes.
 131
 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
 137
 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>
 142
 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.
 147
 148 37. Deploy the environment.
 149     In the Fuel GUI, click Deploy Changes.
 150
 151 38 Verify the OpenStack Environment
 152    Open the Health Check tab .
 153    Select Select All.
 154    Click Run tests.