You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@calcite.apache.org by jh...@apache.org on 2016/03/17 21:10:10 UTC

[3/8] calcite git commit: [CALCITE-1077] Release notes and announcement for Avatica 1.7.1

[CALCITE-1077] Release notes and announcement for Avatica 1.7.1


Project: http://git-wip-us.apache.org/repos/asf/calcite/repo
Commit: http://git-wip-us.apache.org/repos/asf/calcite/commit/5e3db153
Tree: http://git-wip-us.apache.org/repos/asf/calcite/tree/5e3db153
Diff: http://git-wip-us.apache.org/repos/asf/calcite/diff/5e3db153

Branch: refs/heads/master
Commit: 5e3db15392cc928a0096cfc3d8fd11c0db1f2784
Parents: c2d84ab
Author: Josh Elser <el...@apache.org>
Authored: Mon Mar 14 11:58:27 2016 -0400
Committer: Julian Hyde <jh...@apache.org>
Committed: Thu Mar 17 12:32:00 2016 -0700

----------------------------------------------------------------------
 avatica/site/_docs/history.md                   | 25 ++++--
 avatica/site/_posts/2016-03-18-release-1.7.1.md | 87 ++++++++++++++++++++
 avatica/site/downloads/index.md                 | 12 ++-
 site/_config.yml                                |  2 +-
 4 files changed, 116 insertions(+), 10 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/calcite/blob/5e3db153/avatica/site/_docs/history.md
----------------------------------------------------------------------
diff --git a/avatica/site/_docs/history.md b/avatica/site/_docs/history.md
index 896e6b0..ae7bd64 100644
--- a/avatica/site/_docs/history.md
+++ b/avatica/site/_docs/history.md
@@ -28,8 +28,8 @@ For a full list of releases, see
 Downloads are available on the
 [downloads page]({{ site.baseurl }}/downloads/).
 
