68 lines
2.3 KiB
Markdown
68 lines
2.3 KiB
Markdown
|
<!--
|
||
|
|
~ Copyright (c) 2023-2024 Arista Networks, Inc.
|
||
|
|
~ Use of this source code is governed by the Apache License 2.0
|
||
|
|
~ that can be found in the LICENSE file.
|
||
|
|
-->
|
||
|
|
|
||
|
|
# Frequently Asked Questions (FAQ)
|
||
|
|
|
||
|
|
## Why am I seeing an `ImportError` related to `urllib3` when running ANTA?
|
||
|
|
|
||
|
|
When running the `anta --help` command, some users might encounter the following error:
|
||
|
|
|
||
|
|
```bash
|
||
|
|
ImportError: urllib3 v2.0 only supports OpenSSL 1.1.1+, currently the 'ssl' module is compiled with 'OpenSSL 1.0.2k-fips 26 Jan 2017'. See: https://github.com/urllib3/urllib3/issues/2168
|
||
|
|
```
|
||
|
|
|
||
|
|
This error arises due to a compatibility issue between `urllib3` v2.0 and older versions of OpenSSL.
|
||
|
|
|
||
|
|
#### How can I resolve this error?
|
||
|
|
|
||
|
|
1. _Workaround_: Downgrade `urllib3`
|
||
|
|
|
||
|
|
If you need a quick fix, you can temporarily downgrade the `urllib3` package:
|
||
|
|
|
||
|
|
```bash
|
||
|
|
pip3 uninstall urllib3
|
||
|
|
|
||
|
|
pip3 install urllib3==1.26.15
|
||
|
|
```
|
||
|
|
|
||
|
|
2. _Recommended_: Upgrade System or Libraries:
|
||
|
|
|
||
|
|
As per the [urllib3 v2 migration guide](https://urllib3.readthedocs.io/en/latest/v2-migration-guide.html), the root cause of this error is an incompatibility with older OpenSSL versions. For example, users on RHEL7 might consider upgrading to RHEL8, which supports the required OpenSSL version.
|
||
|
|
|
||
|
|
## Why am I seeing `AttributeError: module 'lib' has no attribute 'OpenSSL_add_all_algorithms'` when running ANTA
|
||
|
|
|
||
|
|
When running the `anta` commands after installation, some users might encounter the following error:
|
||
|
|
|
||
|
|
```bash
|
||
|
|
AttributeError: module 'lib' has no attribute 'OpenSSL_add_all_algorithms'
|
||
|
|
```
|
||
|
|
|
||
|
|
The error is a result of incompatibility between `cryptography` and `pyopenssl` when installing `asyncssh` which is a requirement of ANTA.
|
||
|
|
|
||
|
|
#### How can I resolve this error?
|
||
|
|
|
||
|
|
1. Upgrade `pyopenssl`
|
||
|
|
|
||
|
|
```bash
|
||
|
|
pip install -U pyopenssl>22.0
|
||
|
|
```
|
||
|
|
|
||
|
|
## `__NSCFConstantString initialize` error on OSX
|
||
|
|
|
||
|
|
This error occurs because of added security to restrict multithreading in macOS High Sierra and later versions of macOS. https://www.wefearchange.org/2018/11/forkmacos.rst.html
|
||
|
|
|
||
|
|
#### How can I resolve this error?
|
||
|
|
|
||
|
|
1. Set the following environment variable
|
||
|
|
|
||
|
|
```bash
|
||
|
|
export OBJC_DISABLE_INITIALIZE_FORK_SAFETY=YES
|
||
|
|
```
|
||
|
|
|
||
|
|
## Still facing issues?
|
||
|
|
|
||
|
|
If you've tried the above solutions and continue to experience problems, please report the issue in our [GitHub repository](https://github.com/arista-netdevops-community/anta).
|