Our quickstart guide is way too complex. We need to simplify
the quickstart guide by pulling out the overwhelming amount of
information and splitting it into other docs.
Change-Id: Iec175ee7f60bfd11ce06b22c861e51e180c188a9
Partially-implements: blueprint documentation-rework
We don't have docs about major feature kolla offers.
TrivialFix
Co-Authored-By: Swapnil Kulkarni <me@coolsvap.net>
Change-Id: I7c992d2004348d520c019b295b0c5a4378c857ba
Includes basic information about how to search, visualize and analyse logs,
create a Dashboard and export/import created items.
Closes-Bug: #1570544
Change-Id: I70ce5d28a6bb719a94570d23e85d5ba4aa0b114e
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
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
Fix some minor changes
ruby-dev package required for installing
vagrant-libvirt plugin.
TrivialFix
Change-Id: Id6d3552275ee28ab49804fe6cd1b00d2e8e3c1f4
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
Added information when using nested environment for Kolla deployment.
Added check command to verify hardware acceleration
Change-Id: I6cb43ebbf11b5cf34f866fdccb550e9641a47f6c
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
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
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
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
Instead, rely on kolla-ansible post-deploy to generate a configuration
file with valid environment variables.
Change-Id: Ie62932afc96e2486410a1d4e14162a88b1733c22
Closes-Bug: #1555972
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
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
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
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