Path correction in Quick Start in kolla-ansible

[Raubvogel]

This bug tracker is for errors with the documentation, use the following as a template and remove or add fields as you see fit. Convert [ ] into [x] to check boxes:

- [X] This doc is inaccurate in this way: _I do not know if /usr/share/kolla-ansible is created when you run "pip install kolla-ansible" inside the virtualenv_

Here is the output

(devenv) [root@stakola ~]# ls /usr/share/
aclocal firstboot kde4 polkit-1
alsa games kdump redhat-release
anaconda gcc-4.8.2 libdrm selinux
applications gcc-4.8.5 licenses sounds
augeas gdb locale systemd
authconfig GeoIP lua systemtap
awk gettext magic tabset
backgrounds gettext-0.19.8 man terminfo
bash-completion ghostscript microcode_ctl themes
centos-logos glib-2.0 mime tuned
centos-release gnome mime-info wallpapers
cracklib gnome-background-properties misc X11
dbus-1 gnupg mysql xsessions
desktop-directories groff omf yum-cli
dict grub os-prober yum-plugins
doc hwdata p11-kit zoneinfo
empty i18n pixmaps zsh
et icons pkgconfig
file idl pki
firewalld info plymouth
(devenv) [root@stakola ~]#

Since we are running virtualenv, it should be somewhere in the directory I activated my viurtalenv in, which in my case is "devenv":

(devenv) [root@stakola ~]# ls devenv/share/kolla-ansible/etc_examples/kolla/
globals.yml passwords.yml
(devenv) [root@stakola ~]#

- [ ] This is a doc addition request.
- [ ] I have a fix to the document that I can paste below including example: input and output.

If you have a troubleshooting or support issue, use the following resources:

 - Ask OpenStack: http://ask.openstack.org
 - The mailing list: http://lists.openstack.org
 - IRC: 'openstack' channel on Freenode

-----------------------------------
Release: 8.1.0.dev59 on 2019-05-14 17:23:41
SHA: 22a6e0216e775fe241956c8395631dbdf1286891
Source: https://opendev.org/openstack/kolla-ansible/src/doc/source/user/quickstart.rst
URL: https://docs.openstack.org/kolla-ansible/latest/user/quickstart.html

[Mark Goddard (mgoddard)]

Hi, it would help if you could provide which part of the documentation you think is incorrect here. If installing in a virtualenv then pip will not touch /usr/share.

[Raubvogel (raubvogel)]

On Mon, May 20, 2019 at 7:00 AM Mark Goddard <email address hidden> wrote:
>
> Hi, it would help if you could provide which part of the documentation
> you think is incorrect here. If installing in a virtualenv then pip will
> not touch /usr/share.
>

Step 3 in https://docs.openstack.org/kolla-ansible/latest/user/quickstart.html#install-kolla-ansible-for-deployment-or-evaluation
implies that kolla-ansible was installed in /usr/share. Shouldn't it
be inside the virtualenv, which in my case is called devenv as seen
below?

(devenv) [root@stakola ~]# ls devenv/share/kolla-ansible/
ansible doc etc_examples init-runonce init-vpn setup.cfg tools
(devenv) [root@stakola ~]#
(devenv) [root@stakola ~]# ls devenv/share/kolla-ansible/etc_examples/kolla/
globals.yml passwords.yml
(devenv) [root@stakola ~]#

And as a result, Step 3 would look like

(devenv) [root@stakola ~]# cp -r
devenv/share/kolla-ansible/etc_examples/kolla/* /etc/kolla
(devenv) [root@stakola ~]#

instead?

> --
> You received this bug notification because you are subscribed to the bug
> report.
> https://bugs.launchpad.net/bugs/1829435
>
> Title:
> Path correction in Quick Start in kolla-ansible
>
> Status in kolla-ansible:
> New
>
> Bug description:
>
> This bug tracker is for errors with the documentation, use the
> following as a template and remove or add fields as you see fit.
> Convert [ ] into [x] to check boxes:
>
> - [X] This doc is inaccurate in this way: _I do not know if /usr/share
> /kolla-ansible is created when you run "pip install kolla-ansible"
> inside the virtualenv_
>
> Here is the output
>
> (devenv) [root@stakola ~]# ls /usr/share/
> aclocal firstboot kde4 polkit-1
> alsa games kdump redhat-release
> anaconda gcc-4.8.2 libdrm selinux
> applications gcc-4.8.5 licenses sounds
> augeas gdb locale systemd
> authconfig GeoIP lua systemtap
> awk gettext magic tabset
> backgrounds gettext-0.19.8 man terminfo
> bash-completion ghostscript microcode_ctl themes
> centos-logos glib-2.0 mime tuned
> centos-release gnome mime-info wallpapers
> cracklib gnome-background-properties misc X11
> dbus-1 gnupg mysql xsessions
> desktop-directories groff omf yum-cli
> dict grub os-prober yum-plugins
> doc hwdata p11-kit zoneinfo
> empty i18n pixmaps zsh
> et icons pkgconfig
> file idl pki
> firewalld info plymouth
> (devenv) [root@stakola ~]#
>
> ...

[OpenStack Infra (hudson-openstack)]

Fix proposed to branch: master
Review: https://review.opendev.org/660315

[Mark Goddard (mgoddard)]

Thanks for clarifying, I see your point. I proposed a fix here: https://review.opendev.org/660315.

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.opendev.org/660315
Committed: https://git.openstack.org/cgit/openstack/kolla-ansible/commit/?id=0b27baf3cee5cae3d6bbafe7d834276a05e39b7e
Submitter: Zuul
Branch: master

commit 0b27baf3cee5cae3d6bbafe7d834276a05e39b7e
Author: Mark Goddard <email address hidden>
Date: Tue May 21 10:29:24 2019 +0100

    Fix quickstart for virtual environments

    The etc_examples and inventory should be copied from the virtual
    environment rather than the system.

    Change-Id: I3ac1e057971b7481a0bce2a15351031e51bf97d6
    Closes-Bug: #1829435

[OpenStack Infra (hudson-openstack)]

Fix proposed to branch: stable/stein
Review: https://review.opendev.org/662732

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.opendev.org/662732
Committed: https://git.openstack.org/cgit/openstack/kolla-ansible/commit/?id=5973d9917f4aba4ecfd73a3fa8cc0e2cde8b8f41
Submitter: Zuul
Branch: stable/stein

commit 5973d9917f4aba4ecfd73a3fa8cc0e2cde8b8f41
Author: Mark Goddard <email address hidden>
Date: Tue May 21 10:29:24 2019 +0100

    Fix quickstart for virtual environments

    The etc_examples and inventory should be copied from the virtual
    environment rather than the system.

    Change-Id: I3ac1e057971b7481a0bce2a15351031e51bf97d6
    Closes-Bug: #1829435
    (cherry picked from commit 0b27baf3cee5cae3d6bbafe7d834276a05e39b7e)

[OpenStack Infra (hudson-openstack)]

This issue was fixed in the openstack/kolla-ansible 8.0.0.0rc2 release candidate.

[OpenStack Infra (hudson-openstack)]

This issue was fixed in the openstack/kolla-ansible 9.0.0.0rc1 release candidate.