175 Commits

Author SHA1 Message Date
Dave McCowan
c2ccf572d6 Remove Disable HAProxy option from Quick Start Guide
The disable HAProxy option is not commonly used and not
recommended.  This patch moves the section that describes it
out of the Quick Start Guide and into the Advanced Configuration
Guide.

Change-Id: Iccd8a6369d772bd85f304cba0a99300180a369c8
Closes-Bug: #1569560
2016-04-12 16:27:56 -04:00
Jenkins
e2b250f7c3 Merge "Add note about heat being busted for development" 2016-04-12 09:32:04 +00:00
Jenkins
8b0a0f7244 Merge "Add LVM2/iSCSI documentation" 2016-04-12 04:51:41 +00:00
Steven Dake
9119e2e360 Add note about heat being busted for development
Heat development environments don't work at all.

As such document this so folks avoid them unless they want to
work on making them better.

Change-Id: Ibe3296660d30ccc24213c272ef379e6d3e2c21f2
2016-04-11 00:22:33 -07:00
Serguei Bezverkhi
07a5bd9db5 Add LVM2/iSCSI documentation
This patch adds to cinder-guide.rst LVM2/iSCSI related
information.

TrivialFix

Change-Id: I2c7b3090bbf314dd1281ca3d02148490936d5b86
2016-04-08 20:11:43 -04:00
MD NADEEM
976a385075 Update vagrant-dev-env.rst
Fix some minor changes
ruby-dev package required for installing
vagrant-libvirt plugin.

TrivialFix

Change-Id: Id6d3552275ee28ab49804fe6cd1b00d2e8e3c1f4
2016-04-08 10:46:21 +05:30
Rajath Agasthya
0e6fcdb591 Added Kibana instructions to quickstart.rst
Kibana requires creating an index for the first time when you log
in since we don't have a default dashboard yet. Documenting that
step in quickstart.rst.

Change-Id: I82ecd228c61e2affa5c8f9f9c93f8845728f707f
2016-04-06 22:12:32 -07:00
Ryan Hallisey
bf6cae2c24 Add remove apparmor reminder to the quickstart
Change-Id: I1333bf4352aa559f3f9ee5c78ff85533e27c7716
2016-04-05 02:06:54 -04:00
Davanum Srinivas
f0be9c736c Update Quickstart with example for distro and install type
Make it a bit more clear on how to switch distro if needed

TrivialFix

Change-Id: I888c8310d11c8bc65f579df2cdc9d32f3928dc23
2016-03-31 14:42:18 +00:00
Gerard Braad
674ff439fd Change CentOS in documentation
Change-Id: Ic4725a4cef02a57e837c727378a99bf7575d4ebd
2016-03-24 06:59:24 +00:00
Gerard Braad — 吉拉德
4d58ef5d43 Include docker python install
Change-Id: I5a55f6798d73b289b02232dd26f5e5fb72da9e4c
2016-03-24 04:07:10 +00:00
Jenkins
a3a43e7b92 Merge "Add PBR generation of version information" 2016-03-23 12:33:03 +00:00
Jenkins
ada9ac95a0 Merge "Added note about nested environment" 2016-03-23 07:13:15 +00:00
Steven Dake
31634c4df4 Add PBR generation of version information
Change-Id: I6391392645d8608a92c885071b26210eed3f5466
Partially-Implements: blueprint add-reno
2016-03-22 20:45:46 -07:00
Carlos Cesario
8e2423a388 Added note about nested environment
Added information when using nested environment for Kolla deployment.

Added check command to verify hardware acceleration

Change-Id: I6cb43ebbf11b5cf34f866fdccb550e9641a47f6c
2016-03-22 10:20:01 -03:00
SamYaple
f03e06e09b Add generate_passwords.py to generate passwords
As with all tools, this is a first pass at the generation. Perhaps we
even want to move this into kolla/kolla/cmd and be generated with tox
itself in the future.

This tool, when run, will only populate empty fields that have no
values meaning that it is safe to run repeatedly on the same file.

Of note, there is no way to preserve comments in the file after it has
been processed by the yaml parser in python. Comments and sections
will remain in the passwords.yml template for additional documentation
if the user wishes to populate the file themselves.

Use SystemRandom and clean up the docs a bit to not use pronouns.

Co-Authored-By: Steven Dake <stdake@cisco.com>

Closes-Bug: #1559266
Change-Id: I2932d592df8871f1b7811059206d0b4d0553a687
2016-03-21 17:02:23 +00:00
Jenkins
37e67ef3ed Merge "Update quickstart doc to use drop-in unit files" 2016-03-21 00:24:37 +00:00
Maru Newby
b9205399c5 Update quickstart doc to use drop-in unit files
While it's possible to edit distro/package unit files installed to
/lib/systemd/system, a cleaner solution exists.  systemd will pick up
'drop-in' unit files located in '/etc/systemd/system/[unit name].d/'.
A drop-in unit file only has to include fields that override those in
the main unit file, and the drop-in unit and main unit file can change
independently.

