Bug 1871754
| Summary: | RFE: Should clarify which file is correct authentication file for openstack/glance conversion in virt-v2v-output-openstack man page | ||
|---|---|---|---|
| Product: | Red Hat Enterprise Linux Advanced Virtualization | Reporter: | mxie <mxie> |
| Component: | virt-v2v | Assignee: | Richard W.M. Jones <rjones> |
| Status: | CLOSED ERRATA | QA Contact: | tingting zheng <tzheng> |
| Severity: | low | Docs Contact: | |
| Priority: | low | ||
| Version: | 8.3 | CC: | jsuchane, juzhou, kkiwi, mzhan, ptoscano, tyan, tzheng, xiaodwan |
| Target Milestone: | rc | Keywords: | RFE, Triaged |
| Target Release: | 8.3 | ||
| Hardware: | x86_64 | ||
| OS: | Unspecified | ||
| Whiteboard: | |||
| Fixed In Version: | virt-v2v-1.42.0-11.el8 | Doc Type: | If docs needed, set a value |
| Doc Text: | Story Points: | --- | |
| Clone Of: | Environment: | ||
| Last Closed: | 2021-11-16 07:51:01 UTC | Type: | Bug |
| Regression: | --- | Mount Type: | --- |
| Documentation: | --- | CRM: | |
| Verified Versions: | Category: | --- | |
| oVirt Team: | --- | RHEL 7.3 requirements from Atomic Host: | |
| Cloudforms Team: | --- | Target Upstream Version: | |
| Embargoed: | |||
I cleaned this up a bit in commit 61b4b5cc2f64e7a642ea03681f36829dbe665825. 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.
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 |
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ļ¼