You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@flume.apache.org by hs...@apache.org on 2014/11/19 04:36:19 UTC
svn commit: r1640475 - in /flume/site/trunk/content/sphinx:
FlumeDeveloperGuide.rst FlumeUserGuide.rst download.rst index.rst
releases/index.rst
Author: hshreedharan
Date: Wed Nov 19 03:36:18 2014
New Revision: 1640475
URL: http://svn.apache.org/r1640475
Log:
Adding docs for Apache Flume 1.5.2 release
Modified:
flume/site/trunk/content/sphinx/FlumeDeveloperGuide.rst
flume/site/trunk/content/sphinx/FlumeUserGuide.rst
flume/site/trunk/content/sphinx/download.rst
flume/site/trunk/content/sphinx/index.rst
flume/site/trunk/content/sphinx/releases/index.rst
Modified: flume/site/trunk/content/sphinx/FlumeDeveloperGuide.rst
URL: http://svn.apache.org/viewvc/flume/site/trunk/content/sphinx/FlumeDeveloperGuide.rst?rev=1640475&r1=1640474&r2=1640475&view=diff
==============================================================================
--- flume/site/trunk/content/sphinx/FlumeDeveloperGuide.rst (original)
+++ flume/site/trunk/content/sphinx/FlumeDeveloperGuide.rst Wed Nov 19 03:36:18 2014
@@ -15,7 +15,7 @@
======================================
-Flume 1.5.0.1 Developer Guide
+Flume 1.5.2 Developer Guide
======================================
Introduction
Modified: flume/site/trunk/content/sphinx/FlumeUserGuide.rst
URL: http://svn.apache.org/viewvc/flume/site/trunk/content/sphinx/FlumeUserGuide.rst?rev=1640475&r1=1640474&r2=1640475&view=diff
==============================================================================
--- flume/site/trunk/content/sphinx/FlumeUserGuide.rst (original)
+++ flume/site/trunk/content/sphinx/FlumeUserGuide.rst Wed Nov 19 03:36:18 2014
@@ -15,7 +15,7 @@
======================================
-Flume 1.5.0.1 User Guide
+Flume 1.5.2 User Guide
======================================
Introduction
@@ -688,26 +688,27 @@ When paired with the built-in Avro Sink
it can create tiered collection topologies.
Required properties are in **bold**.
-================== =========== ===================================================
-Property Name Default Description
-================== =========== ===================================================
+================== ================ ===================================================
+Property Name Default Description
+================== ================ ===================================================
**channels** --
-**type** -- The component type name, needs to be ``avro``
-**bind** -- hostname or IP address to listen on
-**port** -- Port # to bind to
-threads -- Maximum number of worker threads to spawn
+**type** -- The component type name, needs to be ``avro``
+**bind** -- hostname or IP address to listen on
+**port** -- Port # to bind to
+threads -- Maximum number of worker threads to spawn
selector.type
selector.*
-interceptors -- Space-separated list of interceptors
+interceptors -- Space-separated list of interceptors
interceptors.*
-compression-type none This can be "none" or "deflate". The compression-type must match the compression-type of matching AvroSource
-ssl false Set this to true to enable SSL encryption. You must also specify a "keystore" and a "keystore-password".
-keystore -- This is the path to a Java keystore file. Required for SSL.
-keystore-password -- The password for the Java keystore. Required for SSL.
-keystore-type JKS The type of the Java keystore. This can be "JKS" or "PKCS12".
-ipFilter false Set this to true to enable ipFiltering for netty
-ipFilter.rules -- Define N netty ipFilter pattern rules with this config.
-================== =========== ===================================================
+compression-type none This can be "none" or "deflate". The compression-type must match the compression-type of matching AvroSource
+ssl false Set this to true to enable SSL encryption. You must also specify a "keystore" and a "keystore-password".
+keystore -- This is the path to a Java keystore file. Required for SSL.
+keystore-password -- The password for the Java keystore. Required for SSL.
+keystore-type JKS The type of the Java keystore. This can be "JKS" or "PKCS12".
+exclude-protocols SSLv3 Space-separated list of SSL/TLS protocols to exclude. SSLv3 will always be excluded in addition to the protocols specified.
+ipFilter false Set this to true to enable ipFiltering for netty
+ipFilter.rules -- Define N netty ipFilter pattern rules with this config.
+================== ================ ===================================================
Example for agent named a1:
@@ -1291,22 +1292,23 @@ unavailable status.
All events sent in one post request are considered to be one batch and
inserted into the channel in one transaction.
-============== ============================================ ====================================================================
-Property Name Default Description
-============== ============================================ ====================================================================
-**type** The component type name, needs to be ``http``
-**port** -- The port the source should bind to.
-bind 0.0.0.0 The hostname or IP address to listen on
-handler ``org.apache.flume.source.http.JSONHandler`` The FQCN of the handler class.
-handler.* -- Config parameters for the handler
-selector.type replicating replicating or multiplexing
-selector.* Depends on the selector.type value
-interceptors -- Space-separated list of interceptors
+================= ============================================ =====================================================================================
+Property Name Default Description
+================= ============================================ =====================================================================================
+**type** The component type name, needs to be ``http``
+**port** -- The port the source should bind to.
+bind 0.0.0.0 The hostname or IP address to listen on
+handler ``org.apache.flume.source.http.JSONHandler`` The FQCN of the handler class.
+handler.* -- Config parameters for the handler
+selector.type replicating replicating or multiplexing
+selector.* Depends on the selector.type value
+interceptors -- Space-separated list of interceptors
interceptors.*
-enableSSL false Set the property true, to enable SSL
-keystore Location of the keystore includng keystore file name
-keystorePassword Keystore password
-==================================================================================================================================
+enableSSL false Set the property true, to enable SSL. *HTTP Source does not support SSLv3.*
+excludeProtocols SSLv3 Space-separated list of SSL/TLS protocols to exclude. SSLv3 is always excluded.
+keystore Location of the keystore includng keystore file name
+keystorePassword Keystore password
+======================================================================================================================================================
For example, a http source for agent named a1:
@@ -1660,7 +1662,7 @@ batches of the configured batch size.
Required properties are in **bold**.
========================== ===================================================== ===========================================================================================
-Property Name Default Description
+Property Name Default Description
========================== ===================================================== ===========================================================================================
**channel** --
**type** -- The component type name, needs to be ``avro``.
@@ -1677,6 +1679,7 @@ trust-all-certs false
truststore -- The path to a custom Java truststore file. Flume uses the certificate authority information in this file to determine whether the remote Avro Source's SSL authentication credentials should be trusted. If not specified, the default Java JSSE certificate authority files (typically "jssecacerts" or "cacerts" in the Oracle JRE) will be used.
truststore-password -- The password for the specified truststore.
truststore-type JKS The type of the Java truststore. This can be "JKS" or other supported Java truststore type.
+exclude-protocols SSLv2Hello SSLv3 Space-separated list of SSL/TLS protocols to exclude
maxIoWorkers 2 * the number of available processors in the machine The maximum number of I/O worker threads. This is configured on the NettyAvroRpcClient NioClientSocketChannelFactory.
========================== ===================================================== ===========================================================================================
@@ -2944,7 +2947,7 @@ Log4J Appender
Appends Log4j events to a flume agent's avro source. A client using this
appender must have the flume-ng-sdk in the classpath (eg,
-flume-ng-sdk-1.5.0.1.jar).
+flume-ng-sdk-1.5.2.jar).
Required properties are in **bold**.
===================== ======= ==================================================================================
@@ -3008,7 +3011,7 @@ Load Balancing Log4J Appender
Appends Log4j events to a list of flume agent's avro source. A client using this
appender must have the flume-ng-sdk in the classpath (eg,
-flume-ng-sdk-1.5.0.1.jar). This appender supports a round-robin and random
+flume-ng-sdk-1.5.2.jar). This appender supports a round-robin and random
scheme for performing the load balancing. It also supports a configurable backoff
timeout so that down agents are removed temporarily from the set of hosts
Required properties are in **bold**.
Modified: flume/site/trunk/content/sphinx/download.rst
URL: http://svn.apache.org/viewvc/flume/site/trunk/content/sphinx/download.rst?rev=1640475&r1=1640474&r2=1640475&view=diff
==============================================================================
--- flume/site/trunk/content/sphinx/download.rst (original)
+++ flume/site/trunk/content/sphinx/download.rst Wed Nov 19 03:36:18 2014
@@ -10,8 +10,8 @@ originals on the main distribution serve
.. csv-table::
- "Apache Flume binary (tar.gz)", `apache-flume-1.5.0.1-bin.tar.gz <http://www.apache.org/dyn/closer.cgi/flume/1.5.0.1/apache-flume-1.5.0.1-bin.tar.gz>`_, `apache-flume-1.5.0.1-bin.tar.gz.md5 <http://www.us.apache.org/dist/flume/1.5.0.1/apache-flume-1.5.0.1-bin.tar.gz.md5>`_, `apache-flume-1.5.0.1-bin.tar.gz.asc <http://www.us.apache.org/dist/flume/1.5.0.1/apache-flume-1.5.0.1-bin.tar.gz.asc>`_
- "Apache Flume source (tar.gz)", `apache-flume-1.5.0.1-src.tar.gz <http://www.apache.org/dyn/closer.cgi/flume/1.5.0.1/apache-flume-1.5.0.1-src.tar.gz>`_, `apache-flume-1.5.0.1-src.tar.gz.md5 <http://www.us.apache.org/dist/flume/1.5.0.1/apache-flume-1.5.0.1-src.tar.gz.md5>`_, `apache-flume-1.5.0.1-src.tar.gz.asc <http://www.us.apache.org/dist/flume/1.5.0.1/apache-flume-1.5.0.1-src.tar.gz.asc>`_
+ "Apache Flume binary (tar.gz)", `apache-flume-1.5.2-bin.tar.gz <http://www.apache.org/dyn/closer.cgi/flume/1.5.2/apache-flume-1.5.2-bin.tar.gz>`_, `apache-flume-1.5.2-bin.tar.gz.md5 <http://www.us.apache.org/dist/flume/1.5.2/apache-flume-1.5.2-bin.tar.gz.md5>`_, `apache-flume-1.5.2-bin.tar.gz.asc <http://www.us.apache.org/dist/flume/1.5.2/apache-flume-1.5.2-bin.tar.gz.asc>`_
+ "Apache Flume source (tar.gz)", `apache-flume-1.5.2-src.tar.gz <http://www.apache.org/dyn/closer.cgi/flume/1.5.2/apache-flume-1.5.2-src.tar.gz>`_, `apache-flume-1.5.2-src.tar.gz.md5 <http://www.us.apache.org/dist/flume/1.5.2/apache-flume-1.5.2-src.tar.gz.md5>`_, `apache-flume-1.5.2-src.tar.gz.asc <http://www.us.apache.org/dist/flume/1.5.2/apache-flume-1.5.2-src.tar.gz.asc>`_
It is essential that you verify the integrity of the downloaded files using the PGP or MD5 signatures. Please read
`Verifying Apache HTTP Server Releases <http://httpd.apache.org/dev/verification.html>`_ for more information on
@@ -23,9 +23,9 @@ as well as the asc signature file for th
Then verify the signatures using::
% gpg --import KEYS
- % gpg --verify apache-flume-1.5.0.1-src.tar.gz.asc
+ % gpg --verify apache-flume-1.5.2-src.tar.gz.asc
-Apache Flume 1.5.0.1 is signed by Hari Shreedharan 77FFC9AB
+Apache Flume 1.5.2 is signed by Hari Shreedharan 77FFC9AB
Alternatively, you can verify the MD5 or SHA1 signatures of the files. A program called md5, md5sum, or shasum is included in many
Unix distributions for this purpose.
Modified: flume/site/trunk/content/sphinx/index.rst
URL: http://svn.apache.org/viewvc/flume/site/trunk/content/sphinx/index.rst?rev=1640475&r1=1640474&r2=1640475&view=diff
==============================================================================
--- flume/site/trunk/content/sphinx/index.rst (original)
+++ flume/site/trunk/content/sphinx/index.rst Wed Nov 19 03:36:18 2014
@@ -33,6 +33,34 @@ application.
.. raw:: html
+ <h3>November 18, 2014 - Apache Flume 1.5.2 Released</h3>
+
+The Apache Flume team is pleased to announce the release of Flume 1.5.2
+
+Flume is a distributed, reliable, and available service for efficiently
+collecting, aggregating, and moving large amounts of streaming event data.
+
+Version 1.5.2 is the eighth Flume release as an Apache top-level project.
+Flume 1.5.2 is stable, production-ready software, and is backwards-compatible
+with previous versions of the Flume 1.x codeline.
+
+Apache Flume 1.5.2 is a security and maintenance release that disables SSLv3
+on all components in Flume that support SSL/TLS. All users are encouraged to
+update to this release as soon as possible.
+
+The full change log and documentation are available on the
+`Flume 1.5.2 release page <releases/1.5.2.html>`__.
+
+This release can be downloaded from the Flume `Download <download.html>`__ page.
+
+Your contributions, feedback, help and support make Flume better!
+For more information on how to report problems or contribute,
+please visit our `Get Involved <getinvolved.html>`__ page.
+
+The Apache Flume Team
+
+.. raw:: html
+
<h3>July 16, 2014 - Apache Flume 1.5.0.1 Released</h3>
The Apache Flume team is pleased to announce the release of Flume 1.5.0.1
Modified: flume/site/trunk/content/sphinx/releases/index.rst
URL: http://svn.apache.org/viewvc/flume/site/trunk/content/sphinx/releases/index.rst?rev=1640475&r1=1640474&r2=1640475&view=diff
==============================================================================
--- flume/site/trunk/content/sphinx/releases/index.rst (original)
+++ flume/site/trunk/content/sphinx/releases/index.rst Wed Nov 19 03:36:18 2014
@@ -3,13 +3,13 @@ Releases
.. rubric:: Current Release
-The current stable release is `Apache Flume Version 1.5.0.1 <1.5.0.1.html>`__.
+The current stable release is `Apache Flume Version 1.5.2 <1.5.2.html>`__.
.. toctree::
:maxdepth: 1
:hidden:
- 1.5.0.1
+ 1.5.2
.. rubric:: Previous Releases
@@ -17,6 +17,7 @@ The current stable release is `Apache Fl
:maxdepth: 1
:glob:
+ 1.5.0.1
1.5.0
1.4.0
1.3.1