From 45dd2fe0263caaa96be337148c6f4ad64696ff3d Mon Sep 17 00:00:00 2001 From: Guillaume Mulocher Date: Wed, 7 Feb 2024 15:57:44 +0100 Subject: [PATCH] doc: Add OSX FAQ (#558) Doc: Add OSX FAQ --- docs/faq.md | 18 +++++++++++++++--- 1 file changed, 15 insertions(+), 3 deletions(-) diff --git a/docs/faq.md b/docs/faq.md index b970dd611..7c995ac89 100644 --- a/docs/faq.md +++ b/docs/faq.md @@ -16,7 +16,7 @@ ImportError: urllib3 v2.0 only supports OpenSSL 1.1.1+, currently the 'ssl' modu This error arises due to a compatibility issue between `urllib3` v2.0 and older versions of OpenSSL. -### How can I resolve this error? +#### How can I resolve this error? 1. _Workaround_: Downgrade `urllib3` @@ -42,14 +42,26 @@ 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? +#### 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).