This is an automated email from the ASF dual-hosted git repository.
alexey pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/kudu.git
The following commit(s) were added to refs/heads/master by this push:
new da100c6e1 KUDU-3386 Update macOS docs for ARM
da100c6e1 is described below
commit da100c6e1c73165f6d094da81ed24b519afca1e8
Author: Marton Greber <[email protected]>
AuthorDate: Fri Aug 5 21:23:23 2022 +0200
KUDU-3386 Update macOS docs for ARM
This is the accompanying doc change to the ARM Mac support patch [1].
As the introductory line says, we now support ARM. Added macOS 11
(Big Sur) and macOS 12 (Monterey) to the supported macOS versions. Added
a link to the known not working tests for transparency, and to encourage
contributions. The CMake OPENSSL_ROOT_DIR flag's location in the guide
does not work on ARM Macs, as the homebrew path is different. Both
Kudu and thirdparty JWT need proper OPENSSL_ROOT_DIR. A pkg-config
export is added for OpenSSL which works on both Intel and Apple Silicon.
This takes care of both Kudu and thirdparty JWT.
[1] commit hash: 543e128d473f8f7836e605bba8cd6512fa918550
Change-Id: I02e5993979b88b525006344324e6b3be29aa869c
Reviewed-on: http://gerrit.cloudera.org:8080/18822
Tested-by: Kudu Jenkins
Reviewed-by: Alexey Serbin <[email protected]>
---
docs/installation.adoc | 42 +++++++++++++++++++++++++++++++-----------
1 file changed, 31 insertions(+), 11 deletions(-)
diff --git a/docs/installation.adoc b/docs/installation.adoc
index 24d474ac5..6cd105f8b 100644
--- a/docs/installation.adoc
+++ b/docs/installation.adoc
@@ -60,7 +60,9 @@ Linux::
link:troubleshooting.html#slow_dns_nscd[troubleshooting slow DNS lookups]
for more information.
macOS::
- - macOS 10.13 (High Sierra), macOS 10.14 (Mojave), macOS 10.15 (Catalina)
+ - macOS 10.13 (High Sierra), macOS 10.14 (Mojave), macOS 10.15 (Catalina),
+ macOS 11 (Big Sur), macOS 12 (Monterey)
+
Windows::
- Microsoft Windows is unsupported.
@@ -547,10 +549,29 @@ make -j4
[[osx_from_source]]
=== macOS
+Kudu works on both Intel and ARM based Macs (Apple M chips).
+Kudu support for macOS is experimental, and should only be used for
development.
+
+[WARNING]
+.macOS Known Issues
+====
+See link:https://issues.apache.org/jira/browse/KUDU-1219[macOS Limitations &
Known Issues]
+for more information. For any test related issues please first check whether
it's already tracked:
+link:https://issues.apache.org/jira/browse/KUDU-2715[Get all tests passing on
macOS].
+====
+
The link:https://developer.apple.com/xcode/[Xcode] package is necessary for
compiling Kudu. Some of the instructions below use
link:http://brew.sh/[Homebrew]
to install dependencies, but manual dependency installation is possible.
+[NOTE]
+.ARM Macs
+====
+Apple introduced support for Apple silicon in Xcode version
+link:https://developer.apple.com/documentation/xcode-release-notes/xcode-12_2-release-notes[12.2].
+To build Kudu on ARM-based Macs (Apple M chips), use Xcode of version 12.2 or
above.
+====
+
After installing Xcode, don't forget to accept the license and install
command-line
tools, if it's not done yet:
----
@@ -558,18 +579,18 @@ $ sudo xcodebuild -license
$ sudo xcode-select --install
----
-[WARNING]
-.macOS Known Issues
-====
-Kudu support for macOS is experimental, and should only be used for
development.
-See link:https://issues.apache.org/jira/browse/KUDU-1219[macOS Limitations &
Known Issues]
-for more information.
-====
. Install the prerequisite libraries, if they are not installed.
+
----
-$ brew install autoconf automake cmake git krb5 libtool openssl pkg-config
pstree
+$ brew install autoconf automake cmake git krb5 libtool [email protected] pkg-config
pstree
+----
+
+. Add OpenSSL to the pkg-config path. Kudu and thirdparty JWT fail to build
without proper
+OPENSSL_ROOT_DIR. If one sets the following environment variable, it takes
care of both cases.
++
+----
+$ export PKG_CONFIG_PATH="$(brew --prefix
[email protected])/lib/pkgconfig:$PKG_CONFIG_PATH"
----
. Optional: Install some additional packages, including ruby, if you plan to
build documentation.
@@ -645,7 +666,6 @@ mkdir -p build/release
cd build/release
../../thirdparty/installed/common/bin/cmake \
-DCMAKE_BUILD_TYPE=release \
- -DOPENSSL_ROOT_DIR=/usr/local/opt/openssl \
../..
make -j4
----
@@ -661,6 +681,7 @@ are installed.
brew tap homebrew/dupes
brew install autoconf automake cmake git krb5 libtool openssl pkg-config pstree
+export PKG_CONFIG_PATH="$(brew --prefix
[email protected])/lib/pkgconfig:$PKG_CONFIG_PATH"
git clone https://github.com/apache/kudu
cd kudu
thirdparty/build-if-necessary.sh
@@ -668,7 +689,6 @@ mkdir -p build/release
cd build/release
../../thirdparty/installed/common/bin/cmake \
-DCMAKE_BUILD_TYPE=release \
- -DOPENSSL_ROOT_DIR=/usr/local/opt/openssl \
../..
make -j4
----
