This is an automated email from the ASF dual-hosted git repository.
nic pushed a commit to branch document
in repository https://gitbox.apache.org/repos/asf/kylin.git
The following commit(s) were added to refs/heads/document by this push:
new 28481de Fix quick start document display problems
28481de is described below
commit 28481de356d1cfd5b06964b72191cd5d51b926a9
Author: yaqian.zhang <598593...@qq.com>
AuthorDate: Mon Apr 27 17:30:18 2020 +0800
Fix quick start document display problems
---
website/_docs/gettingstarted/quickstart.cn.md | 24 ++++++++++++++++++++++++
website/_docs/gettingstarted/quickstart.md | 16 ++++++++++++++++
2 files changed, 40 insertions(+)
diff --git a/website/_docs/gettingstarted/quickstart.cn.md
b/website/_docs/gettingstarted/quickstart.cn.md
index 6aa0853..18274dd 100644
--- a/website/_docs/gettingstarted/quickstart.cn.md
+++ b/website/_docs/gettingstarted/quickstart.cn.md
@@ -27,13 +27,16 @@ since: v0.6.x
我们已将面向用户的 Kylin 镜像上传至 docker 仓库，用户无需在本地构建镜像，只需要安装docker，就可以体验kylin的一键安装。
#### step1、首先执行以下命令从 docker 仓库 pull 镜像：
+
```
docker pull apachekylin/apache-kylin-standalone:3.0.1
```
+
此处的镜像包含的是kylin最新Release版本kylin
3.0.1。由于该镜像中包含了所有kylin依赖的大数据组件，所以拉取镜像需要的时间较长，请耐心等待。Pull成功后显示如下：
#### step2、执行以下命令来启动容器：
+
```
docker run -d \
-m 8G \
@@ -45,6 +48,7 @@ docker run -d \
-p 16010:16010 \
apachekylin/apache-kylin-standalone:3.0.1
```
+
容器会很快启动，由于容器内指定端口已经映射到本机端口，可以直接在本机浏览器中打开各个服务的页面，如：
- Kylin 页面：http://127.0.0.1:7070/kylin/
@@ -62,6 +66,7 @@ apachekylin/apache-kylin-standalone:3.0.1
并自动运行 $KYLIN_HOME/bin/sample.sh及在 Kafka 中创建 kylin_streaming_topic topic 并持续向该
topic 中发送数据。这是为了让用户启动容器后，就能体验以批和流的方式的方式构建 Cube 并进行查询。
用户可以通过docker exec命令进入容器，容器内相关环境变量如下：
+
```
JAVA_HOME=/home/admin/jdk1.8.0_141
HADOOP_HOME=/home/admin/hadoop-2.7.0
@@ -71,6 +76,7 @@ HBASE_HOME=/home/admin/hbase-1.1.2
HIVE_HOME=/home/admin/apache-hive-1.2.1-bin
KYLIN_HOME=/home/admin/apache-kylin-3.0.0-alpha2-bin-hbase1x
```
+
使用ADMIN/KYLIN的用户名和密码组合登陆Kylin后，用户可以使用sample
cube来体验cube的构建和查询，也可以按照下面“基于hadoop环境安装使用kylin”中从step8之后的教程来创建并查询属于自己的model和cube。
### 二、 基于hadoop环境安装使用kylin
@@ -100,13 +106,16 @@ CentOS 6.5+ 或Ubuntu 16.0.4+
#### step1、下载kylin压缩包
从[Apache Kylin Download
Site](https://kylin.apache.org/download/)下载一个适用于你的Hadoop版本的二进制文件。目前最新Release版本是kylin
3.0.1和kylin 2.6.5，其中3.0版本支持实时摄入数据进行预计算的功能。以CDH 5.的hadoop环境为例，可以使用如下命令行下载kylin
3.0.0：
+
```
cd /usr/local/
wget
http://apache.website-solution.net/kylin/apache-kylin-3.0.0/apache-kylin-3.0.0-bin-cdh57.tar.gz
```
+
#### step2、解压kylin
解压下载得到的kylin压缩包，并配置环境变量KYLIN_HOME指向解压目录：
+
```
tar -zxvf apache-kylin-3.0.0-bin-cdh57.tar.gz
cd apache-kylin-3.0.0-bin-cdh57
@@ -116,30 +125,39 @@ export KYLIN_HOME=`pwd`
#### step3、下载SPARK
由于kylin启动时会对SPARK环境进行检查，所以你需要设置SPARK_HOME指向自己的spark安装路径：
+
```
export SPARK_HOME=/path/to/spark
```
+
如果您没有已经下载好的Spark环境，也可以使用kylin自带脚本下载spark:
+
```
$KYLIN_HOME/bin/download-spark.sh
```
+
脚本会将解压好的spark放在$KYLIN_HOME目录下，如果系统中没有设置SPARK_HOME，启动kylin时会自动找到$KYLIN_HOME目录下的spark。
#### step4、环境检查
Kylin 运行在 Hadoop 集群上，对各个组件的版本、访问权限及 CLASSPATH 等都有一定的要求，为了避免遇到各种环境问题，您可以执行
+
```
$KYLIN_HOME/bin/check-env.sh
```
+
来进行环境检测，如果您的环境存在任何的问题，脚本将打印出详细报错信息。如果没有报错信息，代表您的环境适合 Kylin 运行。
#### step5、启动kylin
运行如下命令来启动kylin：
+
```
$KYLIN_HOME/bin/kylin.sh start
```
+
如果启动成功，命令行的末尾会输出如下内容：
+
```
A new Kylin instance is started by root. To stop it, run 'kylin.sh stop'
Check the log at /usr/local/apache-kylin-3.0.0-bin-cdh57/logs/kylin.log
@@ -157,19 +175,25 @@ Kylin 启动后您可以通过浏览器 http://<hostname>:port/kylin 进行访
Kylin提供了一个创建样例Cube的脚本，以供用户快速体验Kylin。
在命令行运行：
+
```
$KYLIN_HOME/bin/sample.sh
```
+
完成后登陆kylin，点击System->Configuration->Reload Metadata来重载元数据
元数据重载完成后你可以在左上角的Project中看到一个名为learn_kylin的项目，它包含kylin_sales_cube和kylin_streaming_cube,
它们分别为batch cube和streaming cube，你可以直接对kylin_sales_cube进行构建，构建完成后就可以查询。
对于kylin_streaming_cube，需要设置KAFKA_HOME指向你的kafka安装目录:
+
```
export KAFKA_HOME=/path/to/kafka
```
+
然后执行
+
```
${KYLIN_HOME}/bin/sample-streaming.sh
```
+
该脚本会在 localhost:9092 broker 中创建名为 kylin_streaming_topic 的 Kafka
Topic，它也会每秒随机发送 100 条 messages 到
kylin_streaming_topic，然后你可以对kylin_streaming_cube进行构建。
关于sample cube，可以参考[Sample Cube](/cn/docs/tutorial/kylin_sample.html)。
diff --git a/website/_docs/gettingstarted/quickstart.md
b/website/_docs/gettingstarted/quickstart.md
index 6a85427..161696e 100644
--- a/website/_docs/gettingstarted/quickstart.md
+++ b/website/_docs/gettingstarted/quickstart.md
@@ -28,15 +28,18 @@ We have uploaded the user facing Kylin image to the Docker
repository. Users do
#### Step1
First, execute the following command to pull the image from the Docker
repository:
+
```
docker pull apachekylin/apache-kylin-standalone:3.0.1
```
+
The image here contains the latest version of Kylin: Kylin v3.0.1. This image
contains all of the big data components that Kylin depends on, so it takes a
long time to pull the image – please be patient. After the pull is successful,
it is displayed as follows:
#### Step2
Execute the following command to start the container:
+
```
docker run -d \
-m 8G \
@@ -48,6 +51,7 @@ docker run -d \
-p 16010:16010 \
apachekylin/apache-kylin-standalone:3.0.1
```
+
The container will start shortly. Since the specified port in the container
has been mapped to the local port, you can directly open the pages of each
service in the local browser, such as:
- Kylin Page: http://127.0.0.1:7070/kylin/
- HDFS NameNode Page: http://127.0.0.1:50070
@@ -107,6 +111,7 @@ When your environment meets the above prerequisites, you
can install and start u
#### Step1. Download the Kylin Archive
Download a binary for your version of Hadoop from [Apache Kylin Download
Site](https://kylin.apache.org/download/). Currently, the latest versions are
Kylin 3.0.1 and Kylin 2.6.5, of which, version 3.0 supports the function of
ingesting data in real time for pre-calculation. If your Hadoop environment is
CDH 5.7, you can download Kylin 3.0.0 using the following command line:
+
```
cd /usr/local/
wget
http://apache.website-solution.net/kylin/apache-kylin-3.0.0/apache-kylin-3.0.0-bin-cdh57.tar.gz
@@ -114,6 +119,7 @@ wget
http://apache.website-solution.net/kylin/apache-kylin-3.0.0/apache-kylin-3.
#### Step2. Extract Kylin
Extract the downloaded Kylin archive and configure the environment variable
KYLIN_HOME to point to the extracted directory:
+
```
tar -zxvf apache-kylin-3.0.0-bin-cdh57.tar.gz
cd apache-kylin-3.0.0-bin-cdh57
@@ -122,13 +128,17 @@ export KYLIN_HOME=`pwd`
#### Step3. Download Spark
Since Kylin checks the Spark environment when it starts, you need to set
SPARK_HOME:
+
```
export SPARK_HOME=/path/to/spark
```
+
If you don’t have a Spark environment already downloaded, you can also
download Spark using Kylin’s own script:
+
```
$KYLIN_HOME/bin/download-spark.sh
```
+
The script will place the decompressed Spark in the $ KYLIN_HOME directory. If
SPARK_HOME is not set in the system, the Spark in the $ KYLIN_HOME directory
will be found automatically when Kylin is started.
#### Step4. Environmental Inspection
@@ -138,15 +148,19 @@ The script will print out detailed error messages if any
errors are identified.
#### Step5. Start Kylin
Run
+
```
$KYLIN_HOME/bin/kylin.sh
```
+
Start script to start Kylin. If the startup is successful, the following will
be output at the end of the command line:
+
```
A new Kylin instance is started by root. To stop it, run 'kylin.sh stop'
Check the log at /usr/local/apache-kylin-3.0.0-bin-cdh57/logs/kylin.log
Web UI is at http://<hostname>:7070/kylin
```
+
The default port started by Kylin is 7070. You can use $
KYLIN_HOME/bin/kylin-port-replace-util.sh set number to modify the port. The
modified port is 7070 + number.
#### Step6. Visit Kylin
@@ -155,9 +169,11 @@ The initial username and password are ADMIN/KYLIN. After
the server starts, you
#### Step7. Create Sample Cube
Kylin provides a script to create a sample cube for users to quickly
experience Kylin. Run from the command line:
+
```
$KYLIN_HOME/bin/sample.sh
```
+
After completing, log in to Kylin, click System -> Configuration -> Reload
Metadata to reload the metadata.
After the metadata is reloaded, you can see a project named learn_kylin in
Project in the upper left corner.
