You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@knox.apache.org by sm...@apache.org on 2022/12/13 14:39:57 UTC
svn commit: r1905966 - in /knox: site/ site/books/knox-2-0-0/ trunk/ trunk/books/2.0.0/
Author: smolnar
Date: Tue Dec 13 14:39:56 2022
New Revision: 1905966
URL: http://svn.apache.org/viewvc?rev=1905966&view=rev
Log:
KNOX-2709 - Removed retry-related params from WebHDFS HA documentation
Modified:
knox/site/books/knox-2-0-0/deployment-overview.png
knox/site/books/knox-2-0-0/deployment-provider.png
knox/site/books/knox-2-0-0/deployment-service.png
knox/site/books/knox-2-0-0/general_saml_flow.png
knox/site/books/knox-2-0-0/runtime-overview.png
knox/site/books/knox-2-0-0/runtime-request-processing.png
knox/site/books/knox-2-0-0/user-guide.html
knox/site/index.html
knox/site/issue-management.html
knox/site/licenses.html
knox/site/mailing-lists.html
knox/site/project-info.html
knox/site/team.html
knox/trunk/books/2.0.0/service_webhdfs.md
knox/trunk/build.xml
Modified: knox/site/books/knox-2-0-0/deployment-overview.png
URL: http://svn.apache.org/viewvc/knox/site/books/knox-2-0-0/deployment-overview.png?rev=1905966&r1=1905965&r2=1905966&view=diff
==============================================================================
Binary files - no diff available.
Modified: knox/site/books/knox-2-0-0/deployment-provider.png
URL: http://svn.apache.org/viewvc/knox/site/books/knox-2-0-0/deployment-provider.png?rev=1905966&r1=1905965&r2=1905966&view=diff
==============================================================================
Binary files - no diff available.
Modified: knox/site/books/knox-2-0-0/deployment-service.png
URL: http://svn.apache.org/viewvc/knox/site/books/knox-2-0-0/deployment-service.png?rev=1905966&r1=1905965&r2=1905966&view=diff
==============================================================================
Binary files - no diff available.
Modified: knox/site/books/knox-2-0-0/general_saml_flow.png
URL: http://svn.apache.org/viewvc/knox/site/books/knox-2-0-0/general_saml_flow.png?rev=1905966&r1=1905965&r2=1905966&view=diff
==============================================================================
Binary files - no diff available.
Modified: knox/site/books/knox-2-0-0/runtime-overview.png
URL: http://svn.apache.org/viewvc/knox/site/books/knox-2-0-0/runtime-overview.png?rev=1905966&r1=1905965&r2=1905966&view=diff
==============================================================================
Binary files - no diff available.
Modified: knox/site/books/knox-2-0-0/runtime-request-processing.png
URL: http://svn.apache.org/viewvc/knox/site/books/knox-2-0-0/runtime-request-processing.png?rev=1905966&r1=1905965&r2=1905966&view=diff
==============================================================================
Binary files - no diff available.
Modified: knox/site/books/knox-2-0-0/user-guide.html
URL: http://svn.apache.org/viewvc/knox/site/books/knox-2-0-0/user-guide.html?rev=1905966&r1=1905965&r2=1905966&view=diff
==============================================================================
--- knox/site/books/knox-2-0-0/user-guide.html (original)
+++ knox/site/books/knox-2-0-0/user-guide.html Tue Dec 13 14:39:56 2022
@@ -7451,7 +7451,7 @@ session.shutdown()
</li>
</ul>
<h3><a id="WebHDFS+HA">WebHDFS HA</a> <a href="#WebHDFS+HA"><img src="markbook-section-link.png"/></a></h3>
-<p>Knox provides basic failover and retry functionality for REST API calls made to WebHDFS when HDFS HA has been configured and enabled.</p>
+<p>Knox provides basic failover functionality for REST API calls made to WebHDFS when HDFS HA has been configured and enabled.</p>
<p>To enable HA functionality for WebHDFS in Knox the following configuration has to be added to the topology file.</p>
<pre><code><provider>
<role>ha</role>
@@ -7459,7 +7459,7 @@ session.shutdown()
<enabled>true</enabled>
<param>
<name>WEBHDFS</name>
- <value>maxFailoverAttempts=3;failoverSleep=1000;maxRetryAttempts=300;retrySleep=1000;enabled=true</value>
+ <value>maxFailoverAttempts=3;failoverSleep=1000;enabled=true</value>
</param>
</provider>
</code></pre>
@@ -7471,10 +7471,6 @@ session.shutdown()
<li>
<p>failoverSleep - The amount of time in milliseconds that the process will wait or sleep before attempting to failover.</p></li>
<li>
- <p>maxRetryAttempts - The is the maximum number of times that a retry request will be attempted. Unlike failover, the retry is done on the same URL that failed. This is a special case in HDFS when the node is in safe mode. The expectation is that the node will come out of safe mode so a retry is desirable here as opposed to a failover.</p></li>
- <li>
- <p>retrySleep - The amount of time in milliseconds that the process will wait or sleep before a retry is issued.</p></li>
- <li>
<p>enabled - Flag to turn the particular service on or off for HA.</p></li>
</ul>
<p>And for the service configuration itself the additional URLs should be added to the list. The active URL (at the time of configuration) should ideally be added to the top of the list.</p>
Modified: knox/site/index.html
URL: http://svn.apache.org/viewvc/knox/site/index.html?rev=1905966&r1=1905965&r2=1905966&view=diff
==============================================================================
--- knox/site/index.html (original)
+++ knox/site/index.html Tue Dec 13 14:39:56 2022
@@ -1,13 +1,13 @@
<!DOCTYPE html>
<!--
- | Generated by Apache Maven Doxia Site Renderer 1.8.1 from src/site/markdown/index.md at 2022-12-02
+ | Generated by Apache Maven Doxia Site Renderer 1.8.1 from src/site/markdown/index.md at 2022-12-13
| Rendered using Apache Maven Fluido Skin 1.7
-->
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <meta name="Date-Revision-yyyymmdd" content="20221202" />
+ <meta name="Date-Revision-yyyymmdd" content="20221213" />
<meta http-equiv="Content-Language" content="en" />
<title>Knox Gateway – Announcing Apache Knox 1.6.1!</title>
<link rel="stylesheet" href="./css/apache-maven-fluido-1.7.min.css" />
@@ -40,7 +40,7 @@
<div id="breadcrumbs">
<ul class="breadcrumb">
- <li id="publishDate">Last Published: 2022-12-02</li>
+ <li id="publishDate">Last Published: 2022-12-13</li>
</ul>
</div>
<div class="row-fluid">
Modified: knox/site/issue-management.html
URL: http://svn.apache.org/viewvc/knox/site/issue-management.html?rev=1905966&r1=1905965&r2=1905966&view=diff
==============================================================================
--- knox/site/issue-management.html (original)
+++ knox/site/issue-management.html Tue Dec 13 14:39:56 2022
@@ -1,13 +1,13 @@
<!DOCTYPE html>
<!--
- | Generated by Apache Maven Doxia Site Renderer 1.8.1 from org.apache.maven.plugins:maven-project-info-reports-plugin:3.0.0:issue-management at 2022-12-02
+ | Generated by Apache Maven Doxia Site Renderer 1.8.1 from org.apache.maven.plugins:maven-project-info-reports-plugin:3.0.0:issue-management at 2022-12-13
| Rendered using Apache Maven Fluido Skin 1.7
-->
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <meta name="Date-Revision-yyyymmdd" content="20221202" />
+ <meta name="Date-Revision-yyyymmdd" content="20221213" />
<meta http-equiv="Content-Language" content="en" />
<title>Knox Gateway – Issue Management</title>
<link rel="stylesheet" href="./css/apache-maven-fluido-1.7.min.css" />
@@ -40,7 +40,7 @@
<div id="breadcrumbs">
<ul class="breadcrumb">
- <li id="publishDate">Last Published: 2022-12-02</li>
+ <li id="publishDate">Last Published: 2022-12-13</li>
</ul>
</div>
<div class="row-fluid">
Modified: knox/site/licenses.html
URL: http://svn.apache.org/viewvc/knox/site/licenses.html?rev=1905966&r1=1905965&r2=1905966&view=diff
==============================================================================
--- knox/site/licenses.html (original)
+++ knox/site/licenses.html Tue Dec 13 14:39:56 2022
@@ -1,13 +1,13 @@
<!DOCTYPE html>
<!--
- | Generated by Apache Maven Doxia Site Renderer 1.8.1 from org.apache.maven.plugins:maven-project-info-reports-plugin:3.0.0:licenses at 2022-12-02
+ | Generated by Apache Maven Doxia Site Renderer 1.8.1 from org.apache.maven.plugins:maven-project-info-reports-plugin:3.0.0:licenses at 2022-12-13
| Rendered using Apache Maven Fluido Skin 1.7
-->
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <meta name="Date-Revision-yyyymmdd" content="20221202" />
+ <meta name="Date-Revision-yyyymmdd" content="20221213" />
<meta http-equiv="Content-Language" content="en" />
<title>Knox Gateway – Project Licenses</title>
<link rel="stylesheet" href="./css/apache-maven-fluido-1.7.min.css" />
@@ -40,7 +40,7 @@
<div id="breadcrumbs">
<ul class="breadcrumb">
- <li id="publishDate">Last Published: 2022-12-02</li>
+ <li id="publishDate">Last Published: 2022-12-13</li>
</ul>
</div>
<div class="row-fluid">
Modified: knox/site/mailing-lists.html
URL: http://svn.apache.org/viewvc/knox/site/mailing-lists.html?rev=1905966&r1=1905965&r2=1905966&view=diff
==============================================================================
--- knox/site/mailing-lists.html (original)
+++ knox/site/mailing-lists.html Tue Dec 13 14:39:56 2022
@@ -1,13 +1,13 @@
<!DOCTYPE html>
<!--
- | Generated by Apache Maven Doxia Site Renderer 1.8.1 from org.apache.maven.plugins:maven-project-info-reports-plugin:3.0.0:mailing-lists at 2022-12-02
+ | Generated by Apache Maven Doxia Site Renderer 1.8.1 from org.apache.maven.plugins:maven-project-info-reports-plugin:3.0.0:mailing-lists at 2022-12-13
| Rendered using Apache Maven Fluido Skin 1.7
-->
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <meta name="Date-Revision-yyyymmdd" content="20221202" />
+ <meta name="Date-Revision-yyyymmdd" content="20221213" />
<meta http-equiv="Content-Language" content="en" />
<title>Knox Gateway – Project Mailing Lists</title>
<link rel="stylesheet" href="./css/apache-maven-fluido-1.7.min.css" />
@@ -40,7 +40,7 @@
<div id="breadcrumbs">
<ul class="breadcrumb">
- <li id="publishDate">Last Published: 2022-12-02</li>
+ <li id="publishDate">Last Published: 2022-12-13</li>
</ul>
</div>
<div class="row-fluid">
Modified: knox/site/project-info.html
URL: http://svn.apache.org/viewvc/knox/site/project-info.html?rev=1905966&r1=1905965&r2=1905966&view=diff
==============================================================================
--- knox/site/project-info.html (original)
+++ knox/site/project-info.html Tue Dec 13 14:39:56 2022
@@ -1,13 +1,13 @@
<!DOCTYPE html>
<!--
- | Generated by Apache Maven Doxia Site Renderer 1.8.1 from org.apache.maven.plugins:maven-site-plugin:3.7.1:CategorySummaryDocumentRenderer at 2022-12-02
+ | Generated by Apache Maven Doxia Site Renderer 1.8.1 from org.apache.maven.plugins:maven-site-plugin:3.7.1:CategorySummaryDocumentRenderer at 2022-12-13
| Rendered using Apache Maven Fluido Skin 1.7
-->
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <meta name="Date-Revision-yyyymmdd" content="20221202" />
+ <meta name="Date-Revision-yyyymmdd" content="20221213" />
<meta http-equiv="Content-Language" content="en" />
<title>Knox Gateway – Project Information</title>
<link rel="stylesheet" href="./css/apache-maven-fluido-1.7.min.css" />
@@ -40,7 +40,7 @@
<div id="breadcrumbs">
<ul class="breadcrumb">
- <li id="publishDate">Last Published: 2022-12-02</li>
+ <li id="publishDate">Last Published: 2022-12-13</li>
</ul>
</div>
<div class="row-fluid">
Modified: knox/site/team.html
URL: http://svn.apache.org/viewvc/knox/site/team.html?rev=1905966&r1=1905965&r2=1905966&view=diff
==============================================================================
--- knox/site/team.html (original)
+++ knox/site/team.html Tue Dec 13 14:39:56 2022
@@ -1,13 +1,13 @@
<!DOCTYPE html>
<!--
- | Generated by Apache Maven Doxia Site Renderer 1.8.1 from org.apache.maven.plugins:maven-project-info-reports-plugin:3.0.0:team at 2022-12-02
+ | Generated by Apache Maven Doxia Site Renderer 1.8.1 from org.apache.maven.plugins:maven-project-info-reports-plugin:3.0.0:team at 2022-12-13
| Rendered using Apache Maven Fluido Skin 1.7
-->
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <meta name="Date-Revision-yyyymmdd" content="20221202" />
+ <meta name="Date-Revision-yyyymmdd" content="20221213" />
<meta http-equiv="Content-Language" content="en" />
<title>Knox Gateway – Project Team</title>
<link rel="stylesheet" href="./css/apache-maven-fluido-1.7.min.css" />
@@ -40,7 +40,7 @@
<div id="breadcrumbs">
<ul class="breadcrumb">
- <li id="publishDate">Last Published: 2022-12-02</li>
+ <li id="publishDate">Last Published: 2022-12-13</li>
</ul>
</div>
<div class="row-fluid">
Modified: knox/trunk/books/2.0.0/service_webhdfs.md
URL: http://svn.apache.org/viewvc/knox/trunk/books/2.0.0/service_webhdfs.md?rev=1905966&r1=1905965&r2=1905966&view=diff
==============================================================================
--- knox/trunk/books/2.0.0/service_webhdfs.md (original)
+++ knox/trunk/books/2.0.0/service_webhdfs.md Tue Dec 13 14:39:56 2022
@@ -292,7 +292,7 @@ Users can use cURL to directly invoke th
### WebHDFS HA ###
-Knox provides basic failover and retry functionality for REST API calls made to WebHDFS when HDFS HA has been
+Knox provides basic failover functionality for REST API calls made to WebHDFS when HDFS HA has been
configured and enabled.
To enable HA functionality for WebHDFS in Knox the following configuration has to be added to the topology file.
@@ -303,7 +303,7 @@ To enable HA functionality for WebHDFS i
<enabled>true</enabled>
<param>
<name>WEBHDFS</name>
- <value>maxFailoverAttempts=3;failoverSleep=1000;maxRetryAttempts=300;retrySleep=1000;enabled=true</value>
+ <value>maxFailoverAttempts=3;failoverSleep=1000;enabled=true</value>
</param>
</provider>
@@ -322,14 +322,6 @@ will be tried again (the list will start
* failoverSleep -
The amount of time in milliseconds that the process will wait or sleep before attempting to failover.
-* maxRetryAttempts -
-The is the maximum number of times that a retry request will be attempted. Unlike failover, the retry is done on the
-same URL that failed. This is a special case in HDFS when the node is in safe mode. The expectation is that the node will
-come out of safe mode so a retry is desirable here as opposed to a failover.
-
-* retrySleep -
-The amount of time in milliseconds that the process will wait or sleep before a retry is issued.
-
* enabled -
Flag to turn the particular service on or off for HA.
Modified: knox/trunk/build.xml
URL: http://svn.apache.org/viewvc/knox/trunk/build.xml?rev=1905966&r1=1905965&r2=1905966&view=diff
==============================================================================
--- knox/trunk/build.xml (original)
+++ knox/trunk/build.xml Tue Dec 13 14:39:56 2022
@@ -85,7 +85,7 @@
</target>
<target name="books" depends="markbook,_books"/>
- <target name="_books" depends="_book-0-12-0,_book-0-13-0,_book-0-14-0,_book-1-0-0,_book-1-1-0,_book-1-2-0,_book-1-3-0,_book-1-4-0,_book-1-5-0,_book-1-6-0,_book-2-0-0"/>
+ <target name="_books" depends="_book-2-0-0"/>
<target name="_book-0-12-0" depends="init">
<delete dir="${book-target}/${gateway-artifact}-0-12-0" includes="**/*.html,**/*.css,**/*.png"/>
<java jar="markbook/target/markbook.jar" fork="true" failonerror="true">