nifi-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From joew...@apache.org
Subject [1/4] incubator-nifi git commit: NIFI-520 added explanation of enabling and disabling controller services. Also fixed images in that section and added some explanation about file expiration in the Connecting Components section.
Date Tue, 21 Apr 2015 19:24:10 GMT
Repository: incubator-nifi
Updated Branches:
  refs/heads/NIFI-271 bcb3ca8f9 -> afb4fe52b


NIFI-520 added explanation of enabling and disabling controller services. Also fixed images
in that section and added some explanation about file expiration in the Connecting Components
section.


Project: http://git-wip-us.apache.org/repos/asf/incubator-nifi/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-nifi/commit/574e57a4
Tree: http://git-wip-us.apache.org/repos/asf/incubator-nifi/tree/574e57a4
Diff: http://git-wip-us.apache.org/repos/asf/incubator-nifi/diff/574e57a4

Branch: refs/heads/NIFI-271
Commit: 574e57a4fbf57857cba05b605e05212e36aa485d
Parents: 13cd2a6
Author: Jenn Barnabee <jennifer.barnabee@gmail.com>
Authored: Sun Apr 19 16:01:19 2015 -0400
Committer: Jenn Barnabee <jennifer.barnabee@gmail.com>
Committed: Sun Apr 19 16:01:19 2015 -0400

----------------------------------------------------------------------
 .../images/add-controller-service-window.png    | Bin 155417 -> 157241 bytes
 .../images/controller-services-edit-buttons.png | Bin 5049 -> 22294 bytes
 .../controller-services-edit-buttons2.png       | Bin 0 -> 21845 bytes
 .../asciidoc/images/controller-services-tab.png | Bin 166310 -> 167278 bytes
 .../images/reporting-tasks-edit-buttons2.png    | Bin 0 -> 17525 bytes
 .../asciidoc/images/reporting-tasks-tab.png     | Bin 158876 -> 161551 bytes
 .../asciidoc/images/settings-general-tab.png    | Bin 129148 -> 132657 bytes
 .../nifi-docs/src/main/asciidoc/user-guide.adoc |  12 +++++++-----
 8 files changed, 7 insertions(+), 5 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-nifi/blob/574e57a4/nifi/nifi-docs/src/main/asciidoc/images/add-controller-service-window.png
----------------------------------------------------------------------
diff --git a/nifi/nifi-docs/src/main/asciidoc/images/add-controller-service-window.png b/nifi/nifi-docs/src/main/asciidoc/images/add-controller-service-window.png
index a692d5d..b727a9e 100644
Binary files a/nifi/nifi-docs/src/main/asciidoc/images/add-controller-service-window.png and
b/nifi/nifi-docs/src/main/asciidoc/images/add-controller-service-window.png differ

http://git-wip-us.apache.org/repos/asf/incubator-nifi/blob/574e57a4/nifi/nifi-docs/src/main/asciidoc/images/controller-services-edit-buttons.png
----------------------------------------------------------------------
diff --git a/nifi/nifi-docs/src/main/asciidoc/images/controller-services-edit-buttons.png
b/nifi/nifi-docs/src/main/asciidoc/images/controller-services-edit-buttons.png
index 9b721da..5ca61d9 100644
Binary files a/nifi/nifi-docs/src/main/asciidoc/images/controller-services-edit-buttons.png
and b/nifi/nifi-docs/src/main/asciidoc/images/controller-services-edit-buttons.png differ

http://git-wip-us.apache.org/repos/asf/incubator-nifi/blob/574e57a4/nifi/nifi-docs/src/main/asciidoc/images/controller-services-edit-buttons2.png
----------------------------------------------------------------------
diff --git a/nifi/nifi-docs/src/main/asciidoc/images/controller-services-edit-buttons2.png
b/nifi/nifi-docs/src/main/asciidoc/images/controller-services-edit-buttons2.png
new file mode 100644
index 0000000..ee3a5f7
Binary files /dev/null and b/nifi/nifi-docs/src/main/asciidoc/images/controller-services-edit-buttons2.png
differ