-## 1.7.0 / (Under Development)
-{: #v1-7-0}
+## <a href="https://github.com/apache/calcite/releases/tag/calcite-avatica-1.7.1">1.7.1</a> / 2016-03-18
+{: #v1-7-1}
 
 This is the first release of Avatica as an independent project. (It
 is still governed by Apache Calcite's PMC, and stored in the same git
@@ -41,7 +41,7 @@ with [SLF4J](http://slf4j.org/). SLF4J provides an API that Avatica can use
 independent of the logging implementation. This is more
 flexible for users: they can configure Avatica's logging within their
 own chosen logging framework. This work was done in
-[CALCITE-669](https://issues.apache.org/jira/browse/CALCITE-669).
+[[CALCITE-669](https://issues.apache.org/jira/browse/CALCITE-669)].
 
 If you have configured JUL in Calcite/Avatica previously, you'll
 notice some differences, because JUL's `FINE`, `FINER` and `FINEST`
@@ -60,6 +60,10 @@ other software versions as specified in `pom.xml`.
 
 Features and bug fixes
 
+* [<a href="https://issues.apache.org/jira/browse/CALCITE-1156">CALCITE-1156</a>]
+  Upgrade Jetty from 9.2.7.v20150116 to 9.2.15.v20160210
+* [<a href="https://issues.apache.org/jira/browse/CALCITE-1141">CALCITE-1141</a>]
+  Bump `version.minor` for Avatica
 * [<a href="https://issues.apache.org/jira/browse/CALCITE-1132">CALCITE-1132</a>]
   Update `artifactId`, `groupId` and `name` for Avatica
 * [<a href="https://issues.apache.org/jira/browse/CALCITE-1064">CALCITE-1064</a>]
@@ -100,6 +104,16 @@ Features and bug fixes
 
 Web site and documentation
 
+* [<a href="https://issues.apache.org/jira/browse/CALCITE-1142">CALCITE-1142</a>]
+  Create a `README` for Avatica
+* [<a href="https://issues.apache.org/jira/browse/CALCITE-1144">CALCITE-1144</a>]
+  Fix `LICENSE` for Avatica
+* [<a href="https://issues.apache.org/jira/browse/CALCITE-1143">CALCITE-1143</a>]
+  Remove unnecessary `NOTICE` for Avatica
+* [<a href="https://issues.apache.org/jira/browse/CALCITE-1139">CALCITE-1139</a>]
+  Update Calcite's `KEYS` and add a copy for Avatica
+* [<a href="https://issues.apache.org/jira/browse/CALCITE-1140">CALCITE-1140</a>]
+  Release notes and website updates for Avatica 1.7
 * Instructions for Avatica site
 * New logo and color scheme for Avatica site
 * [<a href="https://issues.apache.org/jira/browse/CALCITE-1079">CALCITE-1079</a>]
@@ -107,9 +121,10 @@ Web site and documentation
 
 ## Past releases
 
-Prior to release 1.7.0, Avatica was released as part of Calcite. Maven
+Prior to release 1.7.1, Avatica was released as part of Calcite. Maven
 modules had groupId 'org.apache.calcite' and module names
 'calcite-avatica', 'calcite-avatica-server' etc.
 
-Please refer to the [Calcite release page](https://calcite.apache.org/docs/history.html)
+Please refer to the
+[Calcite release page](https://calcite.apache.org/docs/history.html)
 for information about previous Avatica releases.

http://git-wip-us.apache.org/repos/asf/calcite/blob/5e3db153/avatica/site/_posts/2016-03-18-release-1.7.1.md
----------------------------------------------------------------------
diff --git a/avatica/site/_posts/2016-03-18-release-1.7.1.md b/avatica/site/_posts/2016-03-18-release-1.7.1.md
new file mode 100644
index 0000000..7ee678c
--- /dev/null
+++ b/avatica/site/_posts/2016-03-18-release-1.7.1.md
@@ -0,0 +1,87 @@
+---
+layout: news_item
+date: "2016-03-18 12:00:00 +0000"
+author: elserj
+version: 1.7.1
+categories: [release]
+tag: v1-7-1
+sha: 11cb0a8
+---
+<!--
+{% comment %}
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements.  See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to you under the Apache License, Version 2.0
+(the "License"); you may not use this file except in compliance with
+the License.  You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+{% endcomment %}
+-->
+
+Apache Calcite's PMC has just released Avatica 1.7.1, the first
+release of [Avatica](http://calcite.apache.org/avatica/) as an
+independent project. We're excited because it makes Avatica easier to
+use, and allows us to be more agile in our release schedule.
+
+(Avatica was previously released as part of Calcite. Avatica is still
+governed by Apache Calcite's PMC, and stored in the same git
+repository as Calcite, but releases are no longer synchronized, and
+Avatica does not depend on any Calcite modules.)
+
+A significant portion of the work of this release was "Maven work" to
+separate the build and release processes, but there were several
+important bug fixes, including a security fix for Jetty (see below).
+
+Performance, specifically on the write path, was a big focus in this
+release.
+[[CALCITE-1091](https://issues.apache.org/jira/browse/CALCITE-1091)]
+contained a number of important changes. Some of these changes (e.g.
+[[CALCITE-1092](https://issues.apache.org/jira/browse/CALCITE-1092)]
+and
+[[CALCITE-1093](https://issues.apache.org/jira/browse/CALCITE-1093)])
+were related to heap usage in the Avatica server, while
+[[CALCITE-1094](https://issues.apache.org/jira/browse/CALCITE-1094)]
+and
+[[CALCITE-1117](https://issues.apache.org/jira/browse/CALCITE-1117)]
+were strictly performance-related.
+
+The latter improved performance the most. Switching to the
+[Apache Commons HttpComponents Client](http://hc.apache.org/)
+library instead of using the Java platform's built-in
+[HttpURLConnection](https://docs.oracle.com/javase/7/docs/api/java/net/HttpURLConnection.html),
+we noticed a 15% improvement in pure write workloads.
+
+Three dependent library upgrades:
+
+* We completely removed
+  [Commons Logging](https://commons.apache.org/proper/commons-logging/)
+  in favor of [SLF4J](http://slf4j.org/) in
+  [[CALCITE-669](https://issues.apache.org/jira/browse/CALCITE-669)].
+  This logging framework update will allow downstream integrators to
+  use the logging implementation of their choice instead of being
+  forced to inherit Commons Logging.
+* We upgraded Jackson from 2.1.1 to 2.6.3 in
+  [[CALCITE-1021](https://issues.apache.org/jira/browse/CALCITE-1021)].
+* We upgraded Jetty from 9.2.7.v20150116 to 9.2.15.v20160210 in
+  [[CALCITE-1156](https://issues.apache.org/jira/browse/CALCITE-1156)]
+  to fix a
+  [security issue](https://blog.gdssecurity.com/labs/2015/2/25/jetleak-vulnerability-remote-leakage-of-shared-buffers-in-je.html).
+
+Note that Avatica's Maven coordinates have changed. The `groupId` is
+now "org.apache.calcite.avatica" (previously "org.apache.calcite"),
+and `artifactId`s are
+"avatica",
+"avatica-metrics",
+"avatica-metrics-dropwizardmetrics3",
+"avatica-noop-driver",
+"avatica-server"
+(previously "calcite-avatica", etc.). Make sure to update these when
+upgrading to this version.

http://git-wip-us.apache.org/repos/asf/calcite/blob/5e3db153/avatica/site/downloads/index.md
----------------------------------------------------------------------
diff --git a/avatica/site/downloads/index.md b/avatica/site/downloads/index.md
index 74e9225..7051c96 100644
--- a/avatica/site/downloads/index.md
+++ b/avatica/site/downloads/index.md
@@ -32,7 +32,7 @@ Release          | Date       | Commit   | Download
 {% endcomment %}{% if post.fullVersion %}{% comment %}
 {% endcomment %}{% assign v = post.fullVersion %}{% comment %}
 {% endcomment %}{% else %}{% comment %}
-{% endcomment %}{% capture v %}apache-calcite-{{ post.version }}{% endcapture %}{% comment %}
+{% endcomment %}{% capture v %}apache-calcite-avatica-{{ post.version }}{% endcapture %}{% comment %}
 {% endcomment %}{% endif %}{% comment %}
 {% endcomment %}{% if forloop.index0 < 1 %}{% comment %}
 {% endcomment %}{% capture p %}http://www.apache.org/dyn/closer.lua?filename=calcite/{{ v }}{% endcapture %}{% comment %}
@@ -69,8 +69,7 @@ download has completed OK.
 
 For fast downloads, current source distributions are hosted on mirror servers;
 older source distributions are in the
-[archive](http://archive.apache.org/dist/calcite/)
-or [incubator archive](http://archive.apache.org/dist/incubator/calcite/).
+[archive](http://archive.apache.org/dist/calcite/).
 If a download from a mirror fails, retry, and the second download will likely
 succeed.
 
@@ -89,7 +88,12 @@ Add the following to the dependencies section of your `pom.xml` file:
 <dependencies>
   <dependency>
     <groupId>org.apache.calcite.avatica</groupId>
-    <artifactId>calcite-avatica</artifactId>
+    <artifactId>avatica</artifactId>
+    <version>{{ current_release.version }}</version>
+  </dependency>
+  <dependency>
+    <groupId>org.apache.calcite.avatica</groupId>
+    <artifactId>avatica-server</artifactId>
     <version>{{ current_release.version }}</version>
   </dependency>
 </dependencies>

http://git-wip-us.apache.org/repos/asf/calcite/blob/5e3db153/site/_config.yml
----------------------------------------------------------------------
diff --git a/site/_config.yml b/site/_config.yml
index 9b8de85..8c78d7e 100644
--- a/site/_config.yml
+++ b/site/_config.yml
@@ -20,7 +20,7 @@ excerpt_separator: ""
 repository: https://github.com/apache/calcite
 destination: target
 exclude: [README.md,Gemfile*]
-keep_files: [".git", ".svn", "apidocs", "testapidocs"]
+keep_files: [".git", ".svn", "apidocs", "testapidocs", "avatica"]
 
 collections:
   docs: