Browse Source

[doc] Update Python 3.8.10 installation on M1 based Mac (#2823)

Ying Chen 3 years ago
parent
commit
9a708b97aa

+ 14 - 18
docs/docs-site/content/administrator/installation/dependencies/_index.md

@@ -172,12 +172,10 @@ This is a verified step-by-step guide on how to get Hue up and running on a fres
 
 
    `brew install gmp openssl libffi`
    `brew install gmp openssl libffi`
 
 
-7. Install python, tested with the **macOS 64-bit installer 3.7.9** direct download from python.org
-`https://www.python.org/ftp/python/3.7.9/python-3.7.9-macosx10.9.pkg`
+7. Install python, tested with the **macOS 64-bit installer 3.8.10** direct download from python.org
+`https://www.python.org/ftp/python/3.8.10/python-3.8.10-macos11.pkg`
 
 
-   - For **M1 Macs, 3.7.9 from python.org is the only Python version that works** and none of the homebrew versions work at the time of writing. Hue M1 support for Python >= 3.8 will be improved soon.
-
-   - For Intel Macs, other 3.x Python versions as well as Homebrew ones might work. However, direct download from python.org is preferred and tested.
+   - For Intel Macs, only Python 3.8 works as April 2022. Python 3.8 via Homebrew might work. However, direct download from python.org is preferred and tested.
 
 
 8. Install mysql client
 8. Install mysql client
 
 
@@ -190,7 +188,7 @@ This is a verified step-by-step guide on how to get Hue up and running on a fres
 10. In the cloned hue folder run:
 10. In the cloned hue folder run:
 
 
     ```
     ```
-    export PYTHON_VER=python3.7
+    export PYTHON_VER=python3.8
     export SKIP_PYTHONDEV_CHECK=true
     export SKIP_PYTHONDEV_CHECK=true
     export CFLAGS="-I$(xcrun --show-sdk-path)/usr/include/sasl"
     export CFLAGS="-I$(xcrun --show-sdk-path)/usr/include/sasl"
     export LDFLAGS="-L/usr/local/opt/libffi/lib -L/usr/local/opt/openssl@1.1/lib"
     export LDFLAGS="-L/usr/local/opt/libffi/lib -L/usr/local/opt/openssl@1.1/lib"
@@ -214,21 +212,12 @@ This is a verified step-by-step guide on how to get Hue up and running on a fres
       password=huepassword
       password=huepassword
       name=hue_d
       name=hue_d
     ```
     ```
-12. For **M1 Macs**, if `make apps` fails with `virtualenv is not compatible with this system or executable` error
 
 
-    ```
-    pip3.7 install virtualenv
-    virtualenv ./build/env
-    rm ./build/env/bin/python3.7
-    
-    make apps
-    ```
-
-13. If you use postgres as configured in the previous step you'll need to add the psycopg2 lib manually
+12. If you use postgres as configured in the previous step you'll need to add the psycopg2 lib manually
 
 
     `./build/env/bin/pip install psycopg2-binary`
     `./build/env/bin/pip install psycopg2-binary`
 
 
-14. Start Hue (note that export from step 10 above needs to be active)
+13. Start Hue (note that export from step 10 above needs to be active)
 
 
     `./build/env/bin/hue runserver 0.0.0.0:8888`
     `./build/env/bin/hue runserver 0.0.0.0:8888`
 
 
@@ -246,10 +235,17 @@ Fix openssl errors (required for MacOS 10.11+)
 
 
     export LDFLAGS=-L/usr/local/opt/openssl/lib && export CPPFLAGS=-I/usr/local/opt/openssl/include
     export LDFLAGS=-L/usr/local/opt/openssl/lib && export CPPFLAGS=-I/usr/local/opt/openssl/include
 
 
-If `runserver` stops abruptly with a  `"zsh: abort"` message
+If `runserver` stops abruptly with a `"zsh: abort"` message
 
 
     export DYLD_FALLBACK_LIBRARY_PATH=/usr/local/opt/openssl/lib
     export DYLD_FALLBACK_LIBRARY_PATH=/usr/local/opt/openssl/lib
 
 
+If `runserver` stops abruptly with a `loading libcrypto in an unsafe way` message
+
+    sudo mkdir /usr/local/lib
+    # depends on your openssl version, link the following files to /usr/local/lib
+    sudo ln -s /opt/homebrew/Cellar/openssl@3/3.0.2/lib/libcrypto.3.dylib /usr/local/lib/libcrypto.dylib
+    sudo ln -s /opt/homebrew/Cellar/openssl@3/3.0.2/lib/libssl.3.dylib /usr/local/lib/libssl.dylib
+
 If you are getting `Could not find Python.h` message
 If you are getting `Could not find Python.h` message
 
 
     export SKIP_PYTHONDEV_CHECK=true
     export SKIP_PYTHONDEV_CHECK=true