http://git-wip-us.apache.org/repos/asf/incubator-nifi/blob/574e57a4/nifi/nifi-docs/src/main/asciidoc/images/controller-services-tab.png
----------------------------------------------------------------------
diff --git a/nifi/nifi-docs/src/main/asciidoc/images/controller-services-tab.png b/nifi/nifi-docs/src/main/asciidoc/images/controller-services-tab.png
index 0656c7c..f6d76b8 100644
Binary files a/nifi/nifi-docs/src/main/asciidoc/images/controller-services-tab.png and b/nifi/nifi-docs/src/main/asciidoc/images/controller-services-tab.png
differ

http://git-wip-us.apache.org/repos/asf/incubator-nifi/blob/574e57a4/nifi/nifi-docs/src/main/asciidoc/images/reporting-tasks-edit-buttons2.png
----------------------------------------------------------------------
diff --git a/nifi/nifi-docs/src/main/asciidoc/images/reporting-tasks-edit-buttons2.png b/nifi/nifi-docs/src/main/asciidoc/images/reporting-tasks-edit-buttons2.png
new file mode 100644
index 0000000..70a9d50
Binary files /dev/null and b/nifi/nifi-docs/src/main/asciidoc/images/reporting-tasks-edit-buttons2.png
differ

http://git-wip-us.apache.org/repos/asf/incubator-nifi/blob/574e57a4/nifi/nifi-docs/src/main/asciidoc/images/reporting-tasks-tab.png
----------------------------------------------------------------------
diff --git a/nifi/nifi-docs/src/main/asciidoc/images/reporting-tasks-tab.png b/nifi/nifi-docs/src/main/asciidoc/images/reporting-tasks-tab.png
index edf9794..26e8324 100644
Binary files a/nifi/nifi-docs/src/main/asciidoc/images/reporting-tasks-tab.png and b/nifi/nifi-docs/src/main/asciidoc/images/reporting-tasks-tab.png
differ

http://git-wip-us.apache.org/repos/asf/incubator-nifi/blob/574e57a4/nifi/nifi-docs/src/main/asciidoc/images/settings-general-tab.png
----------------------------------------------------------------------
diff --git a/nifi/nifi-docs/src/main/asciidoc/images/settings-general-tab.png b/nifi/nifi-docs/src/main/asciidoc/images/settings-general-tab.png
index 2b9189a..2260581 100644
Binary files a/nifi/nifi-docs/src/main/asciidoc/images/settings-general-tab.png and b/nifi/nifi-docs/src/main/asciidoc/images/settings-general-tab.png
differ

http://git-wip-us.apache.org/repos/asf/incubator-nifi/blob/574e57a4/nifi/nifi-docs/src/main/asciidoc/user-guide.adoc
----------------------------------------------------------------------
diff --git a/nifi/nifi-docs/src/main/asciidoc/user-guide.adoc b/nifi/nifi-docs/src/main/asciidoc/user-guide.adoc
index e94af74..7386b72 100644
--- a/nifi/nifi-docs/src/main/asciidoc/user-guide.adoc
+++ b/nifi/nifi-docs/src/main/asciidoc/user-guide.adoc
@@ -70,7 +70,7 @@ Terminology
 	This allows data to be routed in different ways based on its processing outcome. Each connection
houses a FlowFile Queue.
 	When a FlowFile is transferred to a particular Relationship, it is added to the queue belonging
to the associated Connection.
 
-*Controller Service*: Controller Services are extension points that, after being added and
configured by a DFM in the User Interface, will start up when NiFi starts up and provide information
for use by other components (processors). A common Controller Service used by several processors
is the StandardSSLContextService. It provides the ability to configure keystore and/or truststore
properties once and reuse that configuration throughout the application. The idea is that,
rather than configure this information in every processor that might need it, the controller
service provides it for any processor to use as needed.
+*Controller Service*: Controller Services are extension points that, after being added and
configured by a DFM in the User Interface, will start up when NiFi starts up and provide information
for use by other components (such as processors or other controller services). A common Controller
Service used by several components is the StandardSSLContextService. It provides the ability
to configure keystore and/or truststore properties once and reuse that configuration throughout
the application. The idea is that, rather than configure this information in every processor
that might need it, the controller service provides it for any processor to use as needed.
 
 *Reporting Task*: Reporting Tasks run in the background to provide statistical reports about
