website/_docs/install/advance_settings.cn.md - kylin - Git at Google

 ---
 layout: docs-cn
 title: "高级设置"
 categories: install
 permalink: /cn/docs/install/advance_settings.html
 ---

 ## 在 Cube 级别重写默认的 kylin.properties
 `conf/kylin.properties` 里有许多的参数，控制/影响着 Kylin 的行为；大多数参数是全局配置的，例如 security 或 job 相关的参数；有一些是 Cube 相关的；这些 Cube 相关的参数可以在任意 Cube 级别进行自定义。对应的 GUI 页面是 Cube 创建的 "重写配置" 步骤所示的页面，如下图所示.

 ![]( /images/install/overwrite_config_v2.png)

 ## 在 Cube 级别重写默认的 Spark conf 值

  Spark 的配置是在 `conf/kylin.properties` 中管理，前缀为 `kylin.engine.spark-conf.`。例如，如果您想要使用 job queue "myQueue" 运行 Spark，设置 "kylin.engine.spark-conf.spark.yarn.queue=myQueue" 会让 Spark 在提交应用时获取 "spark.yarn.queue=myQueue"。参数可以在 Cube 级别进行配置，将会覆盖 `conf/kylin.properties` 中的默认值。

 ## 分配更多内存给 Kylin 实例

 打开 `bin/setenv.sh`，这里有两个 `KYLIN_JVM_SETTINGS` 环境变量的样例设置；默认设置较小 (最大为 4GB)，您可以注释它然后取消下一行的注释来给其分配 16GB:

 {% highlight Groff markup %}
 export KYLIN_JVM_SETTINGS="-Xms1024M -Xmx4096M -Xss1024K -XX:MaxPermSize=128M -verbose:gc -XX:+PrintGCDetails -XX:+PrintGCDateStamps -Xloggc:$KYLIN_HOME/logs/kylin.gc.$$ -XX:+UseGCLogFileRotation -XX:NumberOfGCLogFiles=10 -XX:GCLogFileSize=64M"
 # export KYLIN_JVM_SETTINGS="-Xms16g -Xmx16g -XX:MaxPermSize=512m -XX:NewSize=3g -XX:MaxNewSize=3g -XX:SurvivorRatio=4 -XX:+CMSClassUnloadingEnabled -XX:+CMSParallelRemarkEnabled -XX:+UseConcMarkSweepGC -XX:+CMSIncrementalMode -XX:CMSInitiatingOccupancyFraction=70 -XX:+DisableExplicitGC -XX:+HeapDumpOnOutOfMemoryError"
 {% endhighlight %}

 ## 启用多个任务引擎
 从 2.0 开始, Kylin 支持多个任务引擎一起运行，相比于默认单任务引擎的配置，多引擎可以保证任务构建的高可用。

 使用多任务引擎，你可以在多个 Kylin 节点上配置它的角色为 `job` 或 `all`。为了避免它们之间产生竞争，需要启用分布式任务锁，请在 `kylin.properties` 里配置：

 ```
 kylin.job.scheduler.default=2
 kylin.job.lock=org.apache.kylin.storage.hbase.util.ZookeeperJobLock
 ```
 并记得将所有任务和查询节点的地址注册到 `kylin.server.cluster-servers`.

 ## 支持 LDAP 或 SSO authentication

 查看 [How to Enable Security with LDAP and SSO](../howto/howto_ldap_and_sso.html)


 ## 支持邮件通知

 Kylin 可以在 job 完成/失败的时候发送邮件通知；编辑 `conf/kylin.properties`，设置如下参数使其生效:
 {% highlight Groff markup %}
 mail.enabled=true
 mail.host=your-smtp-server
 mail.username=your-smtp-account
 mail.password=your-smtp-pwd
 mail.sender=your-sender-address
 kylin.job.admin.dls=adminstrator-address
 {% endhighlight %}

 重启 Kylin 服务器使其生效。设置 `mail.enabled` 为 `false` 令其失效。

 所有的 jobs 管理员都会收到通知。建模者和分析师需要将邮箱填写在 cube 创建的第一页的 "Notification List" 中，然后即可收到关于该 cube 的通知。


 ## 支持 MySQL 作为 Kylin metadata 的存储

 Kylin 支持 MySQL 作为 metadata 的存储；为了使该功能生效，您需要执行以下步骤：

 * 安装 MySQL 服务，例如 v5.1.17；
 * 下载并拷贝 MySQL JDBC connector "mysql-connector-java-<version>.jar" 到 $KYLIN_HOME/ext 目录（如没有该目录请自行创建）
 * 在 MySQL 中新建一个专为 Kylin 元数据的数据库，例如 kylin_metadata;
 * 编辑 `conf/kylin.properties`，配置以下参数:

 {% highlight Groff markup %}
 kylin.metadata.url={your_metadata_tablename}@jdbc,url=jdbc:mysql://localhost:3306/kylin,username={your_username},password={your_password}
 kylin.metadata.jdbc.dialect=mysql
 kylin.metadata.jdbc.json-always-small-cell=true
 kylin.metadata.jdbc.small-cell-meta-size-warning-threshold=100mb
 kylin.metadata.jdbc.small-cell-meta-size-error-threshold=1gb
 kylin.metadata.jdbc.max-cell-size=1mb
 {% endhighlight %}

 `kylin.metadata.url` 配置项中可以添加更多JDBC 连接的配置项；其中 `url`, `username`，和 `password` 为必须配置项。其余项若不配置将使用默认配置项：

 {% highlight Groff markup %}
 url: JDBC connection URL
 username: JDBC 的用户名
 password: JDBC 的密码，如果选择了加密，那这里请写加密后的密码
 driverClassName: JDBC 的 driver 类名，默认值为 com.mysql.jdbc.Driver
 maxActive: 最大数据库连接数，默认值为 5
 maxIdle: 最大等待中的连接数量，默认值为 5
 maxWait: 最大等待连接毫秒数，默认值为 1000
 removeAbandoned: 是否自动回收超时连接，默认值为 true
 removeAbandonedTimeout: 超时时间秒数，默认为 300
 passwordEncrypted: 是否对 JDBC 密码进行加密，默认为 false
 {% endhighlight %}

 你可以加密JDBC 连接密码：
 {% highlight Groff markup %}
 cd $KYLIN_HOME/tomcat/webapps/kylin/WEB-INF/lib
 java -classpath kylin-server-base-\<version\>.jar:kylin-core-common-\<version\>.jar:spring-beans-4.3.10.RELEASE.jar:spring-core-4.3.10.RELEASE.jar:commons-codec-1.7.jar org.apache.kylin.rest.security.PasswordPlaceholderConfigurer AES <your_password>
 {% endhighlight %}

 *启动 Kylin
	---
	layout: docs-cn
	title: "高级设置"
	categories: install
	permalink: /cn/docs/install/advance_settings.html
	---

	## 在 Cube 级别重写默认的 kylin.properties
	`conf/kylin.properties` 里有许多的参数，控制/影响着 Kylin 的行为；大多数参数是全局配置的，例如 security 或 job 相关的参数；有一些是 Cube 相关的；这些 Cube 相关的参数可以在任意 Cube 级别进行自定义。对应的 GUI 页面是 Cube 创建的 "重写配置" 步骤所示的页面，如下图所示.

	![]( /images/install/overwrite_config_v2.png)

	## 在 Cube 级别重写默认的 Spark conf 值

	Spark 的配置是在 `conf/kylin.properties` 中管理，前缀为 `kylin.engine.spark-conf.`。例如，如果您想要使用 job queue "myQueue" 运行 Spark，设置 "kylin.engine.spark-conf.spark.yarn.queue=myQueue" 会让 Spark 在提交应用时获取 "spark.yarn.queue=myQueue"。参数可以在 Cube 级别进行配置，将会覆盖 `conf/kylin.properties` 中的默认值。

	## 分配更多内存给 Kylin 实例

	打开 `bin/setenv.sh`，这里有两个 `KYLIN_JVM_SETTINGS` 环境变量的样例设置；默认设置较小 (最大为 4GB)，您可以注释它然后取消下一行的注释来给其分配 16GB:

	{% highlight Groff markup %}
	export KYLIN_JVM_SETTINGS="-Xms1024M -Xmx4096M -Xss1024K -XX:MaxPermSize=128M -verbose:gc -XX:+PrintGCDetails -XX:+PrintGCDateStamps -Xloggc:$KYLIN_HOME/logs/kylin.gc.$$ -XX:+UseGCLogFileRotation -XX:NumberOfGCLogFiles=10 -XX:GCLogFileSize=64M"
	# export KYLIN_JVM_SETTINGS="-Xms16g -Xmx16g -XX:MaxPermSize=512m -XX:NewSize=3g -XX:MaxNewSize=3g -XX:SurvivorRatio=4 -XX:+CMSClassUnloadingEnabled -XX:+CMSParallelRemarkEnabled -XX:+UseConcMarkSweepGC -XX:+CMSIncrementalMode -XX:CMSInitiatingOccupancyFraction=70 -XX:+DisableExplicitGC -XX:+HeapDumpOnOutOfMemoryError"
	{% endhighlight %}

	## 启用多个任务引擎
	从 2.0 开始, Kylin 支持多个任务引擎一起运行，相比于默认单任务引擎的配置，多引擎可以保证任务构建的高可用。

	使用多任务引擎，你可以在多个 Kylin 节点上配置它的角色为 `job` 或 `all`。为了避免它们之间产生竞争，需要启用分布式任务锁，请在 `kylin.properties` 里配置：

	```
	kylin.job.scheduler.default=2
	kylin.job.lock=org.apache.kylin.storage.hbase.util.ZookeeperJobLock
	```
	并记得将所有任务和查询节点的地址注册到 `kylin.server.cluster-servers`.

	## 支持 LDAP 或 SSO authentication

	查看 [How to Enable Security with LDAP and SSO](../howto/howto_ldap_and_sso.html)


	## 支持邮件通知

	Kylin 可以在 job 完成/失败的时候发送邮件通知；编辑 `conf/kylin.properties`，设置如下参数使其生效:
	{% highlight Groff markup %}
	mail.enabled=true
	mail.host=your-smtp-server
	mail.username=your-smtp-account
	mail.password=your-smtp-pwd
	mail.sender=your-sender-address
	kylin.job.admin.dls=adminstrator-address
	{% endhighlight %}

	重启 Kylin 服务器使其生效。设置 `mail.enabled` 为 `false` 令其失效。

	所有的 jobs 管理员都会收到通知。建模者和分析师需要将邮箱填写在 cube 创建的第一页的 "Notification List" 中，然后即可收到关于该 cube 的通知。


	## 支持 MySQL 作为 Kylin metadata 的存储

	Kylin 支持 MySQL 作为 metadata 的存储；为了使该功能生效，您需要执行以下步骤：

	* 安装 MySQL 服务，例如 v5.1.17；
	* 下载并拷贝 MySQL JDBC connector "mysql-connector-java-<version>.jar" 到 $KYLIN_HOME/ext 目录（如没有该目录请自行创建）
	* 在 MySQL 中新建一个专为 Kylin 元数据的数据库，例如 kylin_metadata;
	* 编辑 `conf/kylin.properties`，配置以下参数:

	{% highlight Groff markup %}
	kylin.metadata.url={your_metadata_tablename}@jdbc,url=jdbc:mysql://localhost:3306/kylin,username={your_username},password={your_password}
	kylin.metadata.jdbc.dialect=mysql
	kylin.metadata.jdbc.json-always-small-cell=true
	kylin.metadata.jdbc.small-cell-meta-size-warning-threshold=100mb
	kylin.metadata.jdbc.small-cell-meta-size-error-threshold=1gb
	kylin.metadata.jdbc.max-cell-size=1mb
	{% endhighlight %}

	`kylin.metadata.url` 配置项中可以添加更多JDBC 连接的配置项；其中 `url`, `username`，和 `password` 为必须配置项。其余项若不配置将使用默认配置项：

	{% highlight Groff markup %}
	url: JDBC connection URL
	username: JDBC 的用户名
	password: JDBC 的密码，如果选择了加密，那这里请写加密后的密码
	driverClassName: JDBC 的 driver 类名，默认值为 com.mysql.jdbc.Driver
	maxActive: 最大数据库连接数，默认值为 5
	maxIdle: 最大等待中的连接数量，默认值为 5
	maxWait: 最大等待连接毫秒数，默认值为 1000
	removeAbandoned: 是否自动回收超时连接，默认值为 true
	removeAbandonedTimeout: 超时时间秒数，默认为 300
	passwordEncrypted: 是否对 JDBC 密码进行加密，默认为 false
	{% endhighlight %}

	你可以加密JDBC 连接密码：
	{% highlight Groff markup %}
	cd $KYLIN_HOME/tomcat/webapps/kylin/WEB-INF/lib
	java -classpath kylin-server-base-\<version\>.jar:kylin-core-common-\<version\>.jar:spring-beans-4.3.10.RELEASE.jar:spring-core-4.3.10.RELEASE.jar:commons-codec-1.7.jar org.apache.kylin.rest.security.PasswordPlaceholderConfigurer AES <your_password>
	{% endhighlight %}

	*启动 Kylin