فهرست منبع

[docs] Update Hue setup guide with latest steps for M1 Macs (#2705)

Harsh Gupta 3 سال پیش
والد
کامیت
d5082439f8
1فایلهای تغییر یافته به همراه17 افزوده شده و 8 حذف شده
  1. 17 8
      docs/docs-site/content/administrator/installation/dependencies/_index.md

+ 17 - 8
docs/docs-site/content/administrator/installation/dependencies/_index.md

@@ -138,15 +138,15 @@ Tip: if you run into building kerberos extension issue and see message `krb5-con
 * Xcode command line tools
 * Xcode command line tools
 * [Homebrew](https://brew.sh)
 * [Homebrew](https://brew.sh)
 
 
-#### Big Sur on M1 or Intel with Python 3
+#### M1 or Intel based Macs with Python 3
 
 
-This is a verified step-by-step guide on how to get up and running on a fresh installation of macOS Big Sur, tested on both M1 and Intel based MacBook Pro.
+This is a verified step-by-step guide on how to get Hue up and running on a fresh installation of macOS (Big Sur, Monterey 12.0.1), tested on both M1 and Intel based MacBook Pro.
 
 
 1. Clone the Hue repo
 1. Clone the Hue repo
 
 
     `git clone https://github.com/cloudera/hue.git`
     `git clone https://github.com/cloudera/hue.git`
 
 
-2. Install Brew if not already installed
+2. Install Brew (if not already installed)
 
 
    `/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"`
    `/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"`
 
 
@@ -172,12 +172,12 @@ This is a verified step-by-step guide on how to get up and running on a fresh in
 
 
    `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.
+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`
 `https://www.python.org/ftp/python/3.7.9/python-3.7.9-macosx10.9.pkg`
 
 
-   - For M1 Macs, 3.7.9 from python.org is the only one that works and none of the homebrew version work at the time of writing.
+   - 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 might work. However, direct download from python.org is preferred and tested.
+   - 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.
 
 
 8. Install mysql client
 8. Install mysql client
 
 
@@ -214,12 +214,21 @@ This is a verified step-by-step guide on how to get up and running on a fresh in
       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
 
 
-12. If you use postgres as configured in the previous step you'll need to add the psycopg2 lib manually
+    ```
+    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
 
 
     `./build/env/bin/pip install psycopg2-binary`
     `./build/env/bin/pip install psycopg2-binary`
 
 
-12. Start Hue (note that export from step 10 above needs to be active)
+14. 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`