what is happening in the NiFi instance. The DFM adds and configures Reporting Tasks in the
User Interface as desired. Common reporting tasks include the ControllerStatusReportingTask,
MonitorDiskUsage reporting task, MonitorMemory reporting task, and the StandardGangliaReporter.
 
@@ -480,13 +480,15 @@ image:configure-controller-service-properties.png["Configure Controller
Service
 
 The Comments tab is just an open-text field, where the DFM may include comments about the
service. After configuring a Controller Service, click the Apply button to apply the configuration
and close the window, or click the Cancel button to cancel the changes and close the window.
 
-The Reporting Tasks tab behaves exactly the same way as the Controller Services tab. The
DFM has the option to add Reporting Tasks and configure them in the same way as Controller
Services.
+Note that after a Controller Service has been configured, it must be enabled in order to
run. Do this using the Enable button in the far-right column of the Controller Services tab
of the Controller Settings window. Then, in order to modify an existing/running controller
service, the DFM needs to stop/disable it (as well as all referencing processors, reporting
tasks, and controller services). Rather than having to hunt down each component that is referenced
by that controller service, the DFM has the ability to stop/disable them when disabling the
controller service in question. Likewise, when enabling a controller service, the DFM has
the option to start/enable all referencing processors, reporting tasks, and controller services.
+
+The Reporting Tasks tab behaves similarly to the Controller Services tab. The DFM has the
option to add Reporting Tasks and configure them in the same way as Controller Services.
 
 image:reporting-tasks-tab.png["Reporting Tasks Tab", width=900]
 
 Once a Reporting Task has been added, the DFM may configure it by clicking the Edit (pencil
icon) in the far-right column. Other buttons in this column include the Start button, Remove
button, and Usage button, which links to the documentation for the particular Reporting Task.
 
-image:reporting-tasks-edit-buttons.png["Reporting Tasks Buttons"]
+image:reporting-tasks-edit-buttons2.png["Reporting Tasks Buttons"]
 
 When the DFM clicks the Edit button, a Configure Reporting Task window opens. It has three
tabs: Settings, Properties, and Comments. This window is also similar to the Configure Processor
window. The Settings tab provides a place for the DFM to give the Reporting Task a unique
name (if desired). It also lists a UUID for the Reporting Task and provides settings for the
task's Scheduling Strategy and Run Schedule (similar to the same settings in a processor).
The DFM may hover the mouse over the question mark icons to see more information about each
setting.
 
@@ -544,8 +546,8 @@ that are active for the Connection.
 File expiration is a concept by which data that cannot be processed in a timely fashion can
be automatically removed from the flow.
 This is useful, for example, when the volume of data is expected to exceed the volume that
can be sent to a remote site.
 In this case, the expiration can be used in conjunction with Prioritizers to ensure that
the highest priority data is
-processed first and then anything that cannot be processed within a certain time period (one
hour, for example) can be dropped. The default
-value of `0 sec` indicates that the data will never expire.
+processed first and then anything that cannot be processed within a certain time period (one
hour, for example) can be dropped. The expiration period is based on the time that the data
entered the NiFi instance. In other words, if the file expiration on a given connection is
set to '1 hour', and a file that has been in the NiFi instance for one hour reaches that connection,
it will expire. The default
+value of `0 sec` indicates that the data will never expire. When a file expiration other
than '0 sec' is set, a small clock icon appears on the connection label, so the DFM can see
it at-a-glance when looking at a flow on the graph.
 
 
 NiFi provides two configuration elements for Back Pressure. These thresholds indicate how
much data should be


Mime
View raw message