[docs] devops guide bugs

Bug #1337847 reported by Jesse Pretorius
16
This bug affects 2 people
Affects Status Importance Assigned to Milestone
Fuel for OpenStack
Fix Released
Medium
Matthew Mosesohn

Bug Description

In the devops docs, there are two sections which show the packages to install on your devops host. One shows the 'dependencies' and has a duplication of the package 'python-xmlbuilder' and the other doesn't have the duplication.

In my view the dependencies should be showed as a list of packages - perhaps separated between apt and pypi, or that section should just be removed as it is redundant anyway.

The package installation section [1] includes the package 'python-xmlbuilder', as per [2]. This needs to be installed via pypi instead.

ie add python-pip to the list of packages to install, then include 'pip install xmlbuilder' after the apt installation.

Also, 'python ./setup.py install' should be 'sudo python ./setup.py install' in order to work as non-root, which all the other commands presume.

Missing packages for [3] to work:
 - postgresql-server-dev-all
 - python-dev
 - libffi-dev

When not using a venv for [3], the installation of requirements must be done with sudo.

The running of systems tests appears to assume that there's a jenkins user and that a virtualenv is in place for it. This exposes either some missing documentation or a required revision in the test running code.

[1] http://docs.mirantis.com/fuel-dev/devops.html#devops-installation-from-packages
[2] http://packages.ubuntu.com/search?suite=all&section=all&arch=any&keywords=python-xmlbuilder&searchon=names
[3] http://docs.mirantis.com/fuel-dev/devops.html#environment-creation-via-devops-fuel-main

Tags: fuel-devops
description: updated
description: updated
summary: - [dev-docs] python-xmlbuilder ubuntu package does not exist
+ [dev-docs] devops guide bugs
description: updated
description: updated
description: updated
Changed in fuel:
importance: Undecided → Medium
assignee: nobody → Fuel DevOps (fuel-devops)
milestone: none → 5.1
description: updated
Dmitry Ilyin (idv1985)
summary: - [dev-docs] devops guide bugs
+ [docs] devops guide bugs
Changed in fuel:
assignee: Fuel DevOps (fuel-devops) → Matthew Mosesohn (raytrac3r)
Revision history for this message
Matthew Mosesohn (raytrac3r) wrote :

Moving to 6.0 release, but should still be committed before 5.1 is released.

Changed in fuel:
status: New → Confirmed
milestone: 5.1 → 6.0
Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Related fix proposed to fuel-web (master)

Related fix proposed to branch: master
Review: https://review.openstack.org/114628

tags: added: fuel-devops
Revision history for this message
Andrew Woodward (xarses) wrote :

virtualenv docs are only missing

apt:
  libffi-dev
  postgresql

Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Related fix merged to fuel-web (master)

Reviewed: https://review.openstack.org/114628
Committed: https://git.openstack.org/cgit/stackforge/fuel-web/commit/?id=961aed3b11a653a3822de930cba2d547e622d1f8
Submitter: Jenkins
Branch: master

commit 961aed3b11a653a3822de930cba2d547e622d1f8
Author: Sergey Kulanov <email address hidden>
Date: Fri Aug 15 21:08:10 2014 +0300

    Fix devops installation guide

    Devops installation instructions were updated
    and checked across Ubuntu 12.04/14.04 LTS distro.
    Document structer was updated, introducing
    new logical parts: Introduction, Installation,
    Configuration and Usage.

    Change-Id: I4b4af3ceb13c5d3b1593c40c8349b953e8a8bfa2
    Related-Bug: #1337847

Changed in fuel:
status: Confirmed → Fix Committed
Changed in fuel:
status: Fix Committed → 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.