This is an automated email from the ASF dual-hosted git repository. shaofengshi pushed a commit to branch document in repository https://gitbox.apache.org/repos/asf/kylin.git
commit a2fa439a6bc5aa4a0ba0df0ed37f15f61e917212 Author: DDDQ <[email protected]> AuthorDate: Wed Oct 24 23:09:19 2018 +0800 modified installation guide --- website/_docs/install/index.cn.md | 106 +++++++++++++++++++++----------------- 1 file changed, 59 insertions(+), 47 deletions(-) diff --git a/website/_docs/install/index.cn.md b/website/_docs/install/index.cn.md index c6931c3..dc9374f 100644 --- a/website/_docs/install/index.cn.md +++ b/website/_docs/install/index.cn.md @@ -5,7 +5,7 @@ categories: install permalink: /cn/docs/install/index.html --- -## 软件要求 +### 软件要求 * Hadoop: 2.7+, 3.1+ (since v2.5) * Hive: 0.13 - 1.2.1+ @@ -17,63 +17,75 @@ permalink: /cn/docs/install/index.html 在 Hortonworks HDP 2.2 - 2.6 and 3.0, Cloudera CDH 5.7 - 5.11 and 6.0, AWS EMR 5.7 - 5.10, Azure HDInsight 3.5 - 3.6 上测试通过。 -出于试用和开发的目的，我们建议您使用集成的 sandbox 来试用 Kylin，比如 [HDP sandbox](http://hortonworks.com/products/hortonworks-sandbox/)，且其要保证 10 GB memory。我们建议您在 Virtual Box settings 中使用桥接模式代替 NAT 模式。 +我们建议您使用集成的 sandbox 来试用 Kylin 或进行开发，比如 [HDP sandbox](http://hortonworks.com/products/hortonworks-sandbox/)，且要保证其有至少 10 GB 内存。在配置沙箱时，我们推荐您使用 Bridged Adapter 模型替代 NAT 模型。 -## 硬件要求 +### 硬件要求 -运行 Kylin 的服务器的最低的配置为 4 core CPU, 16 GB memory 和 100 GB disk。 对于高负载的场景，建议使用 24 core CPU, 64 GB memory 或更高的配置。 +运行 Kylin 的服务器的最低配置为 4 core CPU，16 GB 内存和 100 GB 磁盘。 对于高负载的场景，建议使用 24 core CPU，64 GB 内存或更高的配置。 -## Hadoop 环境 +### Hadoop 环境 -Kylin 依赖于 Hadoop 集群处理大量的数据集。您需要准备一个配置好 HDFS, YARN, MapReduce, Hive, Hbase, Zookeeper 和其他服务的 Hadoop 集群供 Kylin 运行。最常见的是在 Hadoop client machine 上安装 Kylin，这样 Kylin 可以通过（`hive`, `hbase`, `hadoop`, 以及其他的）命令行与 Hadoop 进行通信。 +Kylin 依赖于 Hadoop 集群处理大量的数据集。您需要准备一个配置好 HDFS，YARN，MapReduce,，Hive， HBase，Zookeeper 和其他服务的 Hadoop 集群供 Kylin 运行。 +Kylin 可以在 Hadoop 集群的任意节点上启动。方便起见，您可以在 master 节点上运行 Kylin。但为了更好的稳定性，我们建议您将 Kylin 部署在一个干净的 Hadoop client 节点上，该节点上 Hive，HBase，HDFS 等命令行已安装好且 client 配置（如 `core-site.xml`，`hive-site.xml`，`hbase-site.xml`及其他）也已经合理的配置且其可以自动和其它节点同步。 -Kylin 可以在 Hadoop 集群的任意节点上启动。方便起见，您可以在 master 节点上运行 Kylin。但为了更好的稳定性，我们建议您将其部署在一个干净的 Hadoop client 节点上，该节点上 `hive`, `hbase`, `hadoop`, `hdfs` 命令行已安装好且 client 配置如（core-site.xml, hive-site.xml, hbase-site.xml, 及其他）也已经合理的配置且其可以自动和其它节点同步。运行 Kylin 的 Linux 账户要有访问 Hadoop 集群的权限，包括 create/write HDFS 文件夹, hive 表, hbase 表 和 提交 MR jobs 的权限。 +运行 Kylin 的 Linux 账户要有访问 Hadoop 集群的权限，包括创建/写入 HDFS 文件夹，Hive 表， HBase 表和提交 MapReduce 任务的权限。 -## Kylin 安装 +### Kylin 安装 - * 从最新的 Apache 下载网站下载一个适用于您 Hadoop 版本的 Kylin binaries 文件。例如，来源于 US 适用于 HBase 1.x 的 Kylin 2.3.1: -{% highlight Groff markup %} -cd /usr/local -wget http://www-us.apache.org/dist/kylin/apache-kylin-2.3.1/apache-kylin-2.3.1-hbase1x-bin.tar.gz -{% endhighlight %} - * 解压 tar 包，然后配置环境变量 KYLIN_HOME 指向 Kylin 文件夹 -{% highlight Groff markup %} -tar -zxvf apache-kylin-2.3.1-hbase1x-bin.tar.gz -cd apache-kylin-2.3.1-bin +1. 从 [Apache Kylin下载网站](https://kylin.apache.org/download/) 下载一个适用于您 Hadoop 版本的二进制文件。例如，适用于 HBase 1.x 的 Kylin 2.5.0 + +```shell +cd /usr/local/ +wget http://mirror.bit.edu.cn/apache/kylin/apache-kylin-2.5.0/apache-kylin-2.5.0-bin-hbase1x.tar.gz +``` + +2. 解压 tar 包，配置环境变量 `$KYLIN_HOME` 指向 Kylin 文件夹 + +```shell +tar -zxvf apache-kylin-2.5.0-bin-hbase1x.tar.gz +cd apache-kylin-2.5.0-bin-hbase1x export KYLIN_HOME=`pwd` -{% endhighlight %} - * 确保用户有权限在 shell 中运行 hadoop, hive 和 hbase cmd。如果您不确定，您可以运行 `$KYLIN_HOME/bin/check-env.sh` 脚本，如果您的环境有任何的问题，它会将打印出详细的信息。如果没有 error，意味着环境没问题。 -{% highlight Groff markup %} --bash-4.1# $KYLIN_HOME/bin/check-env.sh -Retrieving hadoop conf dir... -KYLIN_HOME is set to /usr/local/apache-kylin-2.3.1-bin --bash-4.1# -{% endhighlight %} - * 运行 `$KYLIN_HOME/bin/kylin.sh start` 脚本来启动 Kylin，服务器启动后，您可以通过查看 `$KYLIN_HOME/logs/kylin.log` 获得运行时日志。 -{% highlight Groff markup %} --bash-4.1# $KYLIN_HOME/bin/kylin.sh start -Retrieving hadoop conf dir... -KYLIN_HOME is set to /usr/local/apache-kylin-2.3.1-bin -Retrieving hive dependency... -Retrieving hbase dependency... +``` + + +### 检查运行环境 + +Kylin 运行在 Hadoop 集群上，对各个组件的版本、访问权限及 CLASSPATH 等都有一定的要求，为了避免遇到各种环境问题，您可以运行 `$KYLIN_HOME/bin/check-env.sh` 脚本来进行环境检测，如果您的环境存在任何的问题，脚本将打印出详细报错信息。如果没有报错信息，代表您的环境适合 Kylin 运行。 + + +### 启动 Kylin + +运行 `$KYLIN_HOME/bin/kylin.sh start` 脚本来启动 Kylin，界面输出如下： + +``` Retrieving hadoop conf dir... -Retrieving kafka dependency... -Retrieving Spark dependency... -... +KYLIN_HOME is set to /usr/local/apache-kylin-2.5.0-bin-hbase1x +...... A new Kylin instance is started by root. To stop it, run 'kylin.sh stop' -Check the log at /usr/local/apache-kylin-2.3.1-bin/logs/kylin.log +Check the log at /usr/local/apache-kylin-2.5.0-bin-hbase1x/logs/kylin.log Web UI is at http://<hostname>:7070/kylin --bash-4.1# -{% endhighlight %} - * Kylin 启动后您可以通过浏览器 <http://hostname:7070/kylin> 查看。初始用户名和密码是 ADMIN/KYLIN。 - * 运行 `$KYLIN_HOME/bin/kylin.sh stop` 脚本，停止 Kylin。 -{% highlight Groff markup %} --bash-4.1# $KYLIN_HOME/bin/kylin.sh stop -Retrieving hadoop conf dir... -KYLIN_HOME is set to /usr/local/apache-kylin-2.3.1-bin -Stopping Kylin: 7014 -Kylin with pid 7014 has been stopped. -{% endhighlight %} +``` + + +### 使用 Kylin + +Kylin 启动后您可以通过浏览器 `http://<hostname>:7070/kylin` 进行访问。 +其中 `<hostname>` 为具体的机器名、IP 地址或域名，默认端口为 7070。 +初始用户名和密码是 `ADMIN/KYLIN`。 +服务器启动后，您可以通过查看 `$KYLIN_HOME/logs/kylin.log` 获得运行时日志。 +### 停止 Kylin + +运行 `$KYLIN_HOME/bin/kylin.sh stop` 脚本来停止 Kylin，界面输出如下： + +``` +Retrieving hadoop conf dir... +KYLIN_HOME is set to /usr/local/apache-kylin-2.5.0-bin-hbase1x +Stopping Kylin: 25964 +Stopping in progress. Will check after 2 secs again... +Kylin with pid 25964 has been stopped. +``` + +您可以运行 `ps -ef | grep kylin` 来查看 Kylin 进程是否已停止。 \ No newline at end of file
