fuel-mirror usage is not documented

Bug #1563086 reported by Alex Schultz
24
This bug affects 5 people
Affects Status Importance Assigned to Milestone
Fuel for OpenStack
Fix Committed
High
Olena Logvinova
8.0.x
Confirmed
High
Olena Logvinova
Mitaka
Fix Committed
High
Olena Logvinova

Bug Description

Detailed bug description:
fuel-mirror is the new way to create a local mirror as of 8.0 but there is no documentation around usage or equivalent fuel-createmirror commands. fuel-mirror help create mentions 'groups' and 'paths' but provides no information as to what these could/shouldbe.

Steps to reproduce:
Attempt to use fuel-mirror...

Expected results:
Be able to actually know how to use fuel-mirror.

Actual result:
No idea what i'm doing due to lack of documentation.

Impact:
End users are frustrated and asking developers how to use it.

Changed in fuel:
assignee: nobody → Marcellin Fom Tchassem (mf6510)
Changed in fuel:
status: New → Confirmed
Dmitry Pyzhov (dpyzhov)
tags: removed: area-python
Changed in fuel:
assignee: Marcellin Fom Tchassem (mf6510) → nobody
Changed in fuel:
assignee: nobody → Fuel Documentation Team (fuel-docs)
Revision history for this message
greg pryzby (gpryzby-k) wrote :

Documentation for MSO 8.0 refers to fuel-createmirror online and in the fuel installer.

fuel-createmirror is deprecated and not installed on MOS 8.0.

fuel-mirror is installed but the documentation (fuel-mirror --help) is lacking information and examples.

Adding the options for --pattern would be helpful
   fuel-mirror create --pattern [ubuntu|centos] --group []

The groups are listed in /usr/share/fuel-mirror/*yaml and should be returned when asking for help. Or point to the yaml file or directory.

Changed in fuel:
assignee: Fuel Documentation Team (fuel-docs) → Evgeny Konstantinov (evkonstantinov)
Changed in fuel:
milestone: 9.0 → 10.0
Changed in fuel:
assignee: Evgeny Konstantinov (evkonstantinov) → Svetlana Karslioglu (skarslioglu)
Changed in fuel:
assignee: Svetlana Karslioglu (skarslioglu) → Evgeny Konstantinov (evkonstantinov)
Revision history for this message
Rodion Tikunov (rtikunov) wrote :
Changed in fuel:
milestone: 10.0 → 9.2
Changed in fuel:
assignee: Evgeny Konstantinov (evkonstantinov) → Olena Logvinova (ologvinova)
Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Fix proposed to fuel-docs (master)

Fix proposed to branch: master
Review: https://review.openstack.org/419498

Changed in fuel:
status: Confirmed → In Progress
Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Fix proposed to fuel-docs (stable/mitaka)

Fix proposed to branch: stable/mitaka
Review: https://review.openstack.org/428657

Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Fix proposed to fuel-docs (stable/newton)

Fix proposed to branch: stable/newton
Review: https://review.openstack.org/428659

Roman Vyalov (r0mikiam)
Changed in fuel:
milestone: 9.2 → 10.1
Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Fix merged to fuel-docs (master)

Reviewed: https://review.openstack.org/419498
Committed: https://git.openstack.org/cgit/openstack/fuel-docs/commit/?id=991c744ea81eb62f4a344880155d014da5bb1566
Submitter: Jenkins
Branch: master

commit 991c744ea81eb62f4a344880155d014da5bb1566
Author: Olena Logvinova <email address hidden>
Date: Thu Jan 12 16:47:18 2017 +0200

    [Install Guide] Replace fuel-createmirror with fuel-mirror

    The patch:

    1. Updates the 'Set up a local repository' section
       of the Fuel Install Guide to replace the deprecated
       `fuel-createmirror` command with the current
       `fuel-mirror` one;
    2. Moves this file to a separate section since it
       seems to be not related to the 'Upgrade' section;
    3. Fixes noticed typos.

    Closes-Bug: #1651737
    Partial-Bug: #1563086

    backport: newton mitaka

    Change-Id: I523ec8c6d5341a51fbdf555f1e9e0dfbab875770

Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Fix merged to fuel-docs (stable/newton)

Reviewed: https://review.openstack.org/428659
Committed: https://git.openstack.org/cgit/openstack/fuel-docs/commit/?id=c5bfc94a10e5c23ef5fc36c6a5ebf198750b8f38
Submitter: Jenkins
Branch: stable/newton

commit c5bfc94a10e5c23ef5fc36c6a5ebf198750b8f38
Author: Olena Logvinova <email address hidden>
Date: Thu Jan 12 16:47:18 2017 +0200

    [Install Guide] Replace fuel-createmirror with fuel-mirror

    The patch:

    1. Updates the 'Set up a local repository' section
       of the Fuel Install Guide to replace the deprecated
       `fuel-createmirror` command with the current
       `fuel-mirror` one;
    2. Moves this file to a separate section since it
       seems to be not related to the 'Upgrade' section;
    3. Fixes noticed typos.

    Closes-Bug: #1651737
    Partial-Bug: #1563086

    backport: newton mitaka

    Change-Id: I523ec8c6d5341a51fbdf555f1e9e0dfbab875770

tags: added: in-stable-newton
tags: added: in-stable-mitaka
Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Fix merged to fuel-docs (stable/mitaka)

Reviewed: https://review.openstack.org/428657
Committed: https://git.openstack.org/cgit/openstack/fuel-docs/commit/?id=b099b0b92fbd4d96bfc3454d49a1bac60b05005c
Submitter: Jenkins
Branch: stable/mitaka

commit b099b0b92fbd4d96bfc3454d49a1bac60b05005c
Author: Olena Logvinova <email address hidden>
Date: Thu Jan 12 16:47:18 2017 +0200

    [Install Guide] Replace fuel-createmirror with fuel-mirror

    The patch:

    1. Updates the 'Set up a local repository' section
       of the Fuel Install Guide to replace the deprecated
       `fuel-createmirror` command with the current
       `fuel-mirror` one;
    2. Moves this file to a separate section since it
       seems to be not related to the 'Upgrade' section;
    3. Fixes noticed typos.

    Closes-Bug: #1651737
    Partial-Bug: #1563086

    backport: newton mitaka

    Change-Id: I523ec8c6d5341a51fbdf555f1e9e0dfbab875770

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