Openstack-Base charm bundle documentation missing information

Bug #1671929 reported by Oscar Hernandez
4
This bug affects 1 person
Affects Status Importance Assigned to Milestone
OpenStack Charm Guide
Fix Released
Medium
Peter Matulis

Bug Description

Hello,

I've asked this question over at askubuntu.com but no reply yet, so I thought I'd give it a shot here maybe the documentation is missing this info, or the solution is not readily obvious to first time users:

http://askubuntu.com/questions/891168/what-are-the-steps-to-take-after-a-successful-openstack-install-using-juju-opens

Here is the report:

The setup guide says the following:

 https://jujucharms.com/openstack-base/
-=-=-=-=-
Accessing the cloud

Check that you can access your cloud from the command line:

source novarc
keystone catalog
You should get a full listing of all services registered in the cloud which should include identity, compute, image and network.

Ensuring it's working To ensure your cloud is functioning correctly, download this bundle and then run through the following sections.

All commands are executed from within the expanded bundle. <<--
-=-=-=-
what does this mean? which machine are we supposed to get the novarc file from?

=-=-=-
Configuring an image

In order to run instances on your cloud, you'll need to upload an image to boot instances from:

Configure networking

For the purposes of a quick test, we'll setup an 'external' network and shared router ('provider-router') which will be used by all tenants for public access to instances:
> ./neutron-ext-net -g <gateway-ip> -c <network-cidr> \
> -f <pool-start>:<pool-end> ext_net
-=-=-=-

Which unit are we running this from?

I have a feeling that the "source novarc" was crucial to this, but where to get the source novarc?

I tried running these commands form the neutron instance as well as the controller instance, and I get the following errors:

root@juju-9d518a-1-lxd-1:~# ./neutron-ext-net -g 10.230.168.1 -c 10.230.168.0/21 \
> -f 10.230.168.10:10.230.175.254 ext_net
bash: ./neutron-ext-net: No such file or directory
root@juju-9d518a-1-lxd-1:~#
Where are these bash files? Where is the novarc file?

Would be helpful if the documentation specified this.

I did manage to connect via CLI to my openstack cloud but using my own rc file as source, which I got from the openstack horizon dashboard. There was no novarc file anywhere, nor the other bash scripts mentioned in the documentation.

Here is my juju status:
http://pastebin.ubuntu.com/24153692/

All services say active, so my guess is the bundle was deployed successfully. Or am I missing anything?

Thanks for reading, hope you can help!

Revision history for this message
James Page (james-page) wrote :

I posted a response on your askubuntu question - we'll also look to make that a bit clearer in the README as well.

Thanks for the feedback!

Changed in charm-guide:
status: New → Triaged
importance: Undecided → Medium
milestone: none → 17.05
Revision history for this message
Oscar Hernandez (cmsnexus) wrote :

Hi James,

I see exactly where the disconnect happened.

I'm completely new to JuJu and Openstack. The reason for me to try JuJu Bundles to deploy openstack was the ability to get up and running to see it in action quickly.

As a new user, when you go through the JuJu starter guide, and subsequently the MaaS+JuJu guides, you end up at the JuJu GUI.

From the GUI there is a very convenient link to the Openstack Bundle. From the bundle you can literally click once and the bundle gets populated right into your setup (without the need of the zip file). As a new user, you don't really know that you're supposed to download the files and actually go through the configs beforehand.

Now that you have pointed this out I will go ahead and re install the bundle via CLI and not through the GUI, so that I can have the same working environment at the end as the one described in the documentation.

Thanks for pointing me in the right direction. Once I get things working the way it was meant to, I will also create a guide for people who are totally new like me, and I will post it in my askubuntu question.

Revision history for this message
Oscar Hernandez (cmsnexus) wrote :
Download full text (4.1 KiB)

Hello,

I was able to get the novarc file to source and it is also connecting properly, with some deprecating warnings:

ubuntu@JuJu-Controller:~$ keystone catalog
/usr/lib/python2.7/dist-packages/keystoneclient/shell.py:64: DeprecationWarning: The keystone CLI is deprecated in favor of python-openstackclient. For a Python library, continue using python-keystoneclient.
  'python-keystoneclient.', DeprecationWarning)
/usr/lib/python2.7/dist-packages/keystoneclient/v2_0/client.py:145: DeprecationWarning: Constructing an instance of the keystoneclient.v2_0.client.Client class without a session is deprecated as of the 1.7.0 release and may be removed in the 2.0.0 release.
  'the 2.0.0 release.', DeprecationWarning)
