From 599ff8b4019004668a2356c62f683638f2907110 Mon Sep 17 00:00:00 2001 From: Matej Matkuliak <53749658+matkuliak@users.noreply.github.com> Date: Thu, 1 Aug 2024 01:14:55 +0200 Subject: [PATCH 1/2] Install: Clarify tarbal installation on macOS --- docs/install/tarball.rst | 23 ++++++++++++++++++----- 1 file changed, 18 insertions(+), 5 deletions(-) diff --git a/docs/install/tarball.rst b/docs/install/tarball.rst index da26e33b..39af60a5 100644 --- a/docs/install/tarball.rst +++ b/docs/install/tarball.rst @@ -9,24 +9,37 @@ This section of the documentation outlines how to use the release archives to install CrateDB. The walkthrough is suitable to install and run CrateDB on `Unix-like`_ systems, for example Linux and macOS. -#. Download the latest `CrateDB release archive`_. Please make sure to select +1. Download the latest `CrateDB release archive`_. Please make sure to select the right release archive matching your system. -#. Once downloaded, extract the archive either using your favorite terminal or +2. Once downloaded, extract the archive either using your favorite terminal or command line shell or by using a GUI tool like `7-Zip`_:: # Extract tarball on Unix-like systems tar -xzf crate-*.tar.gz -#. On the terminal, change into the extracted ``crate`` directory:: +3. On the terminal, change into the extracted ``crate`` directory:: cd crate-* -#. Run a CrateDB single-node instance on the local network interface:: +4. Run a CrateDB single-node instance on the local network interface:: ./bin/crate -#. In order to stop CrateDB again, use :kbd:`ctrl-c`. +.. NOTE:: + + When installing a specific version of CrateDB from tarball on a macOS + system for the first time, it is possible that you will encounter error: + **"java" cannot be openeded because developer cannot be verified.** + + This is expected and can be fixed in your system settings: + - Navigate to **System Preferences** -> **Security and Privacy** + - On the page you will see an **Allow Anyway** button for "java" + - After confirming, run the ``/bin/crate`` command again. You will be + asked to confirm once more with **Open** button. After that CrateDB + will run as expected. + +5. In order to stop CrateDB again, use :kbd:`ctrl-c`. .. SEEALSO:: From 0a18b4e35ab51286ae2b8ea706e28a27f34257ad Mon Sep 17 00:00:00 2001 From: Matej Matkuliak <53749658+matkuliak@users.noreply.github.com> Date: Thu, 1 Aug 2024 09:14:19 +0200 Subject: [PATCH 2/2] Update docs/install/tarball.rst Co-authored-by: Andreas Motl --- docs/install/tarball.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/install/tarball.rst b/docs/install/tarball.rst index 39af60a5..33ed256e 100644 --- a/docs/install/tarball.rst +++ b/docs/install/tarball.rst @@ -29,7 +29,7 @@ install CrateDB. The walkthrough is suitable to install and run CrateDB on .. NOTE:: When installing a specific version of CrateDB from tarball on a macOS - system for the first time, it is possible that you will encounter error: + system for the first time, it is possible that you will encounter an error like: **"java" cannot be openeded because developer cannot be verified.** This is expected and can be fixed in your system settings: