You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@doris.apache.org by yi...@apache.org on 2024/01/14 09:31:17 UTC
(doris) branch master updated: [enhancement](docs) Clarify the requirement for JDK exact version 8 in install guide (#29921)
This is an automated email from the ASF dual-hosted git repository.
yiguolei pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/doris.git
The following commit(s) were added to refs/heads/master by this push:
new a346408717a [enhancement](docs) Clarify the requirement for JDK exact version 8 in install guide (#29921)
a346408717a is described below
commit a346408717ad9e1da6d4f304742c9f85fd84ace3
Author: Lars Helge Øverland <la...@dhis2.org>
AuthorDate: Sun Jan 14 10:31:08 2024 +0100
[enhancement](docs) Clarify the requirement for JDK exact version 8 in install guide (#29921)
* docs: Clarified the requirement for JDK exact version 8
* fix: Update code
---
docs/en/docs/get-starting/quick-start.md | 34 ++++++++++++++---------------
docs/en/docs/install/standard-deployment.md | 14 ++++++------
2 files changed, 24 insertions(+), 24 deletions(-)
diff --git a/docs/en/docs/get-starting/quick-start.md b/docs/en/docs/get-starting/quick-start.md
index 1a9156f98ce..8e2b7191fd0 100644
--- a/docs/en/docs/get-starting/quick-start.md
+++ b/docs/en/docs/get-starting/quick-start.md
@@ -27,11 +27,11 @@ under the License.
# Quick Start
-Apache Doris is a high-performance, real-time analytic database based on the MPP architecture and is known for its extreme speed and ease of use. It takes only sub-second response times to return query results under massive amounts of data, and can support not only highly concurrent point query scenarios, but also high-throughput complex analytic scenarios. This brief guide will show you how to download the latest stable version of Doris, install and run it on a single node, including cr [...]
+Apache Doris is a high-performance, real-time analytic database based on the MPP architecture and is known for its extreme speed and ease of use. It takes only sub-second response times to return query results under massive amounts of data, and can support not only highly concurrent point query scenarios, but also high-throughput complex analytic scenarios. This brief guide will show you how to download the latest stable version of Doris, install and run it on a single node, including cr [...]
## Download Doris
-Doris runs on a Linux environment, CentOS 7.x or Ubuntu 16.04 or higher is recommended, and you need to have a Java runtime environment installed (the JDK version required is 8). To check the version of Java you have installed, run the following command.
+Doris runs on a Linux environment, CentOS 7.x or Ubuntu 16.04 or higher is recommended, and you need to have a Java runtime environment installed (the exact JDK version required is 8). You can run the following command to verify the installed version of Java.
```
java -version
@@ -55,7 +55,7 @@ cd apache-doris-x.x.x/fe
Modify the FE configuration file `conf/fe.conf`, here we mainly modify two parameters: `priority_networks` and `meta_dir`, if you need more optimized configuration, please refer to [FE parameter configuration](../admin-manual/config/fe-config.md) for instructions on how to adjust them.
-1. add priority_networks parameter
+1. add the `priority_networks` parameter
```
priority_networks=172.23.16.0/24
@@ -87,7 +87,7 @@ Execute the following command in the FE installation directory to complete the F
#### View FE operational status
-You can check if Doris started successfully with the following command
+Check if Doris started successfully with the following command.
```
curl http://127.0.0.1:8030/api/bootstrap
@@ -114,7 +114,7 @@ You can see the following screen, which indicates that the FE has started succes
We will connect to Doris FE via MySQL client below, download the installation-free [MySQL client](https://doris-build-hk.oss-cn-hongkong.aliyuncs.com/mysql-client/mysql-5.7.22-linux-glibc2.12-x86_64.tar.gz)
-Unzip the MySQL client you just downloaded and you can find the `mysql` command line tool in the `bin/` directory. Then execute the following command to connect to Doris.
+Unzip the MySQL client you just downloaded. You can find the `mysql` command line tool in the `bin/` directory. Execute the following command to connect to Doris.
```
mysql -uroot -P9030 -h127.0.0.1
@@ -126,7 +126,7 @@ mysql -uroot -P9030 -h127.0.0.1
>2. -P: Here is our query port to connect to Doris, the default port is 9030, which corresponds to `query_port` in fe.conf
>3. -h: Here is the IP address of the FE we are connecting to, if your client and FE are installed on the same node you can use 127.0.0.1
-Execute the following command to view the FE running status
+Execute the following command to view the FE running status.
```sql
show frontends\G;
@@ -158,7 +158,7 @@ ReplayedJournalId: 49292
1 row in set (0.03 sec)
```
-1. If the IsMaster, Join and Alive columns are true, the node is normal.
+1. If the `IsMaster`, `Join` and `Alive` columns are `true`, the node is running normally.
#### Communicate with the server over an encrypted connection
@@ -184,7 +184,7 @@ Doris needs a key certificate file to verify the SSL encrypted connection. The d
#### Stop FE
-The stopping of Doris FE can be done with the following command
+The Doris FE can be stopped with the following command
```
./bin/stop_fe.sh
@@ -200,7 +200,7 @@ cd apache-doris-x.x.x/be
Modify the BE configuration file `conf/be.conf`, here we mainly modify two parameters: `priority_networks'` and `storage_root`, if you need more optimized configuration, please refer to [BE parameter configuration](../admin-manual/config/be-config.md) instructions to make adjustments.
-1. Add priority_networks parameter
+1. Add the `priority_networks` parameter
```
priority_networks=172.23.16.0/24
@@ -219,8 +219,8 @@ storage_root_path=/path/your/data_dir
>Notes.
>
->1. The default directory is in the storage directory of the BE installation directory.
->2. The storage directory for BE configuration must be created first
+>1. The default directory is the storage directory of the BE installation directory
+>2. The storage directory specified in the BE configuration must first be created manually
3. Set JAVA_HOME environment variable
@@ -259,7 +259,7 @@ You can check the running status of BE by executing the following command at the
SHOW BACKENDS\G；
```
-Example:
+Example output:
```sql
mysql> SHOW BACKENDS\G;
@@ -289,11 +289,11 @@ ClusterDecommissioned: false
1 row in set (0.01 sec)
```
-1. Alive : true means the node is running normally
+1. If `Alive` is set to `true` the node is running normally.
#### Stop BE
-The stopping of Doris BE can be done with the following command
+The Doris BE can be stopped with the following command
```
./bin/stop_be.sh
@@ -384,7 +384,7 @@ After successful execution we can see the following return message
2. `NumberTotalRows` indicates the total amount of data to be imported
-3. `Status` :Success means the import was successful
+3. `Status` value `Success` means the import was successful
Here we have finished importing the data, and we can now query and analyze the data according to our own needs.
@@ -427,6 +427,6 @@ mysql> select city, sum(cost) as total_cost from example_tbl group by city;
4 rows in set (0.00 sec)
```
+## Conclusion
-
-This is the end of our entire quick start. We have experienced the complete Doris operation process from Doris installation and deployment, start/stop, creation of library tables, data import and query, let's start our Doris usage journey.
+This is the end of the quick start. We have experienced the complete Doris operation process from Doris installation and deployment, start/stop, creation of library tables, data import and query. Let us start our Doris usage journey.
diff --git a/docs/en/docs/install/standard-deployment.md b/docs/en/docs/install/standard-deployment.md
index a62840bcb83..0676a84a11c 100644
--- a/docs/en/docs/install/standard-deployment.md
+++ b/docs/en/docs/install/standard-deployment.md
@@ -27,7 +27,7 @@ under the License.
# Installation and Deployment
-This topic is about the hardware and software environment needed to deploy Doris, the recommended deployment mode, cluster scaling, and common problems occur in creating and running clusters.
+This topic is about the hardware and software environment needed to deploy Doris, the recommended deployment mode, cluster scaling, and common problems occuring when creating and running clusters.
Before continue reading, you might want to compile Doris following the instructions in the [Compile](https://doris.apache.org/docs/dev/install/source-install/compilation-general/) topic.
@@ -35,7 +35,7 @@ Before continue reading, you might want to compile Doris following the instructi
### Overview
-Doris, as an open source OLAP database with an MPP architecture, can run on most mainstream commercial servers. For you to take full advantage of the high concurrency and high availability of Doris, we recommend that your computer meet the following requirements:
+Doris, an open source OLAP database with an MPP architecture, can run on most mainstream commercial servers. For you to take full advantage of the high concurrency and high availability of Doris, we recommend that your computer meet the following requirements:
#### Linux Operating System Version Requirements
@@ -48,7 +48,7 @@ Doris, as an open source OLAP database with an MPP architecture, can run on most
| Soft | Version |
|---|---|
-| Java | 1.8 |
+| Java | 1.8 (exact) |
| GCC | 4.8.2 and above |
#### OS Installation Requirements
@@ -77,15 +77,15 @@ Both ext4 and xfs file systems are supported.
| Module | CPU | Memory | Disk | Network | Number of Instances |
|---|---|---|---|---|---|
-| Frontend | 8 core + | 8GB + | SSD or SATA, 10GB + * | Gigabit Network Card | 1|
+| Frontend | 8 core + | 8GB + | SSD or SATA, 10GB + * | Gigabit Network Card | 1 |
| Backend | 8 core + | 16GB + | SSD or SATA, 50GB + * | Gigabit Network Card | 1-3*|
#### Production Environment
| Module | CPU | Memory | Disk | Network | Number of Instances (Minimum Requirements) |
|---|---|---|---|---|--------------------------------------------|
-| Frontend | 16 core + | 64GB + | SSD or RAID card, 100GB + * | 10,000 Mbp network card | 1-3* |
-| Backend | 16 core + | 64GB + | SSD or SATA, 100G + * | 10-100 Mbp network card | 3 * |
+| Frontend | 16 core + | 64GB + | SSD or RAID card, 100GB + * | 10,000 Mbp network card | 1-3* |
+| Backend | 16 core + | 64GB + | SSD or SATA, 100G + * | 10-100 Mbp network card | 3 * |
> Note 1:
>
@@ -98,7 +98,7 @@ Both ext4 and xfs file systems are supported.
> Note 2: Number of FE nodes
>
> 1. FE nodes are divided into Followers and Observers based on their roles. (Leader is an elected role in the Follower group, hereinafter referred to as Follower, too.)
-> 2. The number of FE nodes should be at least 1 (1 Follower). If you deploy 1 Follower and 1 Observer, you can achieve high read availability; if you deploy 3 Followers, you can achieve high read-write availability (HA).
+> 2. The number of FE nodes should be at least 1 (1 Follower). If you deploy 1 Follower and 1 Observer, you can achieve high read availability; if you deploy 3 Followers, you can achieve high read-write availability (HA).
> 3. Although multiple BEs can be deployed on one machine, **only one instance** is recommended to be deployed, and **only one FE** can be deployed at the same time. If 3 copies of data are required, at least 3 machines are required to deploy a BE instance (instead of 1 machine deploying 3 BE instances). **The clocks of the servers where multiple FEs are located must be consistent (up to 5 seconds of clock deviation is allowed)**.
> 4. According to past experience, for business that requires high cluster availability (e.g. online service providers), we recommend that you deploy 3 Followers and 1-3 Observers; for offline business, we recommend that you deploy 1 Follower and 1-3 Observers.
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@doris.apache.org
For additional commands, e-mail: commits-help@doris.apache.org