hf200012 commented on code in PR #8867:
URL: https://github.com/apache/incubator-doris/pull/8867#discussion_r844549982
##########
new-docs/zh-CN/get-starting/get-starting.md:
##########
@@ -1,11 +1,12 @@
---
{
- "title": "快速开始",
+ "title": "Get-Starting",
Review Comment:
The name of the Chinese document here is to use Chinese
##########
new-docs/zh-CN/get-starting/get-starting.md:
##########
@@ -24,4 +25,665 @@ specific language governing permissions and limitations
under the License.
-->
-# 快速开始
\ No newline at end of file
+# Apache Doris 快速入门
+
+本文适用于暂未学习Apache Doris、想极速体验完整Apache Doris从编译部署到具体应用的同学。
+
+本文适用于多平台（Win|Mac|Linux）、多方式（裸机|Docker|虚拟机）的**单机部署**，可根据客观情况选择。
+
+## 环境准备
+
+1. CPU：2C（最低）8C（推荐）
+2. 内存：4G（最低）48G（推荐）
+3. 硬盘：100G（最低）400G（推荐）
+4. 平台：MacOS（Inter）、LinuxOS、Windows虚拟机
+5. 系统：CentOS（7.1及以上）、Ubuntu（16.04 及以上）
+6. 软件：JDK（1.8及以上）、GCC（4.8.2 及以上）
+
+## 单机部署
+
+**在创建之前，请准备好已完成编译的FE/BE文件，此教程不再赘述编译过程。**
+
+> 如无编译意向或想直接下载编译成功的文件，可使用如下链接下载对应版本
+>
+> Apache-Doris-Release--JDK1.8 预编译版本：
+>
+> 百度Palo-1.0-preview2-JDK1.8
预编译版本：https://palo-cloud-repo-bd.bd.bcebos.com/baidu-doris-release/PALO-1.0.0-preview2-no-avx2-binary.tar.gz
+
+1. 设置系统最大打开文件句柄数
+
+ ```shell
+ vi /etc/security/limits.conf
+ # 添加以下两行信息
+ * soft nofile 65536
+ * hard nofile 65536
+ # 保存退出并重启服务器
+ ```
+
+2. 下载二进制包/自主编译 FE / BE 文件
+
+ ```shell
+ wget https://doris.apache.org/apache-doris-release/要部署的版本
+ wget https://palo-cloud-repo-bd.bd.bcebos.com/baidu-doris-release/要部署的版本
+ # 例如如下链接
+ wget https://doris.apache.org/release/doris-1.0.0.tar.gz
+ wget
https://palo-cloud-repo-bd.bd.bcebos.com/baidu-doris-release/PALO-1.0.0-preview2-no-avx2-binary.tar.gz
+ ```
+
+3. 解压缩 tar.gz 文件
+
+ ```shell
+ tar -zxvf 下载好的二进制压缩包
+ # 例如
+ tar -zxvf PALO-1.0.0-preview2-no-avx2-binary.tar.gz
+ ```
+
+4. 迁移解压缩后的程序文件至指定目录并重命名
+
+ ```shell
+ mv 解压后的根目录 目标路径
+ cd 目标路径
+ # 例如
+ mv PALO-1.0.0-preview2-no-avx2-binary /opt/doris
+ cd /opt/doris
+ ```
+
+5. 配置 FE
+
+ ```shell
+ # 配置FE-Config
+ vi fe/conf/fe.conf
+ # 取消priority_networks的注释，修改参数
+ priority_networks = 127.0.0.0/24
+ # 保存退出
+ ```
+
+6. 配置 BE
+
+ ```shell
+ # 配置FE-Config
+ vi be/conf/be.conf
+ # 取消priority_networks的注释，修改参数
+ priority_networks = 127.0.0.0/24
+ # 保存退出
+ ```
+
+7. 配置环境变量
+
+ ```shell
+ # 配置环境变量
+ vim /etc/profile.d/doris.sh
+ export DORIS_HOME=Doris根目录 # 例如/opt/doris
+ export PATH=$PATH:$DORIS_HOME/fe/bin:$DORIS_HOME/be/bin
+ # 保存并source
+ source /etc/profile.d/doris.sh
+ ```
+
+8. 启动 FE 和 BE 并注册 BE 至 FE
+
+ ```shell
+ start_fe.sh --daemon
+ start_be.sh --daemon
+ ```
+
+ 校验FE启动是否成功
+
+ > 1. 检查是否启动成功, JPS 命令下有没有 PaloFe 进程
+ > 2. FE 进程启动后，会⾸先加载元数据，根据 FE ⻆⾊的不同，在⽇志中会看到 transfer from UNKNOWN to
MASTER/FOLLOWER/OBSERVER 。最终会看到 thrift server started ⽇志，并且可以通过 mysql 客户端连接到
FE，则 表示 FE 启动成功。
+ > 3. 也可以通过如下连接查看是否启动成功： http://fe_host:fe_http_port/api/bootstrap 如果返回：
{"status":"OK","msg":"Success"} 则表示启动成功，其余情况，则可能存在问题。
+ > 4. 外⽹环境访问 http://fe_host:fe_http_port 查看是否可以访问WebUI界 ⾯，登录账号默认为root，密码为空
+ >
+ > **注：如果在 fe.log 中查看不到启动失败的信息，也许在 fe.out 中可以看到。**
+
+ 校验 BE 启动是否成功
+
+ > 1. BE 进程启动后，如果之前有数据，则可能有数分钟不等的数据索引加载时 间。
+ > 2. 如果是 BE 的第⼀次启动，或者该 BE 尚未加⼊任何集群，则 BE ⽇志会定期滚 动 waiting to receive first
heartbeat from frontend 字样。表示 BE 还未通过 FE 的⼼跳收到 Master 的地址，正在被动等待。这种错误⽇志， 在 FE 中
ADD BACKEND 并发送⼼跳后，就会消失。如果在接到⼼跳后，⼜重 复出现 master client, get client from cache
failed.host: , port: 0, code: 7 字样，说明 FE 成功连接了 BE，但 BE ⽆法主动连接 FE。可能需要检查 BE 到 FE
的 rpc_port 的连通性。
+ > 3. 如果 BE 已经被加⼊集群，⽇志中应该每隔 5 秒滚动来⾃ FE 的⼼跳⽇ 志： get heartbeat, host:
xx.xx.xx.xx, port: 9020, cluster id: xxxxxx ，表示⼼跳正常。
+ > 4. 其次，⽇志中应该每隔 10 秒滚动 finish report task success. return code: 0 的字样，表示 BE
向 FE 的通信正常。
+ > 5. 同时，如果有数据查询，应该能看到不停滚动的⽇志，并且有 execute time is xxx ⽇志，表示 BE 启动成功，并且查询正常。
+ > 6. 也可以通过如下连接查看是否启动成功： http://be_host:be_http_port/api/health 如果返回：
{"status": "OK","msg": "To Be Added"} 则表示启动成功，其余情况，则可能存在问题。
+ >
+ > **注：如果在 be.INFO 中查看不到启动失败的信息，也许在 be.out 中可以看到。**
+
+ 注册 BE 至 FE（使用MySQL-Client，需自行安装）
+
+ ```shell
+ # 登录
+ mysql -h 127.0.0.1 -P 9030 -uroot
+ # 注册BE
+ ALTER SYSTEM ADD BACKEND "127.0.0.1:9050";
+ ```
+
+## Apache Doris简单使用
+
+Doris 采用 MySQL 协议进行通信，用户可通过 MySQL Client 或者 MySQL JDBC 连接到 Doris 集群。选择 MySQL
client 版本时建议采用5.1 之后的版本，因为 5.1 之前不能支持长度超过 16 个字符的用户名。Doris SQL 语法基本覆盖 MySQL 语法。
+
+### Apache Doris Web UI访问
+
+默认使用 Http 协议进行 WebUI 访问，在浏览器输入以下格式地址访问
+
+```cql
+http://FE_IP:FE_HTTP_PORT(默认8030)
+```
+
Review Comment:
It is best to put a screenshot here, use lossless compression, and control
the picture to dozens of kb
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
