Adding upstream version 0.13.0.
Signed-off-by: Daniel Baumann <daniel@debian.org>
This commit is contained in:
parent
c0ae77e0f6
commit
ecf5ca3300
272 changed files with 33172 additions and 0 deletions
67
docs/faq.md
Normal file
67
docs/faq.md
Normal file
|
@ -0,0 +1,67 @@
|
|||
<!--
|
||||
~ 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).
|
Loading…
Add table
Add a link
Reference in a new issue