/usr/lib/python2.7/dist-packages/keystoneclient/v2_0/client.py:147: DeprecationWarning: Using the 'tenant_name' argument is deprecated in version '1.7.0' and will be removed in version '2.0.0', please use the 'project_name' argument instead
  super(Client, self).__init__(**kwargs)
/usr/lib/python2.7/dist-packages/debtcollector/renames.py:45: DeprecationWarning: Using the 'tenant_id' argument is deprecated in version '1.7.0' and will be removed in version '2.0.0', please use the 'project_id' argument instead
  return f(*args, **kwargs)
/usr/lib/python2.7/dist-packages/keystoneclient/httpclient.py:371: DeprecationWarning: Constructing an HTTPClient instance without using a session is deprecated as of the 1.7.0 release and may be removed in the 2.0.0 release.
  'the 2.0.0 release.', DeprecationWarning)
/usr/lib/python2.7/dist-packages/keystoneclient/session.py:140: DeprecationWarning: keystoneclient.session.Session is deprecated as of the 2.1.0 release in favor of keystoneauth1.session.Session. It will be removed in future releases.
  DeprecationWarning)
/usr/lib/python2.7/dist-packages/keystoneclient/auth/identity/base.py:56: DeprecationWarning: keystoneclient auth plugins are deprecated as of the 2.1.0 release in favor of keystoneauth1 plugins. They will be removed in future releases.
  'in future releases.', DeprecationWarning)
Service: compute
+-------------+-----------------------------------------------------------------+
| Property | Value |
+-------------+-----------------------------------------------------------------+

I was able to get glance to accept and create my image, everything is good so far in the guide, until I hit the following issue when creating the external and internal network:

ubuntu@JuJu-Controller:~$ sh ./neutron-ext-net -g xx.xx.xx.193 -c /27 -f xx.xx.xx.194:xx.xx.xx.222 ext_net
./neutron-ext-net: 3: ./neutron-ext-net: try:: not found
from: can't read /var/mail/quantumclient.v2_0
./neutron-ext-net: 5: ./neutron-ext-net: except: not found
from: can't read /var/mail/neutronclient.v2_0
from: can't read /var/mail/keystoneclient.v2_0
./neutron-ext-net: 9: ./neutron-ext-net: import: not found
./neutron-ext-net: 10: ./neutron-ext-net: import: not found
./neutron-ext-net: 11: ./neutron-ext-net: import: not found
./neutron-ext-net: 12: ./neutron-ext-net: import: not found
./neutron-ext-net: 15: ./neutron-ext-net: usage: not found
./neutron-ext-net: 24: ./...

Read more...

James Page (james-page)
Changed in charm-guide:
milestone: 17.05 → 17.08
James Page (james-page)
Changed in charm-guide:
milestone: 17.08 → 17.11
James Page (james-page)
Changed in charm-guide:
milestone: 17.11 → 18.02
Revision history for this message
dann frazier (dannf) wrote :
Changed in charm-guide:
assignee: nobody → dann frazier (dannf)
status: Triaged → In Progress
Revision history for this message
dann frazier (dannf) wrote :

Sorry, ignore comment #4, wrong bug.

Changed in charm-guide:
assignee: dann frazier (dannf) → nobody
status: In Progress → New
Ryan Beisner (1chb1n)
Changed in charm-guide:
milestone: 18.02 → 18.05
Revision history for this message
Alex Kavanagh (ajkavanagh) wrote :

This looks pretty much complete. i.e. reading the docs at https://jujucharms.com/openstack-base/ seems to show all the steps. The only thing that might be missing is that there is no "explicit" mention to download the zip file to get the novarc_auto.

Changed in charm-guide:
status: New → Triaged
David Ames (thedac)
Changed in charm-guide:
milestone: 18.05 → 18.08
James Page (james-page)
Changed in charm-guide:
milestone: 18.08 → 18.11
David Ames (thedac)
Changed in charm-guide:
milestone: 18.11 → 19.04
David Ames (thedac)
Changed in charm-guide:
milestone: 19.04 → 19.07
David Ames (thedac)
Changed in charm-guide:
milestone: 19.07 → 19.10
David Ames (thedac)
Changed in charm-guide:
milestone: 19.10 → 20.01
Changed in charm-guide:
assignee: nobody → Peter Matulis (petermatulis)
status: Triaged → In Progress
Revision history for this message
Peter Matulis (petermatulis) wrote :
Changed in charm-guide:
status: In Progress → Fix Released
To post a comment you must log in.
This report contains Public information  
Everyone can see this information.

Other bug subscribers

Remote bug watches

Bug watches keep track of this bug in other bug trackers.