diff --git a/docs/gettingStarted/quick-start.mdx b/docs/gettingStarted/quick-start.mdx index 40656e1072336..6326e68c75e55 100644 --- a/docs/gettingStarted/quick-start.mdx +++ b/docs/gettingStarted/quick-start.mdx @@ -33,7 +33,7 @@ chmod 755 start-doris.sh ### Step 2: Start the cluster -Run the script to start the cluster, using the `2.1.9` version by default +Run the script to start the cluster, using the `4.0.1` version by default ```shell bash start-doris.sh @@ -245,8 +245,22 @@ Download the corresponding binary installation package from the Apache Doris web 4 rows in set (0.10 sec) ``` +## FAQs +**Q: How do I install Docker on Mac?** +A: Download and install [Docker Desktop](https://www.docker.com/products/docker-desktop/). +**Q: Mac: "Error: Docker environment not detected" after Docker Desktop is installed** + +A: Create a symlink: + +```shell +sudo ln -s /Applications/Docker.app/Contents/Resources/bin/docker /usr/local/bin/docker +``` + +**Q: Mac: "error getting credentials - err: exit status 1, out: \`\`"** + +A: Remove the `credsStore` field in `~/.docker/config.json`. diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/gettingStarted/quick-start.mdx b/i18n/zh-CN/docusaurus-plugin-content-docs/current/gettingStarted/quick-start.mdx index 8b36b769e8b17..78db32fd9218e 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/gettingStarted/quick-start.mdx +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/gettingStarted/quick-start.mdx @@ -31,7 +31,7 @@ chmod 755 start-doris.sh ### 第 2 步:启动集群 -运行脚本,启动集群,默认使用`2.1.9`版本 +运行脚本,启动集群,默认使用 `4.0.1` 版本 ```shell bash start-doris.sh @@ -245,7 +245,21 @@ mysql -uroot -P9030 -h127.0.0.1 -e 'SELECT `host`, `alive` FROM backends()' 4 rows in set (0.10 sec) ``` +## 常见问题 +**Q: 如何在 Mac 上安装 Docker?** +A: 下载并安装 [Docker Desktop](https://www.docker.com/products/docker-desktop/)。 +**Q: Mac: 安装 Docker Desktop 后仍提示 "Error: Docker environment not detected"** + +A: 创建符号链接: + +```shell +sudo ln -s /Applications/Docker.app/Contents/Resources/bin/docker /usr/local/bin/docker +``` + +**Q: Mac: "error getting credentials - err: exit status 1, out: \`\`"** + +A: 删除 `~/.docker/config.json` 中的 `credsStore` 字段。 diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/gettingStarted/quick-start.mdx b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/gettingStarted/quick-start.mdx index dbd5c6242f965..78db32fd9218e 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/gettingStarted/quick-start.mdx +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/gettingStarted/quick-start.mdx @@ -28,12 +28,19 @@ chmod 755 start-doris.sh ``` + ### 第 2 步:启动集群 -运行脚本,启动集群,默认使用`2.1.9`版本,可通过 -v 参数指定启动版本,如: +运行脚本,启动集群,默认使用 `4.0.1` 版本 + +```shell +bash start-doris.sh +``` + +可通过 -v 参数指定启动版本,如: ```shell -bash start-doris.sh -v 3.0.4 +bash start-doris.sh -v 2.1.8 ``` ### 第 3 步:使用 MySQL 客户端连接集群,并检查集群状态 @@ -238,7 +245,21 @@ mysql -uroot -P9030 -h127.0.0.1 -e 'SELECT `host`, `alive` FROM backends()' 4 rows in set (0.10 sec) ``` +## 常见问题 + +**Q: 如何在 Mac 上安装 Docker?** +A: 下载并安装 [Docker Desktop](https://www.docker.com/products/docker-desktop/)。 + +**Q: Mac: 安装 Docker Desktop 后仍提示 "Error: Docker environment not detected"** + +A: 创建符号链接: + +```shell +sudo ln -s /Applications/Docker.app/Contents/Resources/bin/docker /usr/local/bin/docker +``` +**Q: Mac: "error getting credentials - err: exit status 1, out: \`\`"** +A: 删除 `~/.docker/config.json` 中的 `credsStore` 字段。 diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/gettingStarted/quick-start.mdx b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/gettingStarted/quick-start.mdx index 8b36b769e8b17..78db32fd9218e 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/gettingStarted/quick-start.mdx +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/gettingStarted/quick-start.mdx @@ -31,7 +31,7 @@ chmod 755 start-doris.sh ### 第 2 步:启动集群 -运行脚本,启动集群,默认使用`2.1.9`版本 +运行脚本,启动集群,默认使用 `4.0.1` 版本 ```shell bash start-doris.sh @@ -245,7 +245,21 @@ mysql -uroot -P9030 -h127.0.0.1 -e 'SELECT `host`, `alive` FROM backends()' 4 rows in set (0.10 sec) ``` +## 常见问题 +**Q: 如何在 Mac 上安装 Docker?** +A: 下载并安装 [Docker Desktop](https://www.docker.com/products/docker-desktop/)。 +**Q: Mac: 安装 Docker Desktop 后仍提示 "Error: Docker environment not detected"** + +A: 创建符号链接: + +```shell +sudo ln -s /Applications/Docker.app/Contents/Resources/bin/docker /usr/local/bin/docker +``` + +**Q: Mac: "error getting credentials - err: exit status 1, out: \`\`"** + +A: 删除 `~/.docker/config.json` 中的 `credsStore` 字段。 diff --git a/static/files/start-doris.sh b/static/files/start-doris.sh index 6e8aaf17c2dbe..eb08b113655d3 100755 --- a/static/files/start-doris.sh +++ b/static/files/start-doris.sh @@ -1,7 +1,7 @@ #!/bin/bash # Default version -DORIS_QUICK_START_VERSION="2.1.9" +DORIS_QUICK_START_VERSION="4.0.1" # Parse parameters while getopts "v:" opt; do @@ -103,7 +103,10 @@ EOF fi # Start services -$COMPOSE_CMD -f docker-compose-doris.yaml up -d +if ! $COMPOSE_CMD -f docker-compose-doris.yaml up -d; then + echo "Error: Failed to start Doris cluster" + exit 1 +fi echo "Doris cluster started successfully, version: ${DORIS_QUICK_START_VERSION}" echo "You can manage the cluster using the following commands:" diff --git a/versioned_docs/version-3.x/gettingStarted/quick-start.mdx b/versioned_docs/version-3.x/gettingStarted/quick-start.mdx index 1eac9ab5b79cd..6326e68c75e55 100644 --- a/versioned_docs/version-3.x/gettingStarted/quick-start.mdx +++ b/versioned_docs/version-3.x/gettingStarted/quick-start.mdx @@ -33,10 +33,16 @@ chmod 755 start-doris.sh ### Step 2: Start the cluster -Run the script to start the cluster. The default version is `2.1.9`. You can specify the startup version through the -v parameter, such as: +Run the script to start the cluster, using the `4.0.1` version by default ```shell -bash start-doris.sh -v 3.0.4 +bash start-doris.sh +``` + +You can specify the startup version through the -v parameter, such as: + +```shell +bash start-doris.sh -v 2.1.8 ``` ### Step 3: Connect to the cluster using MySQL client and check the cluster status @@ -239,8 +245,22 @@ Download the corresponding binary installation package from the Apache Doris web 4 rows in set (0.10 sec) ``` +## FAQs + +**Q: How do I install Docker on Mac?** +A: Download and install [Docker Desktop](https://www.docker.com/products/docker-desktop/). + +**Q: Mac: "Error: Docker environment not detected" after Docker Desktop is installed** + +A: Create a symlink: + +```shell +sudo ln -s /Applications/Docker.app/Contents/Resources/bin/docker /usr/local/bin/docker +``` +**Q: Mac: "error getting credentials - err: exit status 1, out: \`\`"** +A: Remove the `credsStore` field in `~/.docker/config.json`. diff --git a/versioned_docs/version-4.x/gettingStarted/quick-start.mdx b/versioned_docs/version-4.x/gettingStarted/quick-start.mdx index 40656e1072336..6326e68c75e55 100644 --- a/versioned_docs/version-4.x/gettingStarted/quick-start.mdx +++ b/versioned_docs/version-4.x/gettingStarted/quick-start.mdx @@ -33,7 +33,7 @@ chmod 755 start-doris.sh ### Step 2: Start the cluster -Run the script to start the cluster, using the `2.1.9` version by default +Run the script to start the cluster, using the `4.0.1` version by default ```shell bash start-doris.sh @@ -245,8 +245,22 @@ Download the corresponding binary installation package from the Apache Doris web 4 rows in set (0.10 sec) ``` +## FAQs +**Q: How do I install Docker on Mac?** +A: Download and install [Docker Desktop](https://www.docker.com/products/docker-desktop/). +**Q: Mac: "Error: Docker environment not detected" after Docker Desktop is installed** + +A: Create a symlink: + +```shell +sudo ln -s /Applications/Docker.app/Contents/Resources/bin/docker /usr/local/bin/docker +``` + +**Q: Mac: "error getting credentials - err: exit status 1, out: \`\`"** + +A: Remove the `credsStore` field in `~/.docker/config.json`.