You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@kudu.apache.org by gr...@apache.org on 2018/03/21 19:23:40 UTC
[1/3] kudu git commit: Updates to RELEASING.adoc
Repository: kudu
Updated Branches:
refs/heads/master 91e207fcc -> f9f0583fd
Updates to RELEASING.adoc
Change-Id: I0bceaeb982c0eb57fa9c93c10f7f35546cd0f1c4
Reviewed-on: http://gerrit.cloudera.org:8080/9734
Reviewed-by: Adar Dembo <ad...@cloudera.com>
Tested-by: Grant Henke <gr...@apache.org>
Project: http://git-wip-us.apache.org/repos/asf/kudu/repo
Commit: http://git-wip-us.apache.org/repos/asf/kudu/commit/662c86c5
Tree: http://git-wip-us.apache.org/repos/asf/kudu/tree/662c86c5
Diff: http://git-wip-us.apache.org/repos/asf/kudu/diff/662c86c5
Branch: refs/heads/master
Commit: 662c86c5f974579b334398375abba37fb17ae090
Parents: 91e207f
Author: Grant Henke <gr...@apache.org>
Authored: Wed Mar 21 12:01:38 2018 -0500
Committer: Grant Henke <gr...@apache.org>
Committed: Wed Mar 21 18:30:18 2018 +0000
----------------------------------------------------------------------
RELEASING.adoc | 7 ++++---
1 file changed, 4 insertions(+), 3 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/kudu/blob/662c86c5/RELEASING.adoc
----------------------------------------------------------------------
diff --git a/RELEASING.adoc b/RELEASING.adoc
index 4857927..1578b77 100644
--- a/RELEASING.adoc
+++ b/RELEASING.adoc
@@ -240,7 +240,7 @@ Apache Git repository:
+
----
git tag -s 1.x.y -m 'Release Apache Kudu 1.x.y' 1.x.y-RC1
- git push apache 1.x.y-RC1
+ git push apache 1.x.y
----
. Release the staged Java artifacts. Select the release candidate staging
@@ -250,10 +250,11 @@ Apache Git repository:
. Generate the version-specific documentation from that branch following these
link:https://github.com/apache/kudu/#updating-the-kudu-web-site-documentation[instructions].
-. Replace the `apidocs` and `docs` folders in the `gh-pages` branch with the new documentation.
+. Replace the `apidocs`, `cpp-client-api`, and `docs` folders in the `gh-pages` branch with
+ the new documentation.
. Update the `index.md` file in the releases folder, add a new folder named after the release version,
- copy the `apidocs` and `docs` folders there, copy an `index.md` file from one
+ copy the `apidocs`, `cpp-client-api`, and `docs` folders there, copy an `index.md` file from one
of the other releases and modify it accordingly.
. Commit all these changes.
[3/3] kudu git commit: docs: fix number of number masters
Posted by gr...@apache.org.
docs: fix number of number masters
Added warnings to installation and administration about having an even
number of masters not providing fault tolerance.
known_issues recommends 3 as a max number of masters while installation
recommended 1, 3 or 5. Changed recommendation in installation for
consistency.
Change-Id: Ic24ae1cbcd59534273adba48b20a2418651b19a4
Reviewed-on: http://gerrit.cloudera.org:8080/9091
Tested-by: Kudu Jenkins
Reviewed-by: Dan Burkert <da...@apache.org>
Reviewed-by: Andrew Wong <aw...@cloudera.com>
Project: http://git-wip-us.apache.org/repos/asf/kudu/repo
Commit: http://git-wip-us.apache.org/repos/asf/kudu/commit/f9f0583f
Tree: http://git-wip-us.apache.org/repos/asf/kudu/tree/f9f0583f
Diff: http://git-wip-us.apache.org/repos/asf/kudu/diff/f9f0583f
Branch: refs/heads/master
Commit: f9f0583fd88185a216f27dfa289da2954cbeacd6
Parents: 82e9a87
Author: Attila Bukor <ab...@cloudera.com>
Authored: Mon Jan 22 16:27:08 2018 +0100
Committer: Andrew Wong <aw...@cloudera.com>
Committed: Wed Mar 21 19:11:04 2018 +0000
----------------------------------------------------------------------
docs/administration.adoc | 5 ++++-
docs/installation.adoc | 12 ++++++++----
2 files changed, 12 insertions(+), 5 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/kudu/blob/f9f0583f/docs/administration.adoc
----------------------------------------------------------------------
diff --git a/docs/administration.adoc b/docs/administration.adoc
index 149ea11..cdc8128 100644
--- a/docs/administration.adoc
+++ b/docs/administration.adoc
@@ -211,11 +211,14 @@ For high availability and to avoid a single point of failure, Kudu clusters shou
multiple masters. Many Kudu clusters were created with just a single master, either for simplicity
or because Kudu multi-master support was still experimental at the time. This workflow demonstrates
how to migrate to a multi-master configuration. It can also be used to migrate from two masters to
-three, with straightforward modifications.
+three, with straightforward modifications. Note that the number of masters must be odd.
WARNING: The workflow is unsafe for adding new masters to an existing configuration that already has
three or more masters. Do not use it for that purpose.
+WARNING: An even number of masters doesn't provide any benefit over having one fewer masters. This
+guide should always be used for migrating to three masters.
+
WARNING: All of the command line steps below should be executed as the Kudu UNIX user. The example
commands assume the Kudu Unix user is `kudu`, which is typical.
http://git-wip-us.apache.org/repos/asf/kudu/blob/f9f0583f/docs/installation.adoc
----------------------------------------------------------------------
diff --git a/docs/installation.adoc b/docs/installation.adoc
index 60d2b78..5131fa0 100644
--- a/docs/installation.adoc
+++ b/docs/installation.adoc
@@ -41,10 +41,14 @@ To upgrade Kudu from a previous version, see <<upgrade>>.
== Prerequisites and Requirements
.Hardware
-- One or more hosts to run Kudu masters. It is recommended to have either one master
-(no fault tolerance), three masters (can tolerate one failure), or five masters (two failures).
-- One or more hosts to run Kudu tablet servers. When using replication, a minimum of
-three tablet servers is necessary.
+- One or more hosts to run Kudu masters. It is recommended to have either one master (no fault
+tolerance), or three masters (can tolerate one failure). The number of masters must be odd.
+- One or more hosts to run Kudu tablet servers. When using replication, a minimum of three tablet
+servers is necessary.
+
+WARNING: A deployment with an even number of masters provides the same level of fault tolerance as a
+deployment with one fewer master. For example, both four-master and three-master deployments can
+only tolerate a single failure; two-master deployments cannot tolerate any failures.
.Operating System Requirements
Linux::
[2/3] kudu git commit: Fix make_docs.sh on Mac OS
Posted by gr...@apache.org.
Fix make_docs.sh on Mac OS
mktemp on Mac OS does not support the —suffix option
and requires the pattern of X’s to come at the end of
the file. To work around this, we create a temp file
and rename it to contain the correct suffix.
Change-Id: Ibe17beb9b558a059599c2350db1d1508a1f6f954
Reviewed-on: http://gerrit.cloudera.org:8080/9736
Reviewed-by: Adar Dembo <ad...@cloudera.com>
Tested-by: Grant Henke <gr...@apache.org>
Project: http://git-wip-us.apache.org/repos/asf/kudu/repo
Commit: http://git-wip-us.apache.org/repos/asf/kudu/commit/82e9a877
Tree: http://git-wip-us.apache.org/repos/asf/kudu/tree/82e9a877
Diff: http://git-wip-us.apache.org/repos/asf/kudu/diff/82e9a877
Branch: refs/heads/master
Commit: 82e9a877e13b5447d502ab8c93fa157545a1be43
Parents: 662c86c
Author: Grant Henke <gr...@apache.org>
Authored: Wed Mar 21 13:33:09 2018 -0500
Committer: Grant Henke <gr...@apache.org>
Committed: Wed Mar 21 18:39:03 2018 +0000
----------------------------------------------------------------------
docs/support/scripts/make_docs.sh | 7 ++++++-
1 file changed, 6 insertions(+), 1 deletion(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/kudu/blob/82e9a877/docs/support/scripts/make_docs.sh
----------------------------------------------------------------------
diff --git a/docs/support/scripts/make_docs.sh b/docs/support/scripts/make_docs.sh
index c449c5a..1033c5f 100755
--- a/docs/support/scripts/make_docs.sh
+++ b/docs/support/scripts/make_docs.sh
@@ -216,7 +216,12 @@ if [ -n "$SITE" ] && [ -z "$NO_JEKYLL" ]; then
# We need to generate a config file which fakes the "github.url" property
# so that relative links within the site work.
BASE_URL="file://$SITE/_site/"
- TMP_CONFIG=$(mktemp --suffix=.yml)
+ TMP_CONFIG=$(mktemp -t config.XXXXXX)
+ # Rename the config file. The template adds the random section
+ # to the end of the file to be compatible with Mac OS. However,
+ # Jekyll expects the file to end in yml.
+ mv "$TMP_CONFIG" "$TMP_CONFIG.yml"
+ TMP_CONFIG="$TMP_CONFIG.yml"
trap "rm $TMP_CONFIG" EXIT
printf "github:\n url: %s" "$BASE_URL" > $TMP_CONFIG