Bug 2029600 - connect vm to an external network quickstart has 404 link to network bridge doc
Summary: connect vm to an external network quickstart has 404 link to network bridge doc
Keywords:
Status: CLOSED ERRATA
Alias: None
Product: Container Native Virtualization (CNV)
Classification: Red Hat
Component: Installation
Version: 4.8.3
Hardware: Unspecified
OS: Unspecified
unspecified
medium
Target Milestone: ---
: 4.10.3
Assignee: Simone Tiraboschi
QA Contact: Satyajit Bulage
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2021-12-06 20:59 UTC by Dale Bewley
Modified: 2022-07-20 16:01 UTC (History)
11 users (show)

Fixed In Version: hco-bundle-registry-container-v4.10.3-1
Doc Type: If docs needed, set a value
Doc Text:
Clone Of:
Environment:
Last Closed: 2022-07-20 16:01:13 UTC
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)


Links
System ID Private Priority Status Summary Last Updated
Red Hat Product Errata RHEA-2022:5675 0 None None None 2022-07-20 16:01:27 UTC

Description Dale Bewley 2021-12-06 20:59:46 UTC
Document URL: 

1. OpenShift console -> Networking -> Network Attachment Definitions -> 'Create Network Attachment Definition'

2. 'Learn how to use network attachment definitions' -> 'Connecting a virtual machine to an external network' (quick start)

3. In pop-over under Prerequisites heading the first hyperlink is a 404 

3.a. Configure network bridges to support external connections -> https://docs.openshift.com/container-platform/4.7/networking/multiple_networks/configuring-bridge.html#nw-multus-bridge-object_configuring-bridge

3.b. Each link references an OCP 4.7 URL while operator is installed on a 4.8 cluster

Section Number and Name: 

 Connecting a virtual machine to an external network (quick start)

Comment 1 ctomasko 2021-12-07 02:37:56 UTC
@tnisan Looks like the broken link is in the UI in a hover-over message. I'll ask the writer's to find the correct link but we'll need an engineer to update the UI. Should we assign this to your team or should I contact the CNV network lead for engineering?

Comment 2 ctomasko 2022-03-29 02:05:29 UTC
Quickstart has bad URL

Comment 3 Guohua Ouyang 2022-04-26 02:45:21 UTC
The issue still exists on latest 4.11 console.

Comment 4 Yaacov Zamir 2022-05-01 10:55:52 UTC
Hi

I don't know what team eploy the quickstarts that to doc team writes, moving to SSP because I think SSP is the team that deploy the quickstarts CRs, please move to the correct team if another team deploys the quickstarts.

Comment 5 Fabian Deutsch 2022-05-04 12:04:44 UTC
@stirabos is taking care of the quickstarts, reassigning

Comment 8 Bob Gaydos 2022-05-11 14:31:15 UTC
According to the OpenShift writers, here is the correct URL: https://docs.openshift.com/container-platform/4.7/networking/multiple_networks/configuring-additional-network.html#nw-multus-bridge-object_configuring-additional-network

I would not recommend hard coding a release number in the link. If you already know that, that's great. If you need more details on how to generalize the link so it works across future releases, just ask.

@bgaydos

Comment 10 Bob Gaydos 2022-05-24 19:31:00 UTC
Hi @stirabos -

I thought I had a solution for you, but I do not. :-( 

When using docs.openshift.com, you can substitute `current_release` for the release number in a path and the link resolves to the latest release doc page, but this does not work anywhere other than docs.openshift.com. Current management direction is to steer users to the portal and it's associated pages. According to our Content Strategist, Avital Pinnock, the portal team has on it's list of improvements the ability to support the `current_release` variable, but there is no firm data when this enhancement will be implemented. If I hear anything, I will let you know.

Thanks,

Bob

cc: @ctomasko

Comment 11 ctomasko 2022-05-24 20:09:38 UTC
Here is a link to the most-recent 4.10 content. https://docs.openshift.com/container-platform/4.10/networking/multiple_networks/configuring-additional-network.html

Comment 12 Simone Tiraboschi 2022-06-01 11:55:39 UTC
Postponing due to capacity

Comment 14 Simone Tiraboschi 2022-06-06 06:14:05 UTC
waiting for the first build for 4.10.3

Comment 15 Satyajit Bulage 2022-06-24 13:59:57 UTC
ConsoleQuickStart: connect-to-extenal network in pointing to correct 4.10 link.
Verifying.

Comment 22 errata-xmlrpc 2022-07-20 16:01:13 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 (OpenShift Virtualization 4.10.3 Images), 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/RHEA-2022:5675


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