Bug 1871754 - RFE: Should clarify which file is correct authentication file for openstack/glance conversion in virt-v2v-output-openstack man page
Summary: RFE: Should clarify which file is correct authentication file for openstack/g...
Keywords:
Status: CLOSED ERRATA
Alias: None
Product: Red Hat Enterprise Linux Advanced Virtualization
Classification: Red Hat
Component: virt-v2v
Version: 8.3
Hardware: x86_64
OS: Unspecified
low
low
Target Milestone: rc
: 8.3
Assignee: Richard W.M. Jones
QA Contact: tingting zheng
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2020-08-24 08:21 UTC by mxie@redhat.com
Modified: 2021-11-16 07:59 UTC (History)
8 users (show)

Fixed In Version: virt-v2v-1.42.0-11.el8
Doc Type: If docs needed, set a value
Doc Text:
Clone Of:
Environment:
Last Closed: 2021-11-16 07:51:01 UTC
Type: Bug
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)


Links
System ID Private Priority Status Summary Last Updated
Red Hat Product Errata RHBA-2021:4684 0 None None None 2021-11-16 07:51:22 UTC

Description mxie@redhat.com 2020-08-24 08:21:31 UTC
Description of problem:
Should clarify which file is correct authentication file for openstack/glance conversion in virt-v2v-output-openstack man page


Version-Release number of selected component (if applicable):
virt-v2v-1.42.0-5.module+el8.3.0+7152+ab3787c3.x86_64


How reproducible:
100%

Steps to Reproduce:
1. Check virt-v2v-output-openstack about authentication, the info about openstack authentication file is ambiguous
#man virt-v2v-output-openstack
......
   OpenStack: Authentication
       Converting to OpenStack requires access to the tenant (non-admin) API endpoints.  You will need to either set up your
       "$OS_*" environment variables or use output options on the virt-v2v command line to authenticate with OpenStack.

       Normally there is a file called something like "stackrc", "overcloudrc" etc which you can simply "source" to set
       everything up.
......

OUTPUT TO GLANCE
       Note this is a legacy option.  In most cases you should use "OUTPUT TO OPENSTACK" instead.

       To output to OpenStack Glance, use the -o glance option.

       This runs the glance(1) CLI program which must be installed on the virt-v2v conversion host.  For authentication to
       work, you will need to set "OS_*" environment variables.  In most cases you can do this by sourcing a file called
       something like keystonerc_admin.
......

Actual results:
If source stackrc file to convert guest to openstack/glance by v2v when version of target openstack is 16.1, the guest will be converted to undercloud server where is a incorrect place to manage virtual machines


Expected results:
Should source overcloudrc to convert guest to openstack/glance by v2v when target openstack version >= 15
Should source keystonerc_admin to convert guest to openstack/glance by v2v when target openstack version < 15

Additional info:

Comment 2 Richard W.M. Jones 2021-04-27 15:14:03 UTC
I cleaned this up a bit in commit 61b4b5cc2f64e7a642ea03681f36829dbe665825.

Comment 5 tingting zheng 2021-05-14 07:08:07 UTC
Test the bug with:
virt-v2v-1.42.0-12.module+el8.5.0+10976+d40a93e9.x86_64

1. Check virt-v2v-output-openstack about authentication, the info about openstack authentication shows as below:

#man virt-v2v-output-openstack

......
   OpenStack: Authentication
       Converting to OpenStack requires access to the tenant (non-admin) API
       endpoints.  You will need to either set up your "$OS_*" environment
       variables or use output options on the virt-v2v command line to
       authenticate with OpenStack.

       Normally there is a file called "overcloudrc" or "keystonerc_admin"
       which you can simply "source" to set everything up.
......

OUTPUT TO GLANCE
       Note this is a legacy option.  In most cases you should use "OUTPUT TO
       OPENSTACK" instead.

       To output to OpenStack Glance, use the -o glance option.

       This runs the glance(1) CLI program which must be installed on the
       virt-v2v conversion host.  For authentication to work, you will need to
       set "OS_*" environment variables.

       Normally there is a file called "overcloudrc" or "keystonerc_admin"
       which you can simply "source" to set everything up.

From man page, the authentication files have been updated to correct one, so move the bug to VERIFIED.

Comment 8 errata-xmlrpc 2021-11-16 07:51:01 UTC
Since the problem described in this bug report should be
resolved in a recent advisory, it has been closed with a
resolution of ERRATA.

For information on the advisory (virt:av bug fix and enhancement update), and where to find the updated
files, follow the link below.

If the solution does not work for you, open a new bug report.

https://access.redhat.com/errata/RHBA-2021:4684


Note You need to log in before you can comment on or make changes to this bug.