This change updates the quickstart doc to use drop-in unit files to
configure docker.service instead of editing the main unit file.

See: https://coreos.com/os/docs/latest/using-systemd-drop-in-units.html

Change-Id: Iddbebf658741937e3c4157fc0a021751f10fabd2
2016-03-19 05:10:35 +00:00
Steven Dake
50c52081de Explain how to use kolla-ansible pull
During multi-node, it is possible for master target node images to
be older then the Ansible master playboks if the repository is
updated.  Add documentation to explain this situation.

Change-Id: I2ccf57004147873e89f23fbb996d01f550e90c3f
2016-03-18 11:57:27 -07:00
Thiago Gomes
d5c79a2487 Add Manila deployment document
Deploy Manila in kolla

Co-Authored-By: Mauricio Lima <mauriciolimab@gmail.com>
Change-Id: I1397e0f10dcbcfd182497fbaf0ebe9d5de718cc5
2016-03-16 09:11:42 -04:00
Jenkins
8407c8a95a Merge "Stop shipping broken openrc in vagrant" 2016-03-13 23:06:33 +00:00
Steven Dake
812b27867e RST syntax error in quickstart.rst
Change-Id: I3c5b6f73b19968c9ae26b12e64864c72a5e2b7f2
2016-03-12 22:14:51 +00:00
Swapnil Kulkarni (coolsvap)
333ee4e742 Restructuring the Quickstart guide
We need the gcc and other dependencies
installed before we can do any tox related
commands.

Installation of git was never checked in QSG.
I happened to create a baremetal CentOS server
with minimal install and there was no git.
Added steps to install git.

Moved the steps related to git clone and other
kolla configuration after basic installation.
since tox fails for gcc.

In the quickstart guide we are generating
the configuration using tox but tox is not
installed before doing so. Adding steps to
install tox before generating conf.

Change-Id: Ic8a756e66d33963e47607ed60c4c768e0859152d
2016-03-11 22:20:58 +05:30
Martin André
29b4e8756d Stop shipping broken openrc in vagrant
Instead, rely on kolla-ansible post-deploy to generate a configuration
file with valid environment variables.

Change-Id: Ie62932afc96e2486410a1d4e14162a88b1733c22
Closes-Bug: #1555972
2016-03-11 17:14:03 +09:00
Jenkins
2469425a8a Merge "Document required libvirt python bindings" 2016-03-10 11:50:25 +00:00
Jenkins
4cb6d83fea Merge "Document the new 'local' type for source build" 2016-03-10 11:49:37 +00:00
Martin André
ce408a26f7 Document required libvirt python bindings
We added a requirement on libvirt python bindings with the script to
retrieve the latest DHCP lease for vagrant developers' environment.

Add it to the vagrant documentation.

Change-Id: I3e7e97922f5b855155fda96b914a4947af007c47
2016-03-10 16:58:24 +09:00
Martin André
3105580d39 Provide instruction to generate kolla-build.conf
Although not strictly mandatory, it's less confusing to have
a kolla-build.conf file in /etc/kolla that users can modify it they
want to customize their builds, rather than to rely on defaults
settings and command line options.

The `tox -e genconfig` was already documented in "Image building" doc.

Change-Id: Ia44e6f28ce18601cdaba5109ea12cd50fa8372b2
Closes-Bug: #1532066
2016-03-10 15:25:56 +09:00
Martin André
18f1971144 Document the new 'local' type for source build
Change-Id: Ia385364e3fd8fc3441ebd07adcd981154f34ebb8
2016-03-10 15:19:16 +09:00
Jenkins
395bb2e3aa Merge "Fix a few small typos and formatting." 2016-03-09 21:14:49 +00:00
Katie McEwen
8af51c7af6 Fix a few small typos and formatting.
Fix a few small typos and formatting.

Change-Id: I5bf1f1aba518aa4df605b9e9133953f9fa256c4c
2016-03-09 12:33:08 -08:00
Steven Dake
13a6062260 Add documentation about critical data loss
There is a critical data loss in Liberty 1.0.0.  It is only fair we
warn Operators not to use 1.0.0 and then revert this change once
1.1.0 is released.

Change-Id: I65a18ddbbdbf2fc5f62f62ff7a1650049b61fada
2016-03-08 22:05:22 -07:00
Jenkins
1015993808 Merge "Document how to use loopback devices for Swift" 2016-03-08 18:33:32 +00:00
Jenkins
0af1df1eb7 Merge "Add documentation for two-VIP and TLS blueprints" 2016-03-08 16:48:14 +00:00
Paul Bourke
9588fd1d99 Document how to use loopback devices for Swift
People commonly want to use loopback devices to evaulate or develop on
Swift.  The steps for this are slightly different than those for
physical block devices.

