|
| 1 | +// Module included in the following assemblies: |
| 2 | +// |
| 3 | +// * docs/cli-guide/master.adoc |
| 4 | + |
| 5 | +:_content-type: PROCEDURE |
| 6 | + |
| 7 | +[id="cli-tool-known-issues_{context}"] |
| 8 | += {ProductShortName} {CLINameTitle} known issues |
| 9 | + |
| 10 | +This section provides highlighted known issues in {ProductShortName} {CLINameTitle}. |
| 11 | + |
| 12 | +.Limitations with Podman on Microsoft Windows |
| 13 | + |
| 14 | +The {CLINameTitle} is built and distributed with support for Microsoft Windows. |
| 15 | + |
| 16 | +However, when running any container image based on Red Hat Enterprise Linux 9 (RHEL9) or Universal Base Image 9 (UBI9), the following error can be returned when starting the container: |
| 17 | + |
| 18 | +[source,terminal] |
| 19 | +---- |
| 20 | +Fatal glibc error: CPU does not support x86-64-v2 |
| 21 | +---- |
| 22 | + |
| 23 | +This error is caused because Red Hat Enterprise Linux 9 or Universal Base Image 9 container images must be run on a CPU architecture that supports `x86-64-v2`. |
| 24 | + |
| 25 | +For more details, see link:https://access.redhat.com/solutions/7057314[(Running Red Hat Enterprise Linux 9 (RHEL) or Universal Base Image (UBI) 9 container images fail with "Fatal glibc error: CPU does not support x86-64-v2")]. |
| 26 | + |
| 27 | +{CLINameTitle} runs the container runtime correctly. However, different container runtime configurations are not supported. |
| 28 | + |
| 29 | +Although unsupported, you can run {CLINameTitle} with *Docker* instead of *Podman*, which would resolve this issue. |
| 30 | + |
| 31 | +To achieve this, you replace the `CONTAINER_TOOL` path with the path to Docker. |
| 32 | + |
| 33 | +For example, if you experience this issue, instead of issuing: |
| 34 | + |
| 35 | +[source,terminal] |
| 36 | +---- |
| 37 | +CONTAINER_TOOL=/usr/local/bin/docker mta-cli analyze |
| 38 | +---- |
| 39 | + |
| 40 | +You replace `CONTAINER_TOOL` with the path to Docker: |
| 41 | + |
| 42 | +[source,terminal] |
| 43 | +---- |
| 44 | +<Docker Root Dir>=/usr/local/bin/docker mta-cli analyze |
| 45 | +---- |
| 46 | + |
| 47 | +While this is not supported, it would allow you to explore {CLINameTitle} while you work to upgrade your hardware or move to hardware that supports `x86_64-v2`. |
0 commit comments