blob: 7c995ac897247cddbc229ea1700bdff21d405b4a (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
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).
|
