OpenStack Object Storage (swift)

Install and configure the controller node for Red Hat Enterprise Linux and CentOS in Installation Guide for Object Storage Service

Bug #1637584 reported by drew mudgett
12
This bug affects 2 people
Affects Status Importance Assigned to Milestone
OpenStack Object Storage (swift)
Confirmed
Low
Unassigned

Bug Description

The Curl command in the docs is pointing to the mitaka proxy-server.conf:
# curl -o /etc/swift/proxy-server.conf https://git.openstack.org/cgit/openstack/swift/plain/etc/proxy-server.conf-sample?h=stable/mitaka

Should point to newton.

-----------------------------------
Release: 2.10.1.dev4 on 2016-10-20 21:55
SHA: 27c89131839b5a66193b4bec897aac80b5e6510b
Source: http://git.openstack.org/cgit/openstack/swift/tree/install-guide/source/controller-install-rdo.rst
URL: http://docs.openstack.org/project-install-guide/object-storage/newton/controller-install-rdo.html

Revision history for this message
Damian (ddamiandd) wrote :

Hello,

It seems as changed incorrectly to Ocata instead of Newton:

# curl -o /etc/swift/proxy-server.conf https://git.openstack.org/cgit/openstack/swift/plain/etc/proxy-server.conf-sample?h=stable/ocata

The last should be newton:
https://git.openstack.org/cgit/openstack/swift/plain/etc/proxy-server.conf-sample?h=stable/newton

Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Fix proposed to swift (stable/pike)

Fix proposed to branch: stable/pike
Review: https://review.openstack.org/502116

Revision history for this message
Tim Burke (1-tim-z) wrote :

Damian, on which page? As the bug points out, the newton install-guide (at https://docs.openstack.org/project-install-guide/object-storage/newton/controller-install-rdo.html as well as some other pages) currently includes links to mitaka sample configs.

Similarly, the ocata install guide has links to newton sample configs (as on https://docs.openstack.org/project-install-guide/object-storage/ocata/controller-install-rdo.html).

The Pike guide changed URL conventions (see https://docs.openstack.org/swift/pike/install/controller-install-rdo.html), but it *also* references the wrong release; in this case ocata.

The general problem is that the correct links *don't exist* until a release is cut, which means that a correct install guide can't be published simultaneously with the release. This has been exacerbated by us having the docs in-tree (https://github.com/openstack/swift/commit/cf8b939).

Changed in swift:
status: New → Confirmed
importance: Undecided → Low
tags: added: documentation
Revision history for this message
Damian (ddamiandd) wrote :

Thank you for explanation.

This means that installing Newton is correct to get proxy-server.conf-sample from one step earlier release?

The same for Ocata and Pike?

Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Fix merged to swift (stable/pike)

Reviewed: https://review.openstack.org/502116
Committed: https://git.openstack.org/cgit/openstack/swift/commit/?id=aecf9123f90c41e32e60857514764ee50bdbd1db
Submitter: Jenkins
Branch: stable/pike

commit aecf9123f90c41e32e60857514764ee50bdbd1db
Author: Tim Burke <email address hidden>
Date: Fri Sep 8 09:02:20 2017 -0700

    Update install guide to pull Pike sample confs

    ...now that stable/pike actually exists

    Partial-Bug: #1637584
    Change-Id: I08a91a3c32fe20714c518d9f0ac5ca4a52f3c6bb

tags: added: in-stable-pike
To post a comment you must log in.
This report contains Public information  
Everyone can see this information.
Subscribing...

Other bug subscribers

Remote bug watches

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