Removing excess License info.
[opnfvdocs.git] / docs / installationprocedure / template-os-nosdn-nofeature-ha / installation.rst
1 .. This work is licensed under a Creative Commons Attribution 4.0 International
2 .. License. .. http://creativecommons.org/licenses/by/4.0 ..
3 .. (c) Christopher Price (Ericsson AB) and others
4
5 <scenario> software installation and deployment
6 ===============================================
7
8 .. Let's figure out how to structure this to highlight both virtual and
9 .. bare metal deployments.  I need some help from the scenrio  owners to get
10 .. that right.
11
12 This section describes the installation of the OPNFV installation
13 server (jumphost) as well as the deployment of the <scenario> OPNFV
14 reference platform stack across a server cluster.
15
16 Install jumphost
17 ----------------
18
19 If you have not already done so, prepare your jumphost according the instructions in _#ref_Preparation
20 this can be done using an ISO image with the following commands
21
22 #. Mount the <scenario> ISO file/media as a boot device to the jump host server.
23
24 #. Reboot the jump host to establish the jumphost server.
25
26    - The system now boots from the ISO image.
27
28    - Select "Fuel Install (Static IP)"
29
30    - Press [Enter].
31
32 #. Wait until screen Fuel setup is shown (Note: This can take up to 30 minutes).
33
34 At this time you can continue with the installation according to the following instructions.
35
36 #. In the "Fuel User" section - Confirm/change the default password
37
38    - Enter "admin" in the Fuel password input
39
40    - Enter "admin" in the Confirm password input
41
42    - Select "Check" and press [Enter]
43
44 #. In the "Network Setup" section - Configure DHCP/Static IP information for your FUEL node - For example, ETH0 is 10.20.0.2/24 for FUEL booting and ETH1 is DHCP in your corporate/lab network.
45
46    - Configure eth1 or other network interfaces here as well (if you have them present on your FUEL server).
47
48 #. In the "PXE Setup" section - Change the following fields to appropriate values (example below):
49
50    - DHCP Pool Start 10.20.0.3
51
52    - DHCP Pool End 10.20.0.254
53
54    - DHCP Pool Gateway  10.20.0.2 (IP address of Fuel node)
55
56 #. In the "DNS & Hostname" section - Change the following fields to appropriate values:
57
58    - Hostname
59
60    - Domain
61
62    - Search Domain
63
64    - External DNS
65
66    - Hostname to test DNS
67
68    - Select <Check> and press [Enter]
69
70
71 #. OPTION TO ENABLE PROXY SUPPORT - In the "Bootstrap Image" section, edit the following fields to define a proxy. (**NOTE:** cannot be used in tandem with local repository support)
72
73    - Navigate to "HTTP proxy" and enter your http proxy address
74
75    - Select <Check> and press [Enter]
76
77 #. In the "Time Sync" section - Change the following fields to appropriate values:
78
79    - NTP Server 1 <Customer NTP server 1>
80
81    - NTP Server 2 <Customer NTP server 2>
82
83    - NTP Server 3 <Customer NTP server 3>
84
85 #. Start the installation.
86
87    - Select Quit Setup and press Save and Quit.
88
89    - Installation starts, wait until the login screen is shown.
90
91
92 Boot the Node Servers
93 ---------------------
94
95 After the Fuel Master node has rebooted from the above steps and is at
96 the login prompt, you should boot the Node Servers (Your
97 Compute/Control/Storage blades (nested or real) with a PXE booting
98 scheme so that the FUEL Master can pick them up for control.
99
100 #. Enable PXE booting
101
102    - For every controller and compute server: enable PXE Booting as the first boot device in the BIOS boot order menu and hard disk as the second boot device in the same menu.
103
104 #. Reboot all the control and compute blades.
105
106 #. Wait for the availability of nodes showing up in the Fuel GUI.
107
108    - Connect to the FUEL UI via the URL provided in the Console (default: https://10.20.0.2:8443)
109
110    - Wait until all nodes are displayed in top right corner of the Fuel GUI: Total nodes and Unallocated nodes.
111
112
113 Install additional Plugins/Features on the FUEL node
114 ----------------------------------------------------
115
116 #. SSH to your FUEL node (e.g. root@10.20.0.2  pwd: r00tme)
117
118 #. Select wanted plugins/features from the /opt/opnfv/ directory.
119
120 #. Install the wanted plugin with the command "fuel plugins --install /opt/opnfv/<plugin-name>-<version>.<arch>.rpm"
121    Expected output: "Plugin ....... was successfully installed."
122
123 Create an OpenStack Environment
124 -------------------------------
125
126 #. Connect to Fuel WEB UI with a browser (default: https://10.20.0.2:8443) (login admin/admin)
127
128 #. Create and name a new OpenStack environment, to be installed.
129
130 #. Select "<Liberty on Ubuntu 14.04>" and press <Next>
131
132 #. Select "compute virtulization method".
133
134    - Select "QEMU-KVM as hypervisor" and press <Next>
135
136 #. Select "network mode".
137
138    - Select "Neutron with ML2 plugin"
139
140    - Select "Neutron with tunneling segmentation" (Required when using the ODL or ONOS plugins)
141
142    - Press <Next>
143
144 #. Select "Storage Back-ends".
145
146    - Select "Ceph for block storage" and press <Next>
147
148 #. Select "additional services" you wish to install.
149
150    - Check option "Install Ceilometer (OpenStack Telemetry)" and press <Next>
151
152 #. Create the new environment.
153
154    - Click <Create> Button
155