blob: da70b08e083e90ea0e6c399304400ad7ee502bf4 [file] [log] [blame]
Filip Pytloun4a72d792015-10-06 16:28:32 +02001
2==============
Ales Komarek880f02f2016-01-25 13:19:23 +01003Nova
Filip Pytloun4a72d792015-10-06 16:28:32 +02004==============
5
Jakub Pavlikfcf34f82016-05-20 09:35:51 +02006OpenStack Nova provides a cloud computing fabric controller, supporting a wide
7variety of virtualization technologies, including KVM, Xen, LXC, VMware, and
8more. In addition to its native API, it includes compatibility with the
9commonly encountered Amazon EC2 and S3 APIs.
Filip Pytloun4a72d792015-10-06 16:28:32 +020010
11Sample pillars
12==============
13
14Controller nodes
15----------------
16
17Nova services on the controller node
18
19.. code-block:: yaml
20
21 nova:
22 controller:
23 version: juno
24 enabled: true
25 security_group: true
Lachlan Evensonb72de502016-01-20 15:34:04 -080026 cpu_allocation_ratio: 8.0
27 ram_allocation_ratio: 1.0
Jiri Konecny9344a372016-03-21 19:25:48 +010028 disk_allocation_ratio: 1.0
Jiri Konecnyb5a80e42016-03-22 11:51:01 +010029 workers: 8
Jakub Pavlik617a8962016-09-04 18:50:06 +020030 report_interval: 60
Filip Pytloun4a72d792015-10-06 16:28:32 +020031 bind:
32 public_address: 10.0.0.122
33 public_name: openstack.domain.com
34 novncproxy_port: 6080
35 database:
36 engine: mysql
37 host: 127.0.0.1
38 port: 3306
39 name: nova
40 user: nova
41 password: pwd
42 identity:
43 engine: keystone
44 host: 127.0.0.1
45 port: 35357
46 user: nova
47 password: pwd
48 tenant: service
49 message_queue:
50 engine: rabbitmq
51 host: 127.0.0.1
52 port: 5672
53 user: openstack
54 password: pwd
55 virtual_host: '/openstack'
56 network:
57 engine: neutron
58 host: 127.0.0.1
59 port: 9696
Jakub Pavlik617a8962016-09-04 18:50:06 +020060 extension_sync_interval: 600
Filip Pytloun4a72d792015-10-06 16:28:32 +020061 identity:
62 engine: keystone
63 host: 127.0.0.1
64 port: 35357
65 user: neutron
66 password: pwd
67 tenant: service
68 metadata:
69 password: password
Petr Michalecaa23dc02016-11-29 16:30:25 +010070 audit:
71 enabled: false
Filip Pytloun4a72d792015-10-06 16:28:32 +020072
Jiri Konecnye31f2c52016-04-14 17:16:02 +020073
Filip Pytloun4a72d792015-10-06 16:28:32 +020074Nova services from custom package repository
75
76.. code-block:: yaml
77
78 nova:
79 controller:
80 version: juno
81 source:
82 engine: pkg
83 address: http://...
84 ....
85
Jiri Konecnye31f2c52016-04-14 17:16:02 +020086
87Client-side RabbitMQ HA setup
88
89.. code-block:: yaml
90
91 nova:
92 controller:
93 ....
94 message_queue:
95 engine: rabbitmq
96 members:
97 - host: 10.0.16.1
98 - host: 10.0.16.2
99 - host: 10.0.16.3
100 user: openstack
101 password: pwd
102 virtual_host: '/openstack'
103 ....
104
105
Petr Michalecaa23dc02016-11-29 16:30:25 +0100106Enable auditing filter, ie: CADF
107
108.. code-block:: yaml
109
110 nova:
111 controller:
112 autidt:
113 enabled: true
114 ....
115 filter_factory: 'keystonemiddleware.audit:filter_factory'
116 map_file: '/etc/pycadf/nova_api_audit_map.conf'
117 ....
118
119
Filip Pytloun4a72d792015-10-06 16:28:32 +0200120Compute nodes
121-------------
122
123Nova controller services on compute node
124
125.. code-block:: yaml
126
127 nova:
128 compute:
129 version: juno
130 enabled: true
131 virtualization: kvm
132 security_group: true
133 bind:
134 vnc_address: 172.20.0.100
135 vnc_port: 6080
136 vnc_name: openstack.domain.com
137 vnc_protocol: http
138 database:
139 engine: mysql
140 host: 127.0.0.1
141 port: 3306
142 name: nova
143 user: nova
144 password: pwd
145 identity:
146 engine: keystone
147 host: 127.0.0.1
148 port: 35357
149 user: nova
150 password: pwd
151 tenant: service
152 message_queue:
153 engine: rabbitmq
154 host: 127.0.0.1
155 port: 5672
156 user: openstack
157 password: pwd
158 virtual_host: '/openstack'
159 image:
160 engine: glance
161 host: 127.0.0.1
162 port: 9292
163 network:
164 engine: neutron
165 host: 127.0.0.1
166 port: 9696
167 identity:
168 engine: keystone
169 host: 127.0.0.1
170 port: 35357
171 user: neutron
172 password: pwd
173 tenant: service
174 qemu:
175 max_files: 4096
176 max_processes: 4096
177
178Nova services on compute node with OpenContrail
179
180.. code-block:: yaml
181
182 nova:
183 compute:
184 enabled: true
185 ...
186 networking: contrail
187
Jiri Konecnye31f2c52016-04-14 17:16:02 +0200188
Filip Pytloun4a72d792015-10-06 16:28:32 +0200189Nova services on compute node with memcached caching
190
191.. code-block:: yaml
192
193 nova:
194 compute:
195 enabled: true
196 ...
197 cache:
198 engine: memcached
199 members:
200 - host: 127.0.0.1
201 port: 11211
202 - host: 127.0.0.1
203 port: 11211
204
Jiri Konecnye31f2c52016-04-14 17:16:02 +0200205
206Client-side RabbitMQ HA setup
207
208.. code-block:: yaml
209
210 nova:
211 controller:
212 ....
213 message_queue:
214 engine: rabbitmq
215 members:
216 - host: 10.0.16.1
217 - host: 10.0.16.2
218 - host: 10.0.16.3
219 user: openstack
220 password: pwd
221 virtual_host: '/openstack'
222 ....
223
maxstack39e6aca2016-05-04 13:50:13 +0000224
225Nova with ephemeral configured with Ceph
226
227.. code-block:: yaml
228
229 nova:
230 compute:
231 enabled: true
232 ...
233 ceph:
234 ephemeral: yes
235 rbd_pool: nova
236 rbd_user: nova
237 secret_uuid: 03006edd-d957-40a3-ac4c-26cd254b3731
238
239
Jakub Pavlikfcf34f82016-05-20 09:35:51 +0200240Documentation and Bugs
241============================
Jiri Konecnye31f2c52016-04-14 17:16:02 +0200242
Jakub Pavlikfcf34f82016-05-20 09:35:51 +0200243To learn how to deploy OpenStack Salt, consult the documentation available
244online at:
Jiri Konecnye31f2c52016-04-14 17:16:02 +0200245
Jakub Pavlikfcf34f82016-05-20 09:35:51 +0200246 https://wiki.openstack.org/wiki/OpenStackSalt
Filip Pytloun4a72d792015-10-06 16:28:32 +0200247
Jakub Pavlikfcf34f82016-05-20 09:35:51 +0200248In the unfortunate event that bugs are discovered, they should be reported to
249the appropriate bug tracker. If you obtained the software from a 3rd party
250operating system vendor, it is often wise to use their own bug tracker for
251reporting problems. In all other cases use the master OpenStack bug tracker,
252available at:
253
254 http://bugs.launchpad.net/openstack-salt
255
256Developers wishing to work on the OpenStack Salt project should always base
257their work on the latest formulas code, available from the master GIT
258repository at:
259
260 https://git.openstack.org/cgit/openstack/salt-formula-nova
261
262Developers should also join the discussion on the IRC list, at:
263
maxstack39e6aca2016-05-04 13:50:13 +0000264 https://wiki.openstack.org/wiki/Meetings/openstack-salt