blob: e5cecf53dc2977f20429292f6a4739ba3f05c819 (
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
|
Developer Environment
=====================
If you are developing Kolla on an existing OpenStack cloud that supports
Heat, then follow the Heat template
`README <https://github.com/stackforge/kolla/blob/master/devenv/README.md>`__.
Another option available on systems with VirutalBox is the use of
`Vagrant <https://github.com/stackforge/kolla/blob/master/docs/vagrant.md>`__.
The best experience is available with bare metal deployment by following
the instructions below to manually create your Kolla deployment.
Installing Dependencies
-----------------------
NB: Kolla will not run on Fedora 22 or later. Fedora 22 compresses
kernel modules with the .xz compressed format. The guestfs system cannot
read these images because a dependent package supermin in CentOS needs
to be updated to add .xz compressed format support.
To install Kolla depenedencies use:
::
git clone http://github.com/stackforge/kolla
cd kolla
sudo pip install -r requirements.txt
In order to run Kolla, it is mandatory to run a version of ``docker``
that is 1.7.0 or later.
For most systems you can install the latest stable version of Docker
with the following command:
::
curl -sSL https://get.docker.io | bash
For Ubuntu based systems, do not use AUFS when starting Docker daemon
unless you are running the Utopic (3.19) kernel. AUFS requires
CONFIG\_AUFS\_XATTR=y set when building the kernel. On Ubuntu, versions
prior to 3.19 did not set that flag. If you are unable to upgrade your
kernel, you should use a different storage backend such as btrfs.
Next, install the OpenStack python clients if they are not installed:
::
sudo pip install -U python-openstackclient
Finally stop libvirt on the host machine. Only one copy of libvirt may
be running at a time.
::
service libvirtd stop
The basic starting environment will be created using ``ansible``. This
environment will start up the OpenStack services listed in the inventory
file.
Starting Kolla
--------------
Configure Ansible by reading the Kolla
`Ansible configuration <https://github.com/stackforge/kolla/blob/master/docs/ansible-deployment.md>`__ documentation.
Next, run the start command:
::
$ sudo ./tools/kolla-ansible deploy
A bare metal system takes three minutes to deploy AIO. A virtual machine
takes five minutes to deploy AIO. These are estimates; your hardware may
be faster or slower but should near these results.
Debugging Kolla
---------------
You can determine a container's status by executing:
::
$ sudo docker ps -a
If any of the containers exited you can check the logs by executing:
::
$ sudo docker logs <container-name>
|