Also make some small fix ups to the title formatting.

Change-Id: I0c1cb4a261f264dc56bd065ab137e5ee79e773f8
2016-03-08 16:37:36 +00:00
Dave McCowan
6d9cf739ca Add documentation for two-VIP and TLS blueprints
Relates-to: blueprint kolla-ssl

Change-Id: Id82d22c2195be5d897c781f28087a1ea422b8bea
2016-03-08 09:27:26 -05:00
Rodolfo Alonso
c0d7abc532 Add documentation for proxy buildargs picked from the environment.
Add documentation for the commit I084e5d1cc8f9993d65167878f9983ad58a68e86e.
Explain how 'build.py' picks up automatically env proxy variables.

Change-Id: Ia8513babd4ff72ed52e167b361d6b54393598a78
Closes-Bug: #1538108
2016-03-07 11:25:51 +00:00
Jenkins
67d3557f1e Merge "Fixing ambiguity in the documetation" 2016-03-03 18:02:00 +00:00
Paul Bourke
8b3d3ef84e Add documentation for Kolla plugin functionality
Every now and then people ask about plugins for Kolla. This conversation
may need to be revisted in more detail soon, but till then it's worth
highlighting what we do currently support in Kolla.

Right now adding the block as shown in this patch will make the plugin
archive available in the image, but currently only Neutron has
Dockerfile directives to automatically install them if present. The same
can be added very easily for other commonly pluggable services such as
Horizon.

Change-Id: Ia52d5ccf753667c5452b19fcaf4bf5b893a59fd0
2016-03-03 10:24:29 +00:00
Nikolai Korablin
b58fd41ad6 Fixing ambiguity in the documetation
After change change 284856, there were some comments
about ambiguity in docs.

Change-Id: I90129c475b87bf63f2e5c870dba7bd07893c8c9c
2016-03-02 21:37:35 -08:00
Allen Gao
235e95885b Move ironic-discoverd to ironic-inspector
Closes-Bug: #1551052
Change-Id: Ic226287bbf1f1e8d5cc2e1d80ce2975448b1f95c
2016-02-29 11:47:52 +08:00
Jenkins
ac12632ead Merge "Recommend vagrant and heat for development only" 2016-02-28 19:10:30 +00:00
Jenkins
c81097df8b Merge "Change kolla_internal_address variable" 2016-02-27 17:50:52 +00:00
Rajath Agasthya
58ef5fee02 Recommend vagrant and heat for development only
Vagrant and Heat, while really cool tech, are not very well maintained
in Kolla. They are not always up to date, and as a result, are not
recommended for evaluation purposes by this change.

TrivialFix

Change-Id: Ic8b8519431ed5c50a9a46b2e8b8f822d0982b1cf
2016-02-26 23:36:21 -08:00
SamYaple
d3cfb2052a Change kolla_internal_address variable
Due to poor planning on our variable names we have a situation where
we have "internal_address" which must be a VIP, but "external_address"
which should be a DNS name. Now with two vips "external_vip_address"
is a new variable.

This corrects that issue by deprecating kolla_internal_address and
replacing it with 4 nicely named variables.

kolla_internal_vip_address
kolla_internal_fqdn
kolla_external_vip_address
kolla_external_fqdn

The default behaviour will remain the same, and the way the variable
inheritance is setup the kolla_internal_address variable can still be
set in globals.yml and propogate out to these 4 new variables like it
normally would, but all reference to kolla_internal_address has been
completely removed.

Change-Id: I4556dcdbf4d91a8d2751981ef9c64bad44a719e5
Partially-Implements: blueprint ssl-kolla
2016-02-26 20:00:09 +00:00
Michael A. Trimm
f9b603872b Fixed slight gramatical issues that could be considered confusing
Signed-off-by: Michael Trimm <mitrimm@cisco.com>
Change-Id: Iccd3c53526caf8b109ba4ede117eebf66958782d
2016-02-26 12:56:53 -05:00
Jenkins
b3d2917f6b Merge "Fixed grammatical error in ceph-guide.rst" 2016-02-26 02:20:21 +00:00
Richa Yadav
dce6fb1bab Fixed grammatical error in ceph-guide.rst
Made changes in section Managing Ceph to correct the grammatical mistake.

Signed-off-by: Richa Yadav <ricyadav@cisco.com>

Change-Id: I2ed13f766dd39a7ac816af86664986b8d2700d80
2016-02-25 14:54:27 -08:00
Jenkins
604e1d5e8a Merge "General improvements to quickstart" 2016-02-25 21:52:53 +00:00
Jenkins
3616381db2 Merge "Fixed a typo in quickstart.rst" 2016-02-25 15:21:22 +00:00