You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@phoenix.apache.org by ja...@apache.org on 2015/07/28 04:15:22 UTC
svn commit: r1692978 [2/2] - in /phoenix/site: publish/ publish/language/
source/src/site/ source/src/site/markdown/
Modified: phoenix/site/publish/update_statistics.html
URL: http://svn.apache.org/viewvc/phoenix/site/publish/update_statistics.html?rev=1692978&r1=1692977&r2=1692978&view=diff
==============================================================================
--- phoenix/site/publish/update_statistics.html (original)
+++ phoenix/site/publish/update_statistics.html Tue Jul 28 02:15:21 2015
@@ -1,7 +1,7 @@
<!DOCTYPE html>
<!--
- Generated by Apache Maven Doxia at 2015-06-30
+ Generated by Apache Maven Doxia at 2015-07-27
Rendered using Reflow Maven Skin 1.1.0 (http://andriusvelykis.github.io/reflow-maven-skin)
-->
<html xml:lang="en" lang="en">
@@ -82,6 +82,7 @@
<li ><a href="building.html" title="Building">Building</a></li>
<li ><a href="tuning.html" title="Tuning">Tuning</a></li>
<li ><a href="upgrading.html" title="Upgrading">Upgrading</a></li>
+ <li ><a href="release_notes.html" title="Release Notes">Release Notes</a></li>
<li ><a href="pherf.html" title="Performance Testing">Performance Testing</a></li>
<li class="divider"/>
<li ><a href="phoenix_spark.html" title="Apache Spark Integration">Apache Spark Integration</a></li>
@@ -300,6 +301,9 @@
<a href="upgrading.html" title="Upgrading">Upgrading</a>
</li>
<li >
+ <a href="release_notes.html" title="Release Notes">Release Notes</a>
+ </li>
+ <li >
<a href="pherf.html" title="Performance Testing">Performance Testing</a>
</li>
<li >
Modified: phoenix/site/publish/upgrading.html
URL: http://svn.apache.org/viewvc/phoenix/site/publish/upgrading.html?rev=1692978&r1=1692977&r2=1692978&view=diff
==============================================================================
--- phoenix/site/publish/upgrading.html (original)
+++ phoenix/site/publish/upgrading.html Tue Jul 28 02:15:21 2015
@@ -1,7 +1,7 @@
<!DOCTYPE html>
<!--
- Generated by Apache Maven Doxia at 2015-06-30
+ Generated by Apache Maven Doxia at 2015-07-27
Rendered using Reflow Maven Skin 1.1.0 (http://andriusvelykis.github.io/reflow-maven-skin)
-->
<html xml:lang="en" lang="en">
@@ -82,6 +82,7 @@
<li ><a href="building.html" title="Building">Building</a></li>
<li ><a href="tuning.html" title="Tuning">Tuning</a></li>
<li class="active"><a href="" title="Upgrading">Upgrading</a></li>
+ <li ><a href="release_notes.html" title="Release Notes">Release Notes</a></li>
<li ><a href="pherf.html" title="Performance Testing">Performance Testing</a></li>
<li class="divider"/>
<li ><a href="phoenix_spark.html" title="Apache Spark Integration">Apache Spark Integration</a></li>
@@ -153,12 +154,16 @@
</div>
<div class="section">
<h2 id="Minor_Release">Minor Release</h2>
- <p>When upgrading to a new minor release (i.e. the major version is the same, but the minor version has changed), sometimes modifications to the system tables are necessary to either fix a bug or provide a new feature. This upgrade will occur automatically the first time a newly upgraded client connects to the newly upgraded server. It is <b>required</b> that the server-side jar be upgraded first across your entire cluster, before any clients are upgraded. An older client will work with a newer server jar when the minor version is different, but not visa versa. In other words, clients do not need to be upgraded in lock step with the server.</p>
- <p>As of the 4.3 release, a mix of clients on different minor release versions is supported (note that prior releases required all clients to be upgraded at the same time). Another improvement as of the 4.3 release is that an upgrade may be done directly from one minor version to any other higher minor version (prior releases required an upgrade to each minor version in between).</p>
+ <p>When upgrading to a new minor release (i.e. the major version is the same, but the minor version has changed), sometimes modifications to the system tables are necessary to either fix a bug or provide a new feature. This upgrade will occur automatically the first time a newly upgraded client connects to the newly upgraded server. It is <b>required</b> that the server-side jar be upgraded first across your entire cluster, before any clients are upgraded. An older client (two minor versions back) will work with a newer server jar when the minor version is different, but not visa versa. In other words, clients do not need to be upgraded in lock step with the server. However, as the server version moves forward, the client version should move forward as well. This allows Phoenix to evolve its client/server protocol while still providing clients sufficient time to upgrade their clients.</p>
+ <p>As of the 4.3 release, a mix of clients on different minor release versions is supported as well (note that prior releases required all clients to be upgraded at the same time). Another improvement as of the 4.3 release is that an upgrade may be done directly from one minor version to another higher minor version (prior releases required an upgrade to each minor version in between).</p>
</div>
<div class="section">
<h2 id="Major_Release">Major Release</h2>
<p>Upgrading to a new major release may require downtime as well as potentially the running of a migration script. Additionally, all clients and servers may need to be upgraded at the same time. This will be determined on a release by release basis.</p>
+</div>
+<div class="section">
+ <h2 id="Release_Notes">Release Notes</h2>
+ <p>Specific details on issues and their fixes that may impact you may be found <a href="release_notes.html">here</a>.</p>
</div>
</div>
</div>
@@ -262,6 +267,9 @@
<a href="#" title="Upgrading">Upgrading</a>
</li>
<li >
+ <a href="release_notes.html" title="Release Notes">Release Notes</a>
+ </li>
+ <li >
<a href="pherf.html" title="Performance Testing">Performance Testing</a>
</li>
<li >
Modified: phoenix/site/publish/views.html
URL: http://svn.apache.org/viewvc/phoenix/site/publish/views.html?rev=1692978&r1=1692977&r2=1692978&view=diff
==============================================================================
--- phoenix/site/publish/views.html (original)
+++ phoenix/site/publish/views.html Tue Jul 28 02:15:21 2015
@@ -1,7 +1,7 @@
<!DOCTYPE html>
<!--
- Generated by Apache Maven Doxia at 2015-06-30
+ Generated by Apache Maven Doxia at 2015-07-27
Rendered using Reflow Maven Skin 1.1.0 (http://andriusvelykis.github.io/reflow-maven-skin)
-->
<html xml:lang="en" lang="en">
@@ -82,6 +82,7 @@
<li ><a href="building.html" title="Building">Building</a></li>
<li ><a href="tuning.html" title="Tuning">Tuning</a></li>
<li ><a href="upgrading.html" title="Upgrading">Upgrading</a></li>
+ <li ><a href="release_notes.html" title="Release Notes">Release Notes</a></li>
<li ><a href="pherf.html" title="Performance Testing">Performance Testing</a></li>
<li class="divider"/>
<li ><a href="phoenix_spark.html" title="Apache Spark Integration">Apache Spark Integration</a></li>
@@ -301,6 +302,9 @@ VALUES('John Doe', CURRENT_DATE(), NEXT
<a href="upgrading.html" title="Upgrading">Upgrading</a>
</li>
<li >
+ <a href="release_notes.html" title="Release Notes">Release Notes</a>
+ </li>
+ <li >
<a href="pherf.html" title="Performance Testing">Performance Testing</a>
</li>
<li >
Modified: phoenix/site/publish/who_is_using.html
URL: http://svn.apache.org/viewvc/phoenix/site/publish/who_is_using.html?rev=1692978&r1=1692977&r2=1692978&view=diff
==============================================================================
--- phoenix/site/publish/who_is_using.html (original)
+++ phoenix/site/publish/who_is_using.html Tue Jul 28 02:15:21 2015
@@ -1,7 +1,7 @@
<!DOCTYPE html>
<!--
- Generated by Apache Maven Doxia at 2015-06-30
+ Generated by Apache Maven Doxia at 2015-07-27
Rendered using Reflow Maven Skin 1.1.0 (http://andriusvelykis.github.io/reflow-maven-skin)
-->
<html xml:lang="en" lang="en">
@@ -82,6 +82,7 @@
<li ><a href="building.html" title="Building">Building</a></li>
<li ><a href="tuning.html" title="Tuning">Tuning</a></li>
<li ><a href="upgrading.html" title="Upgrading">Upgrading</a></li>
+ <li ><a href="release_notes.html" title="Release Notes">Release Notes</a></li>
<li ><a href="pherf.html" title="Performance Testing">Performance Testing</a></li>
<li class="divider"/>
<li ><a href="phoenix_spark.html" title="Apache Spark Integration">Apache Spark Integration</a></li>
@@ -332,6 +333,9 @@
<a href="upgrading.html" title="Upgrading">Upgrading</a>
</li>
<li >
+ <a href="release_notes.html" title="Release Notes">Release Notes</a>
+ </li>
+ <li >
<a href="pherf.html" title="Performance Testing">Performance Testing</a>
</li>
<li >
Modified: phoenix/site/source/src/site/markdown/download.md
URL: http://svn.apache.org/viewvc/phoenix/site/source/src/site/markdown/download.md?rev=1692978&r1=1692977&r2=1692978&view=diff
==============================================================================
--- phoenix/site/source/src/site/markdown/download.md (original)
+++ phoenix/site/source/src/site/markdown/download.md Tue Jul 28 02:15:21 2015
@@ -1,15 +1,16 @@
-## Phoenix Downloads
+# Phoenix Downloads
### [<u>Download Latest Phoenix Binary and Source Releases</u>](http://www.apache.org/dyn/closer.cgi/phoenix/)
-[List of New Features](recent.html)
+### [<u>See Latest Release Notes</u>](release_notes.html)
+#### [List of New Features](recent.html)
-[Download Previous Releases](http://www.apache.org/dyn/closer.cgi/incubator/phoenix/)<hr/>
+#### [Download Previous Releases](http://www.apache.org/dyn/closer.cgi/incubator/phoenix/)<hr/>
### HBase Compatibility
* Phoenix 2.x - HBase 0.94.x
* Phoenix 3.x - HBase 0.94.x
* Phoenix 4.x - HBase 0.98.1+
<hr/>
-See also: [Installation Instructions](installation.html)
+#### See also: [Installation Instructions](installation.html)
Modified: phoenix/site/source/src/site/markdown/recent.md
URL: http://svn.apache.org/viewvc/phoenix/site/source/src/site/markdown/recent.md?rev=1692978&r1=1692977&r2=1692978&view=diff
==============================================================================
--- phoenix/site/source/src/site/markdown/recent.md (original)
+++ phoenix/site/source/src/site/markdown/recent.md Tue Jul 28 02:15:21 2015
@@ -2,7 +2,8 @@
As items are implemented from our road map, they are moved here to track the progress we've made:
-1. **[Functional Indexes](secondary_indexing.html#Functional_Indexes)**. Enables an index to be defined as expressions as opposed to just column names and have the index be used when a query contains this expression.
+1. **[User Defined Functions](udf.html)**. Allows users to create and deploy their own custom or domain-specific user-defined functions to the cluster. **Available in our 4.4 release**
+1. **[Functional Indexes](secondary_indexing.html#Functional_Indexes)**. Enables an index to be defined as expressions as opposed to just column names and have the index be used when a query contains this expression. **Available in our 4.3 release**
2. **[Map-reduce Integration](phoenix_mr.html)**. Support general map-reduce integration to Phoenix by implementing custom input and output formats.
1. **[Statistics Collection](update_statistics.html)**. Collects the statistics for a table to improve query parallelization. **Available in our 3.2/4.2 release**
2. **[Join Improvements](joins.html)**. Improve existing hash join implementation.
Added: phoenix/site/source/src/site/markdown/release_notes.md
URL: http://svn.apache.org/viewvc/phoenix/site/source/src/site/markdown/release_notes.md?rev=1692978&view=auto
==============================================================================
--- phoenix/site/source/src/site/markdown/release_notes.md (added)
+++ phoenix/site/source/src/site/markdown/release_notes.md Tue Jul 28 02:15:21 2015
@@ -0,0 +1,49 @@
+#Release Notes
+
+Release notes provide details on issues and their fixes which may have an impact on prior
+Phoenix behavior. For some issues an upgrade may be required to be performed for a fix to
+take affect. See below for directions specific to a particular release.
+
+
+###<u>Phoenix-4.5.0 Release Notes</u>
+Both [PHOENIX-2067](https://issues.apache.org/jira/browse/PHOENIX-2067) and
+[PHOENIX-2120](https://issues.apache.org/jira/browse/PHOENIX-2120) cause rows to not be ordered
+correctly for the following types of columns:
+
+* VARCHAR DESC columns
+* DECIMAL DESC columns
+* ARRAY DESC columns
+* Nullable DESC columns which are indexed (impacts the index, but not the data table)
+* BINARY columns included in the primary key constraint
+
+To get an idea if any of your tables are impacted, you may run the following command:
+
+ ./psql.py -u my_host_name
+
+This will look through all tables you've defined and indicate if any upgrades are necessary.
+
+To upgrade the tables, run the same command, but list the tables you'd like upgraded like this:
+
+ ./psql.py -u my_host_name table1 table2 table3
+
+This will first make a snapshot of your table and then upgrade it. If any problems occur
+during the upgrade process, the snapshot of your original table will be restored.
+
+For the case of BINARY columns, no update is required if you've always provided all of
+the bytes making up that column value (i.e. you have not relied on Phoenix to auto-pad the
+column up to the fixed length). In this case, you should bypass the upgrade by running the
+following command:
+
+ ./psql.py -u -b my_host_name table1
+
+This is important, because the PHOENIX-2120 was caused by BINARY columns being incorrectly
+padded with a space characters instead of a zero byte characters. The upgrade will replace
+trailing space characters with zero byte characters which may be invalid if the space
+characters are legitimate/intentional characters. Unfortunately, Phoenix has no way to know
+if this is the case.
+
+Upgrading your tables is important, as without this, Phoenix will need to reorder rows it
+retrieves back from the server when otherwise not necessary. This will have a large negative
+impact on performance until the upgrade is performed.
+
+__Future releases of Phoenix may require that affected tables be upgraded prior to moving to the new release.__
Modified: phoenix/site/source/src/site/markdown/upgrading.md
URL: http://svn.apache.org/viewvc/phoenix/site/source/src/site/markdown/upgrading.md?rev=1692978&r1=1692977&r2=1692978&view=diff
==============================================================================
--- phoenix/site/source/src/site/markdown/upgrading.md (original)
+++ phoenix/site/source/src/site/markdown/upgrading.md Tue Jul 28 02:15:21 2015
@@ -16,14 +16,22 @@ version has changed), sometimes modifica
fix a bug or provide a new feature. This upgrade will occur automatically the first time a
newly upgraded client connects to the newly upgraded server. It is **required** that the
server-side jar be upgraded first across your entire cluster, before any clients are
-upgraded. An older client will work with a newer server jar when the minor version is
-different, but not visa versa. In other words, clients do not need to be upgraded in lock
-step with the server.
+upgraded. An older client (two minor versions back) will work with a newer server jar when
+the minor version is different, but not visa versa. In other words, clients do not need to
+be upgraded in lock step with the server. However, as the server version moves forward,
+the client version should move forward as well. This allows Phoenix to evolve its client/server
+protocol while still providing clients sufficient time to upgrade their clients.
-As of the 4.3 release, a mix of clients on different
-minor release versions is supported (note that prior releases required all clients to be
-upgraded at the same time). Another improvement as of the 4.3 release is that an upgrade
-may be done directly from one minor version to any other higher minor version (prior releases required an upgrade to each minor version in between).
+As of the 4.3 release, a mix of clients on different minor release versions is supported as well
+(note that prior releases required all clients to be upgraded at the same time). Another improvement
+as of the 4.3 release is that an upgrade may be done directly from one minor version to another
+higher minor version (prior releases required an upgrade to each minor version in between).
##Major Release
-Upgrading to a new major release may require downtime as well as potentially the running of a migration script. Additionally, all clients and servers may need to be upgraded at the same time. This will be determined on a release by release basis.
+Upgrading to a new major release may require downtime as well as potentially the running of a migration
+script. Additionally, all clients and servers may need to be upgraded at the same time. This will be
+determined on a release by release basis.
+
+
+##Release Notes
+Specific details on issues and their fixes that may impact you may be found [here](release_notes.html).
Modified: phoenix/site/source/src/site/site.xml
URL: http://svn.apache.org/viewvc/phoenix/site/source/src/site/site.xml?rev=1692978&r1=1692977&r2=1692978&view=diff
==============================================================================
--- phoenix/site/source/src/site/site.xml (original)
+++ phoenix/site/source/src/site/site.xml Tue Jul 28 02:15:21 2015
@@ -85,6 +85,7 @@
<item href="building.html" name="Building"/>
<item href="tuning.html" name="Tuning"/>
<item href="upgrading.html" name="Upgrading"/>
+ <item href="release_notes.html" name="Release Notes"/>
<item href="pherf.html" name="Performance Testing"/>
<item href="http:divider" name=""/>
<item href="phoenix_spark.html" name="Apache Spark Integration"/>