Repository: kylin Updated Branches: refs/heads/document bda10ddc3 -> 85b5287b4
announce 2.0.0 beta2 Project: http://git-wip-us.apache.org/repos/asf/kylin/repo Commit: http://git-wip-us.apache.org/repos/asf/kylin/commit/85b5287b Tree: http://git-wip-us.apache.org/repos/asf/kylin/tree/85b5287b Diff: http://git-wip-us.apache.org/repos/asf/kylin/diff/85b5287b Branch: refs/heads/document Commit: 85b5287b4b9d20b8d9636a258c7f9d4bd3380809 Parents: bda10dd Author: Yang Li <liy...@apache.org> Authored: Sat Apr 8 22:12:07 2017 +0800 Committer: Yang Li <liy...@apache.org> Committed: Sat Apr 8 22:12:07 2017 +0800 ---------------------------------------------------------------------- website/_docs20/howto/howto_upgrade.md | 27 +++++++++++++++++---------- website/download/index.cn.md | 13 +++++++------ website/download/index.md | 13 +++++++------ 3 files changed, 31 insertions(+), 22 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/kylin/blob/85b5287b/website/_docs20/howto/howto_upgrade.md ---------------------------------------------------------------------- diff --git a/website/_docs20/howto/howto_upgrade.md b/website/_docs20/howto/howto_upgrade.md index 811b6c6..cab1903 100644 --- a/website/_docs20/howto/howto_upgrade.md +++ b/website/_docs20/howto/howto_upgrade.md @@ -6,24 +6,31 @@ permalink: /docs20/howto/howto_upgrade.html since: v1.5.1 --- -Running as a Hadoop client, Apache Kylin's metadata and Cube data are persistended in Hadoop (HBase and HDFS), so the upgrade is relatively easy and user doesn't need worry about data loss. The upgrade can be performed in the following steps: - -* Download the new Apache Kylin binary package for your Hadoop version from Kylin's download page; -* Uncompress the new version Kylin package to a new folder, e.g, /usr/local/kylin/apache-kylin-1.6.0/ (directly overwrite old instance is not recommended); -* Copy the configuration files (`$KYLIN_HOME/conf/*`) from old instance (e.g /usr/local/kylin/apache-kylin-1.5.4/) to the new instance's `conf` folder if you have customized configurations; It is recommended to do a compare and merge since there might be new parameters introduced. If you have modified tomcat configuration ($KYLIN_HOME/tomcat/conf/), also remember to do the same. -* Stop the current Kylin instance with `./bin/kylin.sh stop`; -* Set the `KYLIN_HOME` env variable to the new instance's installation folder. If you have set `KYLIN_HOME` in `~/.bash_profile` or other scripts, remember to update them as well. -* Start the new Kylin instance with `$KYLIN_HOME/bin/kylin start`; After be started, login Kylin web to check whether your cubes can be loaded correctly. +Running as a Hadoop client, Apache Kylin's metadata and Cube data are persistended in Hadoop (HBase and HDFS), so the upgrade is relatively easy and user does not need worry about data loss. The upgrade can be performed in the following steps: + +* Download the new Apache Kylin binary package for your Hadoop version from Kylin download page. +* Unpack the new version Kylin package to a new folder, e.g, /usr/local/kylin/apache-kylin-2.0.0/ (directly overwrite old instance is not recommended). +* Merge the old configuration files (`$KYLIN_HOME/conf/*`) into the new ones. It is not recommended to overwrite the new configuration files, although that works in most cases. If you have modified tomcat configuration ($KYLIN_HOME/tomcat/conf/), do the same for it. +* Stop the current Kylin instance with `bin/kylin.sh stop` +* Set the `KYLIN_HOME` env variable to the new installation folder. If you have set `KYLIN_HOME` in `~/.bash_profile` or other scripts, remember to update them as well. +* Start the new Kylin instance with `$KYLIN_HOME/bin/kylin start`. After be started, login Kylin web to check whether your cubes can be loaded correctly. * [Upgrade coprocessor](howto_update_coprocessor.html) to ensure the HBase region servers use the latest Kylin coprocessor. * Verify your SQL queries can be performed successfully. Below are versions specific guides: +## Upgrade from v1.6.0 to v2.0.0 + +Kylin v2.0.0 can read v1.6.0 metadata directly. Please follow the common upgrade steps above. + +Configuration names in `kylin.properties` have changed since v2.0.0. While the old property names still work, it is recommended to use the new property names as they follow [the naming convention](/development/coding_naming_convention.html) and are easier to understand. There is [a mapping from the old properties to the new properties](https://github.com/apache/kylin/blob/2.0.x/core-common/src/main/resources/kylin-backward-compatibility.properties). + ## Upgrade from v1.5.4 to v1.6.0 -Kylin v1.5.4 and v1.6.0 are compitible in metadata; Please follow the common upgrade steps above. + +Kylin v1.5.4 and v1.6.0 are compatible in metadata. Please follow the common upgrade steps above. ## Upgrade from v1.5.3 to v1.5.4 -Kylin v1.5.3 and v1.5.4 are compitible in metadata; Please follow the common upgrade steps above. +Kylin v1.5.3 and v1.5.4 are compatible in metadata. Please follow the common upgrade steps above. ## Upgrade from 1.5.2 to v1.5.3 Kylin v1.5.3 metadata is compitible with v1.5.2, your cubes don't need rebuilt, as usual, some actions need to be performed: http://git-wip-us.apache.org/repos/asf/kylin/blob/85b5287b/website/download/index.cn.md ---------------------------------------------------------------------- diff --git a/website/download/index.cn.md b/website/download/index.cn.md index 52d1794..1ddf5cb 100644 --- a/website/download/index.cn.md +++ b/website/download/index.cn.md @@ -6,16 +6,17 @@ title: ä¸è½½ 1.6.0 æ¯ææ°çåå¸çæ¬ã2.0.0 æ¯ææ°ç beta çæ¬ã æ¨å¯ä»¥æç §è¿äº[æ¥éª¤](https://www.apache.org/info/verification.html) 并使ç¨è¿äº[KEYS](http://kylin.apache.org/KEYS)æ¥éªè¯ä¸è½½æ件çæææ§. -## 2.0.0 beta +## 2.0.0 beta2 -注æ 2.0.0 beta 并ä¸æ¯ä¸ä¸ªæ£å¼åè¡çï¼å®åªæ¯ä¸ä¸ªæ£å¼åè¡åçé¢è§çæ¬ã +注æ 2.0.0 beta2 并ä¸æ¯ä¸ä¸ªæ£å¼åè¡çï¼å®åªæ¯ä¸ä¸ªæ£å¼åè¡åçé¢è§çæ¬ã - è¿æ¯ææ°ç Apache Kylinï¼åè½å æ¬ **Spark æ建å¼æ**ï¼æ¯æ**éªè±æ¨¡å**ï¼å¹¶è½è¿è¡ **TPC-H åºåæµè¯**ã[æ¥çæ´å¤ä¿¡æ¯](/cn/blog/2017/02/25/v2.0.0-beta-ready/)ã -- æºä»£ç : https://github.com/apache/kylin/tree/kylin-2.0.0-beta +- 2.0.0 beta2 æ¯æä»èçæ¬[å¹³æ»å级](/docs20/howto/howto_upgrade.html)ã +- æºä»£ç : https://github.com/apache/kylin/tree/2.0.x - äºè¿å¶å ä¸è½½: - - for HBase 0.98 (includes HDP 2.2, CDH 5.2/5.3) - [apache-kylin-2.0.0-beta-hbase098.tar.gz](https://dist.apache.org/repos/dist/dev/kylin/apache-kylin-2.0.0-beta/apache-kylin-2.0.0-beta-hbase098.tar.gz) \[[asc](https://dist.apache.org/repos/dist/dev/kylin/apache-kylin-2.0.0-beta/apache-kylin-2.0.0-beta-hbase098.tar.gz.asc)\] \[[md5](https://dist.apache.org/repos/dist/dev/kylin/apache-kylin-2.0.0-beta/apache-kylin-2.0.0-beta-hbase098.tar.gz.md5)\] - - for HBase 1.x (includes HDP 2.3/2.4, EMR 5.0) - [apache-kylin-2.0.0-beta-hbase1x.tar.gz](https://dist.apache.org/repos/dist/dev/kylin/apache-kylin-2.0.0-beta/apache-kylin-2.0.0-beta-hbase1x.tar.gz) \[[asc](https://dist.apache.org/repos/dist/dev/kylin/apache-kylin-2.0.0-beta/apache-kylin-2.0.0-beta-hbase1x.tar.gz.asc)\] \[[md5](https://dist.apache.org/repos/dist/dev/kylin/apache-kylin-2.0.0-beta/apache-kylin-2.0.0-beta-hbase1x.tar.gz.md5)\] - - for CDH 5.7/5.8 - [apache-kylin-2.0.0-beta-cdh57.tar.gz](https://dist.apache.org/repos/dist/dev/kylin/apache-kylin-2.0.0-beta/apache-kylin-2.0.0-beta-cdh57.tar.gz) \[[asc](https://dist.apache.org/repos/dist/dev/kylin/apache-kylin-2.0.0-beta/apache-kylin-2.0.0-beta-cdh57.tar.gz.asc)\] \[[md5](https://dist.apache.org/repos/dist/dev/kylin/apache-kylin-2.0.0-beta/apache-kylin-2.0.0-beta-cdh57.tar.gz.md5)\] + - for HBase 0.98 (includes HDP 2.2, CDH 5.2/5.3) - [apache-kylin-2.0.0-beta2-hbase098.tar.gz](https://dist.apache.org/repos/dist/dev/kylin/apache-kylin-2.0.0-beta2/apache-kylin-2.0.0-beta2-hbase098.tar.gz) \[[asc](https://dist.apache.org/repos/dist/dev/kylin/apache-kylin-2.0.0-beta2/apache-kylin-2.0.0-beta2-hbase098.tar.gz.asc)\] \[[md5](https://dist.apache.org/repos/dist/dev/kylin/apache-kylin-2.0.0-beta2/apache-kylin-2.0.0-beta2-hbase098.tar.gz.md5)\] + - for HBase 1.x (includes HDP 2.3/2.4, EMR 5.0) - [apache-kylin-2.0.0-beta2-hbase1x.tar.gz](https://dist.apache.org/repos/dist/dev/kylin/apache-kylin-2.0.0-beta2/apache-kylin-2.0.0-beta2-hbase1x.tar.gz) \[[asc](https://dist.apache.org/repos/dist/dev/kylin/apache-kylin-2.0.0-beta2/apache-kylin-2.0.0-beta2-hbase1x.tar.gz.asc)\] \[[md5](https://dist.apache.org/repos/dist/dev/kylin/apache-kylin-2.0.0-beta2/apache-kylin-2.0.0-beta2-hbase1x.tar.gz.md5)\] + - for CDH 5.7/5.8 - [apache-kylin-2.0.0-beta2-cdh57.tar.gz](https://dist.apache.org/repos/dist/dev/kylin/apache-kylin-2.0.0-beta2/apache-kylin-2.0.0-beta2-cdh57.tar.gz) \[[asc](https://dist.apache.org/repos/dist/dev/kylin/apache-kylin-2.0.0-beta2/apache-kylin-2.0.0-beta2-cdh57.tar.gz.asc)\] \[[md5](https://dist.apache.org/repos/dist/dev/kylin/apache-kylin-2.0.0-beta2/apache-kylin-2.0.0-beta2-cdh57.tar.gz.md5)\] ## 1.6.0 http://git-wip-us.apache.org/repos/asf/kylin/blob/85b5287b/website/download/index.md ---------------------------------------------------------------------- diff --git a/website/download/index.md b/website/download/index.md index 9e84bb0..edf615b 100644 --- a/website/download/index.md +++ b/website/download/index.md @@ -7,16 +7,17 @@ permalink: /download/index.html 1.6.0 is the latest stable release. 2.0.0 is the latest beta. You can verify the download by following these [procedures](https://www.apache.org/info/verification.html) and using these [KEYS](http://kylin.apache.org/KEYS). -## 2.0.0 beta +## 2.0.0 beta2 -Note the 2.0.0 beta is not an official release, but a beta build aims for preview and getting feedback. +Note the 2.0.0 beta2 is not an official release, but a beta build aims for preview and getting feedback. - This is the most powerful build ever that features **Spark Cubing**, **Snowflake Data Model** and runs **TPC-H Benchmark**. [Read more here](/blog/2017/02/25/v2.0.0-beta-ready/). -- Source code is at https://github.com/apache/kylin/tree/kylin-2.0.0-beta +- The beta2 now supports [smooth upgrade](/docs20/howto/howto_upgrade.html) from previous Kylin versions. +- Source code is at https://github.com/apache/kylin/tree/2.0.x - Binary download: - - for HBase 0.98 (includes HDP 2.2, CDH 5.2/5.3) - [apache-kylin-2.0.0-beta-hbase098.tar.gz](https://dist.apache.org/repos/dist/dev/kylin/apache-kylin-2.0.0-beta/apache-kylin-2.0.0-beta-hbase098.tar.gz) \[[asc](https://dist.apache.org/repos/dist/dev/kylin/apache-kylin-2.0.0-beta/apache-kylin-2.0.0-beta-hbase098.tar.gz.asc)\] \[[md5](https://dist.apache.org/repos/dist/dev/kylin/apache-kylin-2.0.0-beta/apache-kylin-2.0.0-beta-hbase098.tar.gz.md5)\] - - for HBase 1.x (includes HDP 2.3/2.4, EMR 5.0) - [apache-kylin-2.0.0-beta-hbase1x.tar.gz](https://dist.apache.org/repos/dist/dev/kylin/apache-kylin-2.0.0-beta/apache-kylin-2.0.0-beta-hbase1x.tar.gz) \[[asc](https://dist.apache.org/repos/dist/dev/kylin/apache-kylin-2.0.0-beta/apache-kylin-2.0.0-beta-hbase1x.tar.gz.asc)\] \[[md5](https://dist.apache.org/repos/dist/dev/kylin/apache-kylin-2.0.0-beta/apache-kylin-2.0.0-beta-hbase1x.tar.gz.md5)\] - - for CDH 5.7/5.8 - [apache-kylin-2.0.0-beta-cdh57.tar.gz](https://dist.apache.org/repos/dist/dev/kylin/apache-kylin-2.0.0-beta/apache-kylin-2.0.0-beta-cdh57.tar.gz) \[[asc](https://dist.apache.org/repos/dist/dev/kylin/apache-kylin-2.0.0-beta/apache-kylin-2.0.0-beta-cdh57.tar.gz.asc)\] \[[md5](https://dist.apache.org/repos/dist/dev/kylin/apache-kylin-2.0.0-beta/apache-kylin-2.0.0-beta-cdh57.tar.gz.md5)\] + - for HBase 0.98 (includes HDP 2.2, CDH 5.2/5.3) - [apache-kylin-2.0.0-beta2-hbase098.tar.gz](https://dist.apache.org/repos/dist/dev/kylin/apache-kylin-2.0.0-beta2/apache-kylin-2.0.0-beta2-hbase098.tar.gz) \[[asc](https://dist.apache.org/repos/dist/dev/kylin/apache-kylin-2.0.0-beta2/apache-kylin-2.0.0-beta2-hbase098.tar.gz.asc)\] \[[md5](https://dist.apache.org/repos/dist/dev/kylin/apache-kylin-2.0.0-beta2/apache-kylin-2.0.0-beta2-hbase098.tar.gz.md5)\] + - for HBase 1.x (includes HDP 2.3/2.4, EMR 5.0) - [apache-kylin-2.0.0-beta2-hbase1x.tar.gz](https://dist.apache.org/repos/dist/dev/kylin/apache-kylin-2.0.0-beta2/apache-kylin-2.0.0-beta2-hbase1x.tar.gz) \[[asc](https://dist.apache.org/repos/dist/dev/kylin/apache-kylin-2.0.0-beta2/apache-kylin-2.0.0-beta2-hbase1x.tar.gz.asc)\] \[[md5](https://dist.apache.org/repos/dist/dev/kylin/apache-kylin-2.0.0-beta2/apache-kylin-2.0.0-beta2-hbase1x.tar.gz.md5)\] + - for CDH 5.7/5.8 - [apache-kylin-2.0.0-beta2-cdh57.tar.gz](https://dist.apache.org/repos/dist/dev/kylin/apache-kylin-2.0.0-beta2/apache-kylin-2.0.0-beta2-cdh57.tar.gz) \[[asc](https://dist.apache.org/repos/dist/dev/kylin/apache-kylin-2.0.0-beta2/apache-kylin-2.0.0-beta2-cdh57.tar.gz.asc)\] \[[md5](https://dist.apache.org/repos/dist/dev/kylin/apache-kylin-2.0.0-beta2/apache-kylin-2.0.0-beta2-cdh57.tar.gz.md5)\] ## 1.6.0
