anta/docs/faq.md

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:

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:

   pip3 uninstall urllib3
   
   pip3 install urllib3==1.26.15
   

2. Recommended: Upgrade System or Libraries:

   As per the urllib3 v2 migration guide, 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:

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

   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

   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.