You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@doris.apache.org by mo...@apache.org on 2021/12/26 09:33:21 UTC
[incubator-doris-website] 01/01: [fix] Fix blog image link
This is an automated email from the ASF dual-hosted git repository.
morningman pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/incubator-doris-website.git
commit 7bea1dd987da2a15ae13aee36164d29252483db5
Author: morningman <ch...@baidu.com>
AuthorDate: Sun Dec 26 15:37:53 2021 +0800
[fix] Fix blog image link
---
blogs/en/doris-tutorial-compilation.md | 76 +++++++++++++++----------------
blogs/zh-CN/doris-tutorial-compilation.md | 76 +++++++++++++++----------------
2 files changed, 76 insertions(+), 76 deletions(-)
diff --git a/blogs/en/doris-tutorial-compilation.md b/blogs/en/doris-tutorial-compilation.md
index 2a2aba1..efd5006 100644
--- a/blogs/en/doris-tutorial-compilation.md
+++ b/blogs/en/doris-tutorial-compilation.md
@@ -31,8 +31,6 @@ specific language governing permissions and limitations
under the License.
-->
-# Apache Doris Docker Compilation Installation and Deployment Tutorial (Win|Mac|Linux) - Compilation
-
This tutorial is intended for students who know little or nothing about Docker containerization technology, but want to try to deploy the hottest MPP-OLAP database Apache Doris for fun, or companies with new technical architecture needs, want to deploy a test environment for testing performance, simple build partners, the full text to try to use concise vernacular to enhance readability.
The tutorial starts with questions such as "What system can you compile with?", "How to configure the deployed cluster", "What is Docker", "Installing Docker and basic operations", and finally "How to compile Doris", "Doris quick deployment", etc. The full text is several thousand words, with a practical time of about 3-5 hours.
@@ -45,6 +43,8 @@ This tutorial will be divided into two parts, which have been tested on three pl
Translated with www.DeepL.com/Translator (free version)
+[[toc]]
+
## 1 Deployment process
*** This is the "Compilation" section, only for compilation. Deployment will be done by the "Deploy" section***
@@ -119,7 +119,7 @@ Docker version: 20.10.11
3. Download and install Docker Tools, after the initialization of Docker Tools, the color block of Docker Logo in the lower left corner turns green, which means the initialization is successful.
- 
+ 
4. There will be a code block in the Contalners/Apps Tab that says
@@ -163,43 +163,43 @@ Because it is very tedious, will increase a lot of work, and there are many no c
1. Create a new virtual machine
- 
+ 
2. Select Advanced
- 
+ 
3. Select -Install Later when installing system sources
- 
+ 
4. Select Linux-CentOS 7 64-bit when choosing a system
- 
+ 
5. choose a larger processor, preferably more than 4 total cores (the number of cores determines the compilation speed)
- 
+ 
6. slightly more memory too, more than 4G-8G
- ! [](images/blogs/doris-tutorial-compilation/image-20211221195624113.png)
+ ! [](/images/blogs/doris-tutorial-compilation/image-20211221195624113.png)
7. Select NAT network mode
- 
+ 
8. Capacity is optional, 50GB or more is fine
- 
+ 
9. Once created, select Edit Virtual Machine Settings
- 
+ 
10. Set the system ISO mapping file
- 
+ 
11. Start the virtual machine and install the system
@@ -209,37 +209,37 @@ First you need to configure the virtual network on the VM
1. Click `Edit Menu`, click `Virtual Network Editor`
- 
+ 
2. Click Change Settings
- 
+ 
3. Check the box as shown, then set the subnet IP address segment, the fourth segment is 0
- 
+ 
4. Then click on NAT settings and modify the gateway IP. Note that both the gateway IP and the virtual machine IP should match the criteria of the subnet IP address segment, that is, the other IP address settings, the first three segments should be consistent with the subnet IP
- 
+ 
5. All OK and apply
6. open the `Network and Internet` of your host computer (this computer)
- 
+ 
7. Right-click to edit the `VMnet8` network card and open the properties
- 
+ 
8. Select the IPv4 protocol and click Properties
- 
+ 
9. Modify the items inside
- 
+ 
Note that
@@ -257,7 +257,7 @@ After installing the virtual machine, log into the system and do the following t
vi /etc/sysconfig/network-scripts/ifcfg-ens33 #The last one is your network card name, change it according to your personal situation
```
- 
+ 
Keep and add the following entries.
@@ -280,7 +280,7 @@ After installing the virtual machine, log into the system and do the following t
service network restart
```
- 
+ 
Then ping the gateway, the host IP and the external network respectively
@@ -444,7 +444,7 @@ In the previous step, we have successfully deployed the Docker component on `Cen
docker pull apache/incubator-doris:build-env-for-0.15.0 #This is version 0.15.0
```
-
+
- After a successful pull, check the list of mirrors to see if they were successfully pulled
@@ -454,7 +454,7 @@ docker images
- If there is a red image circled below, the image is downloaded successfully
-
+
- If the pull is successful, run the run command and enter the Docker image
@@ -482,7 +482,7 @@ docker run --name apache-doris-0.15.0 -it -v /root/.m2:/root/.m2 -v /opt/doris:/
If the following command header appears after execution, the mirror has been successfully entered
-
+
#### 4.1.2 Specifying the JDK version (on-demand)
@@ -490,7 +490,7 @@ After completing pulling and entering the image, this next step is quite importa
In the official compiled environment image we pull down, we are actually given two sets of JDKs to choose from, one for JDK8 and one for JDK11, the default is JDK11, so we modify it as needed.
-
+
If you want to use JDK8 for your subsequent work, please execute the following code in order to change the JDK version
@@ -501,7 +501,7 @@ alternatives --set javac java-1.8.0-openjdk.x86_64
export JAVA_HOME=/usr/lib/jvm/java-1.8.0
```
-
+
If you want to use JDK11 in the future, then either you should not perform any operation in the first place, because the default is JDK11. If you perform the above command to switch to JDK8 and want to cut back, then use the following command to switch to JDK11
@@ -512,7 +512,7 @@ alternatives --set javac java-11-openjdk.x86_64
export JAVA_HOME=/usr/lib/jvm/java-11
```
-
+
#### 4.1.3 Compiling Doris
@@ -554,7 +554,7 @@ sh build.sh
If the Docker version of the pulled Doris build environment is `build-env-1.4.2` or `build-env-for-0.15.0` (the version can be checked with the `docker images` command under CentOS as described in section `4.1.1`)
-
+
This is because the 1.4.2 image has been upgraded to ``thrift(0.9 -> 0.13)`, and you need to force the new version of ``thrift` to generate the code file with the --clean command, otherwise incompatible code will appear.
@@ -564,17 +564,17 @@ sh build.sh --clean --be --fe --ui -j2
Next, you can go do other things, the tutorial test machine is using `2C 4G 8M` to compile, taking **two hours**, during the period if you find the following chart, and run super slow, is normal, the node do not continue to carry out other actions, just wait for the completion, so as not to occur inexplicable errors.
-
+
The following message will prove that the compilation was successful
-
+
##### 4.1.3.3 Occasional error
The compilation ended up with Failed, which means that the compilation failed with the error message
-
+
where the main description is: `ninja: build stopped: subcommand failed.`
@@ -594,7 +594,7 @@ If you still get the error, you need to reset the server system and start the co
After successful compilation, the `output` folder will be created in the `apache-doris-0.15.0-incubating-src` directory (or the current directory if nothing else is done)
-
+
Execute the view directory command to see the contents of this folder
@@ -606,15 +606,15 @@ The following folders need to be in the directory for the compilation to be succ
- Linux cloud server.
- 
+ 
- Win platform
- 
+ 
- MacOS platform
- 
+ 
At this point, all compilation steps are complete and successful~
@@ -628,7 +628,7 @@ docker cp container name: the path of the file to be copied inside the container
Note that the container name here is the name of the currently running Docker container after executing the ``docker ps`` command **on the host**
-
+
```shell
# For example
diff --git a/blogs/zh-CN/doris-tutorial-compilation.md b/blogs/zh-CN/doris-tutorial-compilation.md
index 9dd4d0d..f81b488 100644
--- a/blogs/zh-CN/doris-tutorial-compilation.md
+++ b/blogs/zh-CN/doris-tutorial-compilation.md
@@ -30,8 +30,6 @@ specific language governing permissions and limitations
under the License.
-->
-# Apache Doris 全平台保姆级Docker编译安装部署教程（Win|Mac|Linux）- 编译版
-
本教程的目的，是针对对Docker容器化技术知之甚少甚至一无所知，但又想尝试部署当下最火热的MPP-OLAP数据库Apache Doris玩耍的同学，或者公司有新的技术架构需求，想部署测试环境进行测试性能、简单搭建的伙伴，全文尽量使用简练白话文增强可阅读性。
本教程始于「用啥系统可以编译啊」、「部署的集群怎么配置」、「Docker是啥」、「安装Docker及基本操作」等疑问，终于「Doris如何编译」、「Doris快速部署」等话题，全文数千字，实战时间3-5小时左右。
@@ -42,6 +40,8 @@ under the License.
本教程将会分为两部分，已经通过三平台分别测试，均成功编译及部署~
+[[toc]]
+
## 1 部署流程
***本篇为「编译篇」只涉及编译，部署将由「部署篇」完成***
@@ -116,7 +116,7 @@ Docker版本：20.10.11
3. 下载安装，Docker Tools初始化好后左下角Docker Logo所在的色块变绿色即代表初始化成功
- 
+ 
4. Contalners/Apps Tab里会有一个代码块，写着
@@ -160,43 +160,43 @@ Docker版本：20.10.11
1. 新建虚拟机
- 
+ 
2. 选择高级
- 
+ 
3. 在安装系统来源时选择-稍后安装
- 
+ 
4. 在选择系统时选择Linux-CentOS 7 64位
- 
+ 
5. 处理器选大一些，最好4内核总数以上（内核数量决定了编译速度）
- 
+ 
6. 内存也稍微大一些，4G-8G以上
- 
+ 
7. 选择NAT网络模式
- 
+ 
8. 容量随意，50GB以上即可
- 
+ 
9. 创建好以后选择 编辑虚拟机设置
- 
+ 
10. 设置系统ISO映射文件
- 
+ 
11. 开启虚拟机，安装系统即可
@@ -206,37 +206,37 @@ Docker版本：20.10.11
1. 点击`编辑菜单`，点击`虚拟网络编辑器`
- 
+ 
2. 点击更改设置
- 
+ 
3. 照图进行勾选，然后设置子网IP地址段，第四段为0
- 
+ 
4. 然后点击NAT设置，修改网关IP，要注意，无论网关IP还是虚拟机IP，都要符合子网IP地址段的标准，也就是说，其他的IP地址设置，前三段要和子网IP一致
- 
+ 
5. 全部确定及应用
6. 打开你宿主机（本电脑）的`网络和Internet`
- 
+ 
7. 右键编辑 `VMnet8`网卡，打开属性
- 
+ 
8. 选择IPv4协议，点击属性
- 
+ 
9. 修改里面的项目
- 
+ 
其中注意
@@ -254,7 +254,7 @@ Docker版本：20.10.11
vi /etc/sysconfig/network-scripts/ifcfg-ens33 #最后这个是你的网卡名，根据个人情况更改
```
- 
+ 
保留和新增如下项：
@@ -277,7 +277,7 @@ Docker版本：20.10.11
service network restart
```
- 
+ 
然后分别ping一下网关、宿主机IP及外网
@@ -441,7 +441,7 @@ Docker是一个开源的应用容器引擎，让开发者可以打包他们的
docker pull apache/incubator-doris:build-env-for-0.15.0 #这是0.15.0版本
```
-
+
- 拉取成功后，查看镜像列表，看是否已成功拉取
@@ -451,7 +451,7 @@ docker images
- 如有下图圈红镜像，则证明镜像下载成功
-
+
- 如已成功拉取，运行run命令，进入Docker镜像
@@ -479,7 +479,7 @@ docker run --name apache-doris-0.15.0 -it -v /root/.m2:/root/.m2 -v /opt/doris:/
执行以后出现如下命令头，则代表已成功进入镜像
-
+
#### 4.1.2 指定JDK版本（按需执行）
@@ -487,7 +487,7 @@ docker run --name apache-doris-0.15.0 -it -v /root/.m2:/root/.m2 -v /opt/doris:/
在我们拉取下的官方编译环境镜像中，其实给了两套JDK供我们选择，一套是JDK8、一套JDK11，默认使用的是JDK11，所以我们按需进行修改。
-
+
假如你希望以及后续工作都使用JDK8的话，请依次执行以下代码修改JDK版本
@@ -498,7 +498,7 @@ alternatives --set javac java-1.8.0-openjdk.x86_64
export JAVA_HOME=/usr/lib/jvm/java-1.8.0
```
-
+
假如你希望以后使用的是JDK11，那要么你一开始就不要执行任何操作，因为默认就是JDK11，如果执行了以上切换JDK8命令，又想切回来，那就用如下命令切换到JDK11
@@ -509,7 +509,7 @@ alternatives --set javac java-11-openjdk.x86_64
export JAVA_HOME=/usr/lib/jvm/java-11
```
-
+
#### 4.1.3 编译Doris
@@ -551,7 +551,7 @@ sh build.sh
假如拉取下的Doris编译环境的Docker版本是`build-env-1.4.2`或者`build-env-for-0.15.0`（版本可通过`4.1.1`章节所述，在CentOS系统下使用`docker images`命令进行查看）
-
+
则第一次编译的时候要使用如下命令，这是因为1.4.2 版本镜像升级了 `thrift(0.9 -> 0.13)`，需要通过 --clean 命令强制使用新版本的 `thrift` 生成代码文件，否则会出现不兼容的代码。
@@ -561,17 +561,17 @@ sh build.sh --clean --be --fe --ui -j2
接下来，可以去做其他事情了，教程测试机器是使用`2C 4G 8M`进行编译，耗时**两小时**，期间如发现出现如下图，且运行速度超慢，属正常现象，该节点勿持续进行其他动作，静待完成即可，以免发生莫名错误。
-
+
出现以下报文，则证明编译成功
-
+
##### 4.1.3.3 偶现错误
编译最后出现了Failed，代表编译失败了，错误信息为
-
+
其中主要描述为：`ninja: build stopped: subcommand failed.`
@@ -591,7 +591,7 @@ sh build.sh -j2
编译成功后，在`apache-doris-0.15.0-incubating-src`目录（如无其他操作，则为当前目录）下会生成`output`文件夹
-
+
执行查看目录命令，查看该文件夹内容
@@ -603,15 +603,15 @@ ll output
- Linux云服务器：
- 
+ 
- Win平台
- 
+ 
- MacOS平台
- 
+ 
至此，编译步骤全部完成且成功~
@@ -625,7 +625,7 @@ docker cp 容器名:要拷贝的文件在容器里面的路径 要拷贝到宿
需要注意，这里的容器名是**在宿主机**执行`docker ps`命令后，得到的当前正在运行的Docker容器的名字
-
+
```shell
# 例如
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@doris.apache.org
For additional commands, e-mail: commits-help@doris.apache.org