summaryrefslogtreecommitdiffstats
path: root/docs/installationprocedure/installation_guide.rst
blob: 7417f9ec333b7707451d63db21373fac48da0da6 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
.. This work is licensed under a Creative Commons Attribution 4.0 International License.
.. http://creativecommons.org/licenses/by/4.0

Daisy4nfv configuration
=======================

This document provides guidelines on how to install and configure the Danube
release of OPNFV when using Daisy as a deployment tool including required
software and hardware configurations.

Installation and configuration of host OS, OpenStack etc. can be supported by
Daisy on Virtual nodes and Bare Metal nodes.

The audience of this document is assumed to have good knowledge in
networking and Unix/Linux administration.

Prerequisites
-------------

Before starting the installation of the Danube release of OPNFV, some plannings
must be done.


Retrieving the installation bin image
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

First of all, the installation bin which includes packages of Daisy, OS,
OpenStack, and so on is needed for deploying your OPNFV environment.

The stable release bin image can be retrieved via `OPNFV software download page <https://www.opnfv.org/software>`_

The daily build bin image can be retrieved via OPNFV artifacts repository:

http://artifacts.opnfv.org/daisy.html

NOTE: Search the keyword "daisy/Danube" to locate the bin image.

E.g.
daisy/opnfv-gerrit-27155.bin

The git url and sha1 of bin image are recorded in properties files.
According to these, the corresponding deployment scripts can be retrieved.


Retrieve the deployment scripts
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

To retrieve the repository of Daisy on Jumphost use the following command:

- git clone https://gerrit.opnfv.org/gerrit/daisy

To get stable Danube release, you can use the following command:

- git checkout danube.1.0


Setup Requirements
------------------

If you have only 1 Bare Metal server, Virtual deployment is recommended. if you have more
than 3 servers, the Bare Metal deployment is recommended. The minimum number of
servers for each role in Bare metal deployment is listed below.

+------------+------------------------+
| **Role**   | **Number of Servers**  |
|            |                        |
+------------+------------------------+
| Jump Host  | 1                      |
|            |                        |
+------------+------------------------+
| Controller | 1                      |
|            |                        |
+------------+------------------------+
| Compute    | 1                      |
|            |                        |
+------------+------------------------+


Jumphost Requirements
~~~~~~~~~~~~~~~~~~~~~

The Jumphost requirements are outlined below:

1.     CentOS 7.2 (Pre-installed).

2.     Root access.

3.     Libvirt virtualization support(For virtual deployment).

4.     Minimum 1 NIC(or 2 NICs for virtual deployment).

       -  PXE installation Network (Receiving PXE request from nodes and providing OS provisioning)

       -  IPMI Network (Nodes power control and set boot PXE first via IPMI interface)

       -  Internet access (For getting latest OS updates)

       -  External Interface(For virtual deployment, exclusively used by instance traffic to access the rest of the Internet)

5.     16 GB of RAM for a Bare Metal deployment, 64 GB of RAM for a Virtual deployment.

6.     CPU cores: 32, Memory: 64 GB, Hard Disk: 500 GB, (Virtual deployment needs 1 TB Hard Disk)


Bare Metal Node Requirements
----------------------------

Bare Metal nodes require:

1.     IPMI enabled on OOB interface for power control.

2.     BIOS boot priority should be PXE first then local hard disk.

3.     Minimum 1 NIC for Compute nodes, 2 NICs for Controller nodes.

       -  PXE installation Network (Broadcasting PXE request)

       -  IPMI Network (Receiving IPMI command from Jumphost)

       -  Internet access (For getting latest OS updates)

       -  External Interface(For virtual deployment, exclusively used by instance traffic to access the rest of the Internet)




Network Requirements
--------------------

Network requirements include:

1.     No DHCP or TFTP server running on networks used by OPNFV.

2.     2-7 separate networks with connectivity between Jumphost and nodes.

       -  PXE installation Network

       -  IPMI Network

       -  Internet access Network

       -  OpenStack Public API Network

       -  OpenStack Private API Network

       -  OpenStack External Network

       -  OpenStack Tenant Network(currently, VxLAN only)


3.     Lights out OOB network access from Jumphost with IPMI node enabled (Bare Metal deployment only).

4.     Internet access Network has Internet access, meaning a gateway and DNS availability.

5.     OpenStack External Network has Internet access too if you want instances to access the Internet.

Note: **All networks except OpenStack External Network can share one NIC(Default configuration) or use an exclusive**
**NIC(Reconfigurated in network.yml).**


Execution Requirements (Bare Metal Only)
----------------------------------------

In order to execute a deployment, one must gather the following information:

1.     IPMI IP addresses of the nodes.

2.     IPMI login information for the nodes (user/password).