Repository: nifi Updated Branches: refs/heads/master a8de27e69 -> 49270f8a8
NIFI-3944 Update docs and screenshots for Component Versioning Signed-off-by: Scott Aslan <[email protected]> This closes #1840 Project: http://git-wip-us.apache.org/repos/asf/nifi/repo Commit: http://git-wip-us.apache.org/repos/asf/nifi/commit/49270f8a Tree: http://git-wip-us.apache.org/repos/asf/nifi/tree/49270f8a Diff: http://git-wip-us.apache.org/repos/asf/nifi/diff/49270f8a Branch: refs/heads/master Commit: 49270f8a8c3968a53662922d44f8396358441a36 Parents: a8de27e Author: Andrew Lim <[email protected]> Authored: Mon May 22 16:49:42 2017 -0400 Committer: Scott Aslan <[email protected]> Committed: Tue May 23 11:06:59 2017 -0400 ---------------------------------------------------------------------- .../images/add-processor-version-example.png | Bin 0 -> 106925 bytes .../add-processor-version-sort-filter.png | Bin 0 -> 101860 bytes .../images/add-processor-with-tag-cloud.png | Bin 57216 -> 191726 bytes .../src/main/asciidoc/images/add-processor.png | Bin 131312 -> 207847 bytes .../src/main/asciidoc/images/comments-tab.png | Bin 9932 -> 27732 bytes .../images/component-version-dialog.png | Bin 42359 -> 38579 bytes ...igure-processor-with-version-information.png | Bin 71779 -> 61205 bytes .../images/create-service-ssl-context.png | Bin 45717 -> 122359 bytes .../asciidoc/images/edit-property-dropdown.png | Bin 18739 -> 54487 bytes .../asciidoc/images/edit-property-textarea.png | Bin 22747 -> 45199 bytes .../src/main/asciidoc/images/global-menu.png | Bin 26061 -> 32770 bytes .../src/main/asciidoc/images/iconDelete.png | Bin 321 -> 574 bytes .../main/asciidoc/images/invalid-processor.png | Bin 9174 -> 24908 bytes .../images/nifi-connection-bend-points.png | Bin 63932 -> 105840 bytes .../main/asciidoc/images/nifi-connection.png | Bin 57720 -> 88506 bytes .../asciidoc/images/nifi-process-group-menu.png | Bin 43969 -> 58684 bytes .../asciidoc/images/nifi-processor-menu.png | Bin 56966 -> 67930 bytes .../src/main/asciidoc/images/nifi-rpg-menu.png | Bin 48000 -> 66201 bytes .../images/processor-change-version.png | Bin 0 -> 82455 bytes .../images/processor-connection-bubble.png | Bin 19771 -> 27301 bytes .../images/processor-cs-version-match.png | Bin 0 -> 42501 bytes .../processor-cs-version-mismatch-config.png | Bin 0 -> 45439 bytes .../processor-cs-version-mismatch-warnings.png | Bin 0 -> 89339 bytes .../processor-version-information-example.png | Bin 0 -> 31717 bytes .../src/main/asciidoc/images/properties-tab.png | Bin 15954 -> 36781 bytes .../src/main/asciidoc/images/restricted.png | Bin 3514 -> 603 bytes .../src/main/asciidoc/images/scheduling-tab.png | Bin 21715 -> 49115 bytes .../src/main/asciidoc/images/settings-tab.png | Bin 30171 -> 72140 bytes .../src/main/asciidoc/images/simple-flow.png | Bin 47874 -> 63663 bytes .../main/asciidoc/images/valid-processor.png | Bin 9553 -> 24664 bytes nifi-docs/src/main/asciidoc/user-guide.adoc | 53 ++++++++++++++----- 31 files changed, 40 insertions(+), 13 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/nifi/blob/49270f8a/nifi-docs/src/main/asciidoc/images/add-processor-version-example.png ---------------------------------------------------------------------- diff --git a/nifi-docs/src/main/asciidoc/images/add-processor-version-example.png b/nifi-docs/src/main/asciidoc/images/add-processor-version-example.png new file mode 100644 index 0000000..ba1115b Binary files /dev/null and b/nifi-docs/src/main/asciidoc/images/add-processor-version-example.png differ http://git-wip-us.apache.org/repos/asf/nifi/blob/49270f8a/nifi-docs/src/main/asciidoc/images/add-processor-version-sort-filter.png ---------------------------------------------------------------------- diff --git a/nifi-docs/src/main/asciidoc/images/add-processor-version-sort-filter.png b/nifi-docs/src/main/asciidoc/images/add-processor-version-sort-filter.png new file mode 100644 index 0000000..5461091 Binary files /dev/null and b/nifi-docs/src/main/asciidoc/images/add-processor-version-sort-filter.png differ http://git-wip-us.apache.org/repos/asf/nifi/blob/49270f8a/nifi-docs/src/main/asciidoc/images/add-processor-with-tag-cloud.png ---------------------------------------------------------------------- diff --git a/nifi-docs/src/main/asciidoc/images/add-processor-with-tag-cloud.png b/nifi-docs/src/main/asciidoc/images/add-processor-with-tag-cloud.png index 19d0f28..5581c56 100644 Binary files a/nifi-docs/src/main/asciidoc/images/add-processor-with-tag-cloud.png and b/nifi-docs/src/main/asciidoc/images/add-processor-with-tag-cloud.png differ http://git-wip-us.apache.org/repos/asf/nifi/blob/49270f8a/nifi-docs/src/main/asciidoc/images/add-processor.png ---------------------------------------------------------------------- diff --git a/nifi-docs/src/main/asciidoc/images/add-processor.png b/nifi-docs/src/main/asciidoc/images/add-processor.png index f625b6c..0b7cb60 100644 Binary files a/nifi-docs/src/main/asciidoc/images/add-processor.png and b/nifi-docs/src/main/asciidoc/images/add-processor.png differ http://git-wip-us.apache.org/repos/asf/nifi/blob/49270f8a/nifi-docs/src/main/asciidoc/images/comments-tab.png ---------------------------------------------------------------------- diff --git a/nifi-docs/src/main/asciidoc/images/comments-tab.png b/nifi-docs/src/main/asciidoc/images/comments-tab.png index f72c64b..589d7e4 100644 Binary files a/nifi-docs/src/main/asciidoc/images/comments-tab.png and b/nifi-docs/src/main/asciidoc/images/comments-tab.png differ http://git-wip-us.apache.org/repos/asf/nifi/blob/49270f8a/nifi-docs/src/main/asciidoc/images/component-version-dialog.png ---------------------------------------------------------------------- diff --git a/nifi-docs/src/main/asciidoc/images/component-version-dialog.png b/nifi-docs/src/main/asciidoc/images/component-version-dialog.png index 91b41f1..038f544 100644 Binary files a/nifi-docs/src/main/asciidoc/images/component-version-dialog.png and b/nifi-docs/src/main/asciidoc/images/component-version-dialog.png differ http://git-wip-us.apache.org/repos/asf/nifi/blob/49270f8a/nifi-docs/src/main/asciidoc/images/configure-processor-with-version-information.png ---------------------------------------------------------------------- diff --git a/nifi-docs/src/main/asciidoc/images/configure-processor-with-version-information.png b/nifi-docs/src/main/asciidoc/images/configure-processor-with-version-information.png index 397459c..23ed361 100644 Binary files a/nifi-docs/src/main/asciidoc/images/configure-processor-with-version-information.png and b/nifi-docs/src/main/asciidoc/images/configure-processor-with-version-information.png differ http://git-wip-us.apache.org/repos/asf/nifi/blob/49270f8a/nifi-docs/src/main/asciidoc/images/create-service-ssl-context.png ---------------------------------------------------------------------- diff --git a/nifi-docs/src/main/asciidoc/images/create-service-ssl-context.png b/nifi-docs/src/main/asciidoc/images/create-service-ssl-context.png index 81b73e1..cf597a9 100644 Binary files a/nifi-docs/src/main/asciidoc/images/create-service-ssl-context.png and b/nifi-docs/src/main/asciidoc/images/create-service-ssl-context.png differ http://git-wip-us.apache.org/repos/asf/nifi/blob/49270f8a/nifi-docs/src/main/asciidoc/images/edit-property-dropdown.png ---------------------------------------------------------------------- diff --git a/nifi-docs/src/main/asciidoc/images/edit-property-dropdown.png b/nifi-docs/src/main/asciidoc/images/edit-property-dropdown.png index 21938c4..2fd6f7d 100644 Binary files a/nifi-docs/src/main/asciidoc/images/edit-property-dropdown.png and b/nifi-docs/src/main/asciidoc/images/edit-property-dropdown.png differ http://git-wip-us.apache.org/repos/asf/nifi/blob/49270f8a/nifi-docs/src/main/asciidoc/images/edit-property-textarea.png ---------------------------------------------------------------------- diff --git a/nifi-docs/src/main/asciidoc/images/edit-property-textarea.png b/nifi-docs/src/main/asciidoc/images/edit-property-textarea.png index 40600e3..a40b5b7 100644 Binary files a/nifi-docs/src/main/asciidoc/images/edit-property-textarea.png and b/nifi-docs/src/main/asciidoc/images/edit-property-textarea.png differ http://git-wip-us.apache.org/repos/asf/nifi/blob/49270f8a/nifi-docs/src/main/asciidoc/images/global-menu.png ---------------------------------------------------------------------- diff --git a/nifi-docs/src/main/asciidoc/images/global-menu.png b/nifi-docs/src/main/asciidoc/images/global-menu.png index ccfe191..e6ad625 100644 Binary files a/nifi-docs/src/main/asciidoc/images/global-menu.png and b/nifi-docs/src/main/asciidoc/images/global-menu.png differ http://git-wip-us.apache.org/repos/asf/nifi/blob/49270f8a/nifi-docs/src/main/asciidoc/images/iconDelete.png ---------------------------------------------------------------------- diff --git a/nifi-docs/src/main/asciidoc/images/iconDelete.png b/nifi-docs/src/main/asciidoc/images/iconDelete.png index 3f69468..b6ff7cb 100644 Binary files a/nifi-docs/src/main/asciidoc/images/iconDelete.png and b/nifi-docs/src/main/asciidoc/images/iconDelete.png differ http://git-wip-us.apache.org/repos/asf/nifi/blob/49270f8a/nifi-docs/src/main/asciidoc/images/invalid-processor.png ---------------------------------------------------------------------- diff --git a/nifi-docs/src/main/asciidoc/images/invalid-processor.png b/nifi-docs/src/main/asciidoc/images/invalid-processor.png index 79014dd..799ccd1 100644 Binary files a/nifi-docs/src/main/asciidoc/images/invalid-processor.png and b/nifi-docs/src/main/asciidoc/images/invalid-processor.png differ http://git-wip-us.apache.org/repos/asf/nifi/blob/49270f8a/nifi-docs/src/main/asciidoc/images/nifi-connection-bend-points.png ---------------------------------------------------------------------- diff --git a/nifi-docs/src/main/asciidoc/images/nifi-connection-bend-points.png b/nifi-docs/src/main/asciidoc/images/nifi-connection-bend-points.png index 24bd24d..4c95261 100644 Binary files a/nifi-docs/src/main/asciidoc/images/nifi-connection-bend-points.png and b/nifi-docs/src/main/asciidoc/images/nifi-connection-bend-points.png differ http://git-wip-us.apache.org/repos/asf/nifi/blob/49270f8a/nifi-docs/src/main/asciidoc/images/nifi-connection.png ---------------------------------------------------------------------- diff --git a/nifi-docs/src/main/asciidoc/images/nifi-connection.png b/nifi-docs/src/main/asciidoc/images/nifi-connection.png index 7c4be81..49053f2 100644 Binary files a/nifi-docs/src/main/asciidoc/images/nifi-connection.png and b/nifi-docs/src/main/asciidoc/images/nifi-connection.png differ http://git-wip-us.apache.org/repos/asf/nifi/blob/49270f8a/nifi-docs/src/main/asciidoc/images/nifi-process-group-menu.png ---------------------------------------------------------------------- diff --git a/nifi-docs/src/main/asciidoc/images/nifi-process-group-menu.png b/nifi-docs/src/main/asciidoc/images/nifi-process-group-menu.png index 53ed720..8dfc0ee 100644 Binary files a/nifi-docs/src/main/asciidoc/images/nifi-process-group-menu.png and b/nifi-docs/src/main/asciidoc/images/nifi-process-group-menu.png differ http://git-wip-us.apache.org/repos/asf/nifi/blob/49270f8a/nifi-docs/src/main/asciidoc/images/nifi-processor-menu.png ---------------------------------------------------------------------- diff --git a/nifi-docs/src/main/asciidoc/images/nifi-processor-menu.png b/nifi-docs/src/main/asciidoc/images/nifi-processor-menu.png index 1f6364b..4a5b3d1 100644 Binary files a/nifi-docs/src/main/asciidoc/images/nifi-processor-menu.png and b/nifi-docs/src/main/asciidoc/images/nifi-processor-menu.png differ http://git-wip-us.apache.org/repos/asf/nifi/blob/49270f8a/nifi-docs/src/main/asciidoc/images/nifi-rpg-menu.png ---------------------------------------------------------------------- diff --git a/nifi-docs/src/main/asciidoc/images/nifi-rpg-menu.png b/nifi-docs/src/main/asciidoc/images/nifi-rpg-menu.png index 4ca091e..1db8be9 100644 Binary files a/nifi-docs/src/main/asciidoc/images/nifi-rpg-menu.png and b/nifi-docs/src/main/asciidoc/images/nifi-rpg-menu.png differ http://git-wip-us.apache.org/repos/asf/nifi/blob/49270f8a/nifi-docs/src/main/asciidoc/images/processor-change-version.png ---------------------------------------------------------------------- diff --git a/nifi-docs/src/main/asciidoc/images/processor-change-version.png b/nifi-docs/src/main/asciidoc/images/processor-change-version.png new file mode 100644 index 0000000..a4531fb Binary files /dev/null and b/nifi-docs/src/main/asciidoc/images/processor-change-version.png differ http://git-wip-us.apache.org/repos/asf/nifi/blob/49270f8a/nifi-docs/src/main/asciidoc/images/processor-connection-bubble.png ---------------------------------------------------------------------- diff --git a/nifi-docs/src/main/asciidoc/images/processor-connection-bubble.png b/nifi-docs/src/main/asciidoc/images/processor-connection-bubble.png index 9d658d3..9fa3dc8 100644 Binary files a/nifi-docs/src/main/asciidoc/images/processor-connection-bubble.png and b/nifi-docs/src/main/asciidoc/images/processor-connection-bubble.png differ http://git-wip-us.apache.org/repos/asf/nifi/blob/49270f8a/nifi-docs/src/main/asciidoc/images/processor-cs-version-match.png ---------------------------------------------------------------------- diff --git a/nifi-docs/src/main/asciidoc/images/processor-cs-version-match.png b/nifi-docs/src/main/asciidoc/images/processor-cs-version-match.png new file mode 100644 index 0000000..38fc816 Binary files /dev/null and b/nifi-docs/src/main/asciidoc/images/processor-cs-version-match.png differ http://git-wip-us.apache.org/repos/asf/nifi/blob/49270f8a/nifi-docs/src/main/asciidoc/images/processor-cs-version-mismatch-config.png ---------------------------------------------------------------------- diff --git a/nifi-docs/src/main/asciidoc/images/processor-cs-version-mismatch-config.png b/nifi-docs/src/main/asciidoc/images/processor-cs-version-mismatch-config.png new file mode 100644 index 0000000..52755a6 Binary files /dev/null and b/nifi-docs/src/main/asciidoc/images/processor-cs-version-mismatch-config.png differ http://git-wip-us.apache.org/repos/asf/nifi/blob/49270f8a/nifi-docs/src/main/asciidoc/images/processor-cs-version-mismatch-warnings.png ---------------------------------------------------------------------- diff --git a/nifi-docs/src/main/asciidoc/images/processor-cs-version-mismatch-warnings.png b/nifi-docs/src/main/asciidoc/images/processor-cs-version-mismatch-warnings.png new file mode 100644 index 0000000..3005d85 Binary files /dev/null and b/nifi-docs/src/main/asciidoc/images/processor-cs-version-mismatch-warnings.png differ http://git-wip-us.apache.org/repos/asf/nifi/blob/49270f8a/nifi-docs/src/main/asciidoc/images/processor-version-information-example.png ---------------------------------------------------------------------- diff --git a/nifi-docs/src/main/asciidoc/images/processor-version-information-example.png b/nifi-docs/src/main/asciidoc/images/processor-version-information-example.png new file mode 100644 index 0000000..01a6849 Binary files /dev/null and b/nifi-docs/src/main/asciidoc/images/processor-version-information-example.png differ http://git-wip-us.apache.org/repos/asf/nifi/blob/49270f8a/nifi-docs/src/main/asciidoc/images/properties-tab.png ---------------------------------------------------------------------- diff --git a/nifi-docs/src/main/asciidoc/images/properties-tab.png b/nifi-docs/src/main/asciidoc/images/properties-tab.png index f56e3e0..86ae5f0 100644 Binary files a/nifi-docs/src/main/asciidoc/images/properties-tab.png and b/nifi-docs/src/main/asciidoc/images/properties-tab.png differ http://git-wip-us.apache.org/repos/asf/nifi/blob/49270f8a/nifi-docs/src/main/asciidoc/images/restricted.png ---------------------------------------------------------------------- diff --git a/nifi-docs/src/main/asciidoc/images/restricted.png b/nifi-docs/src/main/asciidoc/images/restricted.png index e781700..d6104fd 100644 Binary files a/nifi-docs/src/main/asciidoc/images/restricted.png and b/nifi-docs/src/main/asciidoc/images/restricted.png differ http://git-wip-us.apache.org/repos/asf/nifi/blob/49270f8a/nifi-docs/src/main/asciidoc/images/scheduling-tab.png ---------------------------------------------------------------------- diff --git a/nifi-docs/src/main/asciidoc/images/scheduling-tab.png b/nifi-docs/src/main/asciidoc/images/scheduling-tab.png index 9d5615f..0ee2280 100644 Binary files a/nifi-docs/src/main/asciidoc/images/scheduling-tab.png and b/nifi-docs/src/main/asciidoc/images/scheduling-tab.png differ http://git-wip-us.apache.org/repos/asf/nifi/blob/49270f8a/nifi-docs/src/main/asciidoc/images/settings-tab.png ---------------------------------------------------------------------- diff --git a/nifi-docs/src/main/asciidoc/images/settings-tab.png b/nifi-docs/src/main/asciidoc/images/settings-tab.png index 80992e6..77000df 100644 Binary files a/nifi-docs/src/main/asciidoc/images/settings-tab.png and b/nifi-docs/src/main/asciidoc/images/settings-tab.png differ http://git-wip-us.apache.org/repos/asf/nifi/blob/49270f8a/nifi-docs/src/main/asciidoc/images/simple-flow.png ---------------------------------------------------------------------- diff --git a/nifi-docs/src/main/asciidoc/images/simple-flow.png b/nifi-docs/src/main/asciidoc/images/simple-flow.png index 4b2288f..ab9a6c1 100644 Binary files a/nifi-docs/src/main/asciidoc/images/simple-flow.png and b/nifi-docs/src/main/asciidoc/images/simple-flow.png differ http://git-wip-us.apache.org/repos/asf/nifi/blob/49270f8a/nifi-docs/src/main/asciidoc/images/valid-processor.png ---------------------------------------------------------------------- diff --git a/nifi-docs/src/main/asciidoc/images/valid-processor.png b/nifi-docs/src/main/asciidoc/images/valid-processor.png index d795941..f378d1b 100644 Binary files a/nifi-docs/src/main/asciidoc/images/valid-processor.png and b/nifi-docs/src/main/asciidoc/images/valid-processor.png differ http://git-wip-us.apache.org/repos/asf/nifi/blob/49270f8a/nifi-docs/src/main/asciidoc/user-guide.adoc ---------------------------------------------------------------------- diff --git a/nifi-docs/src/main/asciidoc/user-guide.adoc b/nifi-docs/src/main/asciidoc/user-guide.adoc index aa28b37..4364b66 100644 --- a/nifi-docs/src/main/asciidoc/user-guide.adoc +++ b/nifi-docs/src/main/asciidoc/user-guide.adoc @@ -267,7 +267,7 @@ Processor developers have the ability to add Tags to their Processors. These tag displayed on the left-hand side in a Tag Cloud. The more Processors that exist with a particular Tag, the larger the Tag appears in the Tag Cloud. Clicking a Tag in the Cloud will filter the available Processors to only those that contain that Tag. If multiple Tags are selected, only those Processors that contain all of those Tags are shown. For example, if we want to show only those -Processors that allow us to ingest data via HTTP, we can select both the `http` Tag and the `ingest` Tag: +Processors that allow us to ingest files, we can select both the `files` Tag and the `ingest` Tag: image::add-processor-with-tag-cloud.png["Add Processor with Tag Cloud"] @@ -279,8 +279,8 @@ These components could be used by an otherwise authorized NiFi user to go beyond privilege, or could expose data about the internals of the NiFi process or the host system. All of these capabilities should be considered privileged, and admins should be aware of these capabilities and explicitly enable them for a subset of trusted users. -Before a user is allowed to create and modify restricted components they must be granted access to restricted components. Refer to -<<UI-with-multi-tenant-authorization,multi-tenant>> documentation. +Before a user is allowed to create and modify restricted components they must be granted access to restricted components. For more information refer to +<<UI-with-multi-tenant-authorization>>. Clicking the `Add` button or double-clicking on a Processor Type will add the selected Processor to the canvas at the location that it was dropped. @@ -298,10 +298,11 @@ While the options available from the context menu vary, the following options ar - *Configure*: This option allows the user to establish or change the configuration of the Processor (see <<Configuring_a_Processor>>). - *Start* or *Stop*: This option allows the user to start or stop a Processor; the option will be either Start or Stop, depending on the current state of the Processor. +- *Enable* or *Disable*: This option allows the user to enable or enable a Processor; the option will be either Enable or Disable, depending on the current state of the Processor. - *Status History*: This option opens a graphical representation of the Processor's statistical information over time. +- *Data provenance*: This option displays the NiFi Data Provenance table, with information about data provenance events for the FlowFiles routed through that Processor (see <<data_provenance>>). - *Upstream connections*: This option allows the user to see and "jump to" upstream connections that are coming into the Processor. This is particularly useful when processors connect into and out of other Process Groups. - *Downstream connections*: This option allows the user to see and "jump to" downstream connections that are going out of the Processor. This is particularly useful when processors connect into and out of other Process Groups. -- *Data provenance*: This option displays the NiFi Data Provenance table, with information about data provenance events for the FlowFiles routed through that Processor (see <<data_provenance>>). - *Usage*: This option takes the user to the Processor's usage documentation. - *Change color*: This option allows the user to change the color of the Processor, which can make the visual management of large flows easier. - *Center in view*: This option centers the view of the canvas on the given Processor. @@ -355,6 +356,7 @@ While the options available from the context menu vary, the following options ar - *Enter group*: This option allows the user to enter the Process Group. It is also possible to double-click on the Process Group to enter it. - *Start*: This option allows the user to start a Process Group. - *Stop*: This option allows the user to stop a Process Group. +- *Group*: This option allows the user to create a new Process Group that contains the selected Process Group and any other components selected on the canvas. - *Status History*: This option opens a graphical representation of the Process Group's statistical information over time. - *Upstream connections*: This option allows the user to see and "jump to" upstream connections that are coming into the Process Group. - *Downstream connections*: This option allows the user to see and "jump to" downstream connections that are going out of the Process Group. @@ -383,6 +385,7 @@ image::nifi-rpg-menu.png["Remote Process Group Menu"] While the options available from the context menu vary, the following options are typically available when you have full privileges to work with the Remote Process Group: - *Configure*: This option allows the user to establish or change the configuration of the Remote Process Group. +- *Group*: This option allows the user to create a new Process Group that contains the selected Remote Process Group and any other components selected on the canvas. - *Remote Ports*: This option allows the user to see input ports and/or output ports that exist on the remote instance of NiFi that the Remote Process Group is connected to. Note that if the Site-to-Site configuration is secure, only the ports that the connecting NiFi has been given accessed to will be visible. - *Enable transmission*: Makes the transmission of data between NiFi instances active (see <<Remote_Group_Transmission>>). - *Disable transmission*: Disables the transmission of data between NiFi instances. @@ -437,22 +440,34 @@ This is especially useful when you are working within a clustered environment wi different versions of a component or if you have upgraded to a newer version of a processor. The Add Processor, Add Controller Service, and Add Reporting Task dialogs include a column identifying the component version, as well as the name of the component, the organization or group that created the component, and the NAR bundle that contains -the processor. Each component displayed on the canvas also contains this information. +the component. + +image::add-processor-version-example.png["Add Processor Version Example"] + +Each component displayed on the canvas also contains this information. + +image::processor-version-information-example.png["Processor Version Information Example"] ==== Sorting and Filtering Components -When you are adding a component, you can filter based on originating source or version number. +When you are adding a component, you can sort on version number or filter based on originating source. To sort based on version, click the version column to display in ascending or descending version order. To filter based on source group, click the source drop-down in the upper left of your Add Component dialog, -and select the source group you want to view. +and select the group you want to view. + +image::add-processor-version-sort-filter.png["Add Processor Version Sort and Filter"] ==== Changing Component Versions To change a component version, perform the following steps. -. Right-click the component on the canvas to display configuration options. -. Select Change version. -. In the Component Version dialog, select the version you want to run from the Version drop-down menu. +1. Right-click the component on the canvas to display configuration options. +2. Select Change version. + +image::processor-change-version.png["Processor Change Version"] + +[start=3] +3. In the Component Version dialog, select the version you want to run from the Version drop-down menu. image::component-version-dialog.png["Component Version"] @@ -465,6 +480,19 @@ When you are configuring a component, you can also view information about versio image::configure-processor-with-version-information.png["Configuration Version Requirements"] +In the following example, MyProcessor version 1.0 is configured properly with the controller service StandardMyService version 1.0: + +image::processor-cs-version-match.png["Processor and Controller Service Version Match"] + +If the version of MyProcessor is changed to an incompatible version (MyProcessor 2.0), validation errors will be displayed on the processor: + +image::processor-cs-version-mismatch-warnings.png["Processor and Controller Service Version Mismatch Warnings"] + +and an error message will be displayed in the processor's controller service configuration since the service is no longer valid: + +image::processor-cs-version-mismatch-config.png["Processor and Controller Service Version Mismatch Property"] + + [[Configuring_a_Processor]] === Configuring a Processor @@ -495,8 +523,7 @@ The name of a Processor by default is the same as the Processor type. Next to th Processor is disabled, it cannot be started. The disabled state is used to indicate that when a group of Processors is started, such as when a DFM starts an entire Process Group, this (disabled) Processor should be excluded. -Below the Name configuration, the Processor's unique identifier is displayed along with the Processor's type. These -values cannot be modified. +Below the Name configuration, the Processor's unique identifier is displayed along with the Processor's type and NAR bundle. These values cannot be modified. Next are two dialogues for configuring `Penalty duration' and `Yield duration'. During the normal course of processing a piece of data (a FlowFile), an event may occur that indicates that the data cannot be processed at this time but the @@ -662,7 +689,7 @@ Some processors also have an Advanced User Interface (UI) built into them. For e Some processors have properties that refer to other components, such as Controller Services, which also need to be configured. For example, the GetHTTP processor has an SSLContextService property, which refers to the StandardSSLContextService controller service. When DFMs want to configure this property but have not yet created and configured the controller service, they have the option to create the service on the spot, as depicted in the image below. For more information about configuring Controller Services, see the <<Controller_Services>> section. -image:create-service-ssl-context.png["Create Service", width=700] +image:create-service-ssl-context.png["Create Service"] ==== Comments Tab
