Uploaded image for project: 'Red Hat Developer Hub Bugs'
  1. Red Hat Developer Hub Bugs
  2. RHDHBUGS-2140

Docs: Air-gapped install fails because `oc-mirror` command is missing `--v2` flag

XMLWordPrintable

    • Icon: Bug Bug
    • Resolution: Unresolved
    • Icon: Undefined Undefined
    • None
    • 1.7.0, 1.8.0
    • Documentation
    • None
    • False
    • Hide

      None

      Show
      None
    • False

      It looks like our air-gapped installation guide is broken. The `oc-mirror` command we tell users to run no longer works as-is.

      If you follow the current docs for an air-gapped install, the `oc-mirror` step fails with this error:

      ⚠️ the use of the flag --v1 or --v2 is mandatory, please use --v2 for the supported oc-mirror version or --v1 to continue using the deprecated version
      

       

      The Cause

      The oc-mirror tool itself changed. It now requires you to specify which engine version to use. The tool recommends --v2, which is the modern, supported version we should be guiding our users toward anyway.

      The Fix

      It looks like the fix is easy.  We just need to update the command in the documentation to include the --v2 flag.

      • Old command: `oc-mirror --config ImageSetConfiguration.yaml archive`
      • New command: oc-mirror --config ImageSetConfiguration.yaml archive --v2

      We should also mention which from which version this is necessary. I only know that in the latest supported OCP (4.19) version flag is required

              Unassigned Unassigned
              tkral@redhat.com Tomas Kral
              RHIDP - Documentation
              Votes:
              0 Vote for this issue
              Watchers:
              2 Start watching this issue

                Created:
                Updated: