51 Commits

Author SHA1 Message Date
Zuul
d6861961fb Merge "Update upgrade information in operating-kolla.rst" 2018-04-19 15:14:10 +00:00
Eduardo Gonzalez
a2125fd326 Fix version name in quickstart guide
Doc says use pike for latest stable branch.
Currently we are in queens

Change-Id: I3983682475b4abf141784c25e117b24cfd38cf29
2018-04-19 08:28:47 +02:00
James McCarthy
e6849f467f Update upgrade information in operating-kolla.rst
Added more information here to help when doing upgrades.

Change-Id: I9ed4cb172726277f477750a1b34dd0b9f11cf64f
2018-04-18 14:28:49 +01:00
Zuul
524a522449 Merge "Correct the path of configure file" 2018-04-11 14:49:19 +00:00
caoyuan
5c133c6005 Correct the path of configure file
the path should be "/etc/kolla/globals.yml" rather than
"/etc/kolla/kolla/globals.yml"

Change-Id: I119095bb63fc2af7eb34f16de43ce82f864dd8a4
2018-04-10 23:05:56 +08:00
caoyuan
b9bc5a4132 Add the inventory when use ansible command
when run ansible command, the inventory should be added, or
ansible will use /etc/ansible/hosts by default, but it does't
we wanted.

Change-Id: I7f2a05c27ddfa95d0747abb9ba931ee1c5714dc0
2018-04-10 23:02:17 +08:00
Zuul
3ca4de03b6 Merge "Update doc with new option" 2018-04-10 14:15:40 +00:00
chenxing
e57b4e8c1e Quickstart rewrite
- Add the requirements installation step for development
- Add step number for some section, to make step more clear
- Some format issues fix

Change-Id: I78deee5f4ae424eec06876168cbdfdf8d25d6bcc
2018-04-10 15:48:20 +08:00
confi-surya
79374fbfba Update doc with new option
`auth_uri` option is deprecated and changed to new option
`www_authenticate_uri` from group keystone_authtoken

please follow below link for reference
https://review.openstack.org/#/c/508522/

Change-Id: I8daa645ff1afab9ca643de2c3beb4d757007b514
2018-04-09 11:46:24 +00:00
Zuul
d753da058d Merge "fix word in the documentation" 2018-03-25 11:16:16 +00:00
Zuul
2381fa89f6 Merge "Support virtualenv installation in baremetal role" 2018-03-24 15:00:01 +00:00
huang.zhiping
33a3dfa7b0 fix word in the documentation
Change-Id: Ib47345d54c9cf1077a24b50a358d5e41c0bf696a
2018-03-23 10:00:38 +08:00
Duong Ha-Quang
04fa7c039c Add documentation for Ansible become feature
Change-Id: I657ff1427908610a8aa2397b4ce1115be0ac8ace
Partial-Implements: blueprint ansible-specific-task-become
2018-03-21 15:24:38 +00:00
chenxing
3a77dba899 Upgrade the rst convention of the User Guide
We upgrade the rst convention by following Documentation Contributor
Guide[1].

[1] https://docs.openstack.org/doc-contrib-guide

Change-Id: Ieceb3942073512fb10670a48d258c4055909496e
Partially-Implements: blueprint optimize-the-documentation-format
2018-03-19 17:13:25 +08:00
yufei
2c13a5f258 s/openstack_version/openstack_release/g
replace openstack_version with openstack_release

Change-Id: Ib7cb3ae220971bbfdaf5e1e382333f6c62fd130a
2018-03-19 11:37:19 +08:00
zhubingbing
077c85b13f Replace kolla title with kolla-ansible
This is mainly kolla-ansible installation part

Change-Id: Iab14884cfc037bc3cb8055db487c53aa14da070f
2018-02-24 10:09:40 +00:00
Alexandru Bogdan Pica
9822bb535e Fix MySQL access denied error during upgrade
This change makes it so that if preconfigured database users are used,
the attempt to change the log_bin_trust_function_creators mysql
variable isn't made anymore.

Also updated the upgrade docs

Change-Id: I356313952d435de6d3b5444c0dd8a71f45aee452
Closes-Bug: 1748269
2018-02-09 14:18:05 +02:00
gaofei
b51294dc3d Replace Chinese punctuation with English punctuation
Change-Id: Icc4a984e8defe4d068e7f4a78cd5483a0cb9c7b7
2018-01-23 16:31:43 +08:00
gaofei
3b828fc923 Fix broken link
Merge commit from[1][2]
[1]https://review.openstack.org/#/c/536657/
[2]https://review.openstack.org/#/c/536657/
Change-Id: I79bd4ca2457222abcc6a58cd3b44be21a11b5a87
2018-01-23 06:03:46 +00:00
caoyuan
b25e8c486b Fix tox -e docs failed
doc/source/user/quickstart.rst:194: D001 Line too long
doc/source/user/quickstart.rst:337: D001 Line too long
doc/source/user/quickstart.rst:339: D001 Line too long

Change-Id: Ibbb3588bddf3bfe9d49c2b2b6909f80c36ec2aff
2018-01-21 21:52:30 +08:00
Mark Goddard
69979efc2e Support virtualenv installation in baremetal role
Installing python packages directly to the system site-packages can
cause various problems, in particular when pip overwrites a system
package. Python virtualenvs are one solution to this issue, as they
allow python packages to be installed in an isolated environment.

This change adds support to the baremetal role for installing python
dependencies in a virtualenv. Typically we will need to enable use of
system site-packages from within this virtualenv, to support the use of
modules such as yum, apt, and selinux, which are not available on PyPI.

The path to the virtualenv is configured via the 'virtualenv' variable,
and access to site-packages is controlled via
'virtualenv_site_packages'.

When executing other kolla-ansible commands, the variable
'ansible_python_interpreter' should be set to the python interpreter
installed in 'virtualenv'. Note that this variable cannot be templated.

Change-Id: I0741923065246f9c5b168059fcd66504f2753c41
Related-Bug: #1731026
2018-01-21 08:59:49 +00:00
Zuul
c2d2cdf715 Merge "Quickstart rewrite" 2018-01-19 05:12:19 +00:00
Michal (inc0) Jastrzebski
742960aa59 Quickstart rewrite
Nearly full rewrite of our QSG to make it more 2017.

Co-Authored-By: chenxing <chason.chan@foxmail.com>
Partially-Implements: blueprint ka-queens-doc-restructure
Change-Id: Ie558e1121438a502611c7c0e6c0e5ac0f6574827
2018-01-17 15:54:33 +08:00
Zuul
ec53151747 Merge "Add note about checking if all the hostnames are resolvable" 2017-12-13 18:01:33 +00:00
chenxing
ceb8d1c2ac Add note about checking if all the hostnames are resolvable
Change-Id: I6c353a02a86cd76b2a2e7bd67801a95dd2b04d4f
Closes-Bug: #1559809
2017-12-01 15:51:00 +08:00
liujunpeng
445954db33 add domain_name for multi-regions
add domain_name for multi-regions. When deploying regiontwo,
nova_compute simple_cell_setup will use domain_name.

Change-Id: I2f4171e1469966140ccccb38540fa5c54258bdfb
2017-12-01 03:13:34 +00:00
Zuul
e57944b6fe Merge "Don't change directory while running init-runonce" 2017-11-27 07:52:55 +00:00
Zuul
bb032de239 Merge "Remove deprecated version dependencies in quickstart" 2017-11-27 04:53:28 +00:00
Ravi Shekhar Jethani
9c66123c30 Don't change directory while running init-runonce
Currently init-runonce script changes directory to the
script's base directory (/usr/...) before doing anything else.
This unnecessarily _forces_ a non-root user to use sudo for
running this script thereby raising privileges for code which
doesn't want it. Also downloading temporary stuff in places like
/usr... seems not a good choice.

Hence deleting the said code part and letting the deployer work
comfortably from any directory.

Made documentation changes accordingly.

Change-Id: Ib3c7ed97aa5f53c115b6337aaf572b5fdc7a71f3
Closes-Bug: #1732963
2017-11-23 16:35:45 +05:30
Zuul
99c3e2172a Merge "Associate text to link" 2017-11-22 16:35:32 +00:00
chenxing
9ff89025c9 Add the full name of PBR in its first usage
This warning message mentions PBR, but this is the first
instance of this acronym in the documentation. Use the full
name can be made clear what PBR stands for in its first usage.

Change-Id: I46c7db79eb330e7f58d71afd6c749dd27e2c0f80
Closes-Bug: 1729476
2017-11-02 17:28:07 +08:00
Eduardo Gonzalez
e0572969f8 Remove deprecated version dependencies in quickstart
Mitaka and newton are deprecated and no longer maintained
by OpenStack comunity.

Users can check specific documentation for old releases.

Change-Id: I43fd1d40bc2f094fee4c1547879f798a92593df4
2017-10-27 07:38:37 +02:00
chen
d3ba310a52 Associate text to link
The text "Docker Hub Image Registry" is supposed to be assciated with
the link defined at the end of quickstart.rst. This patch ensures that.

Change-Id: I840413520473b1cc3eb7685254d8d133d4c8d497
2017-10-18 17:27:15 +08:00
Surya Prakash Singh
5d162af419 Fixed the Build Container Images link in Quick Start
Change-Id: I2a6ee471b1029bcc2fe1ce76917faf925f1ad239
Closes-Bug: #1723886
2017-10-16 15:36:44 +05:30
Surya Prakash Singh
b36b2463df Quickstart guide updated for better users experience
for reference: https://docs.openstack.org/python-openstackclient/latest/index.html#getting-started

Change-Id: Iacb29585ad89c08de24ea49dfefe7d0d0f5a1815
2017-10-12 09:56:27 +05:30
Jenkins
4c1bdc0f5b Merge "Restructured the doc of kolla-ansible" 2017-10-10 09:11:00 +00:00
Jenkins
a03b29829f Merge "Add notes on docker version in quickstart and multinode guide" 2017-10-06 04:36:36 +00:00
Surya Prakash Singh
04fd12b945 Restructured the doc of kolla-ansible
Created the admin directory, remove some files from
user dir and placed into admin and contributor.

For more detail, see the doc migration spec.
http://specs.openstack.org/openstack/docs-specs/specs/pike/os-manuals-migration.html

Change-Id: I84c565d7d14a4d90270a53e14ab93a10f7ffb9b7
Partially-Implements: blueprint ka-queens-doc-restructure
2017-10-05 03:23:23 +00:00
chao liu
a5f242e4a2 Add notes on docker version in quickstart and multinode guide
In the quickstart guide, the min version of docker is 1.10.0,
and the max version is none. But the `docker daemon` doesn't work
since v1.13.0. Please refer to:
https://docs.docker.com/engine/deprecated/#docker-daemon-subcommand
"docker daemon subcommand
Deprecated In Release: v1.13.0
Target For Removal In Release: v17.12
The daemon is moved to a separate binary (dockerd), and should
be used instead."
I think it's better to let the readers know it.

Change-Id: I92882a3860704acdc31ff0c89e21ab2793e0b268
2017-10-04 05:33:10 +00:00
Zuul
dfb71ebe54 Merge "Fix the incorrect content" 2017-10-03 03:31:51 +00:00
Zuul
ecbb55117a Merge "Add fluentd enable option" 2017-10-02 09:33:00 +00:00
chenxing
239946a0df Fix the incorrect content
Change-Id: I138000951d75894cc5eb01a8b364ed8293940c40
Closes-Bug: #1720095
2017-09-29 16:45:30 +08:00
Zuul
9cf89634c6 Merge "Update the "ocata" to "pike" for multinode.html" 2017-09-29 04:33:39 +00:00
caoyuan
618962c216 Update the "ocata" to "pike" for multinode.html
since the pike is release, the multinode.html should update

Change-Id: I5122477b9209cd483ae682032c1949fa5a5cc985
2017-09-28 11:52:32 +00:00
Tatsuma Matsuki
03354bc99e Add fluentd enable option
This change adds enable_fluentd option and enables some other log shippers
to be integrated. When enable_fluentd is "no", syslog server is also disabled.
Then, this change also adds syslog parameters to use a syslog server
prepared by users.

Change-Id: I7c83ef7fe30a6b9ab7385bcee953ad07e96b0a83
Implements: blueprint fluentd-enable-option
2017-09-28 04:36:36 +00:00
Jenkins
29614fd48d Merge "Fix deploy-guide links" 2017-09-28 01:40:47 +00:00
Surya Prakash Singh
9fad395dce Release tag updated in quickstart guide
Change-Id: I3ee35c6faf2b824d889c4ccadde4d6f8ba9c8cca
2017-09-27 15:02:25 +05:30
Eduardo Gonzalez
197a264a3b Fix deploy-guide links
Deploy guides includes quickstart guide.
Includes respect relative paths, but when
quickstart includes vagrant doc, deploy-guide
tries to locate the doc in its doctree (deploy-guide/source).

This causes error 404 and deploy-guide post-gates to fail

Change-Id: I05e49bbcef564ad4f3d80f0649ccf191d9f8b59d
2017-09-25 13:56:30 +02:00
Bertrand Lallau
a3dfdfc085 Simplify Openstack services configuration possibilities
Actually Openstack services configuration can be overriden using many
files:
- /etc/kolla/config/<< service name >>/<< config file >>
- /etc/kolla/config/<< service name >>/<<host>>/<< config file >>
- /etc/kolla/config/global.conf
- /etc/kolla/config/database.conf
- /etc/kolla/config/messaging.conf

Only per-service configuration is actually documented here:
https://github.com/openstack/kolla-ansible/blob/master/doc/advanced-configuration.rst#L164

Allowing to globally modify service configuration can be perform too,
but it can be done in 3 different manners, all not documented:
- /etc/kolla/config/global.conf
- /etc/kolla/config/database.conf
- /etc/kolla/config/messaging.conf

database.conf and messaging.conf seems redundant with global.conf.
In order to simplify codebase it seems logical to remove them.

Documentation has been added for overriding configuration globally and
release note has been added too.

Closes-Bug: #1682479
Change-Id: I5d922dfc0d938173bad34ac64e490b78db1b7e31
2017-09-13 17:47:36 +02:00
Andreas Jaeger
67cce63acd Fix quickstart links
Checking http://files.openstack.org/docs-404s/2017-09-08.txt the link
/kolla-ansible/latest/quickstart.html gives a 404 and is most wanted.

The link now is /kolla-ansible/latest/user/quickstart.html - let's
update in tree docs for this.

Fix other broken links as well - with using intra-links instead of
external links - this will make it easier to notice breakage when files
are moved.

Change-Id: I62655afd9f270fa83c07d86aa91346af6337ca32
2017-09-08 18:28:48 +02:00