Github user YolandaMDavis commented on a diff in the pull request:
https://github.com/apache/nifi/pull/1736#discussion_r114450829
--- Diff: nifi-docs/src/main/asciidoc/administration-guide.adoc ---
@@ -1176,6 +1176,146 @@ Secure Prompt
If you prefer not to provide the password or raw key in the command-line
invocation of the tool, leaving these arguments absent will prompt a secure
console read of the password (by default) or raw key (if the `-r` flag is
provided at invocation).
+[[admin-toolkit]]
+Administrative Tools
+--------------------
+The admin toolkit contains command line utilities for administrators to
support NiFi maintenance in standalone
+and clustered environments. These utilities include:
+
+* Notify -- The notification tool allows administrators to send bulletins
to the NiFi UI using the command line.
+* Node Manager -- The node manager tool allows administrators to perform a
status check on a node as well as to connect, disconnect, or remove nodes that
are part of a cluster.
+
+The admin toolkit is bundled with the nifi-toolkit and can be executed
with scripts found in the _bin_ folder.
+
+=== Prerequisites for Running Admin Toolkit in a Secure Environment
+For secured nodes and clusters, two policies should be configured in
advance:
+
+* Access the controller â A user that will have access to these
utilities should be authorized in NiFi by creating an âaccess
+the controllerâ policy ('/controller') with both view and modify rights.
+* Proxy user request â If not previously set nodeâs identity (the DN
value of the nodeâs certificate) should be authorized to proxy requests on
behalf of a user
+
+When executing either the notify or node manager tools in a secured
environment the `proxyDN` flag option should be used in order to properly
identify the user that was authorized to execute these commands. In non-secure
environments, or if running the status operation on the Node Manager tool, the
flag is ignored.
+
+=== Notify
+Notify allows administrators to send messages as bulletins to NiFi.
Notify is supported on NiFi version 1.2.0 and higher.
+The notification tool is also available in a _notify.bat_ file for use on
Windows machines.
+
+To send notifications:
+
+ notify.sh -d {$NIFI_HOME} âb {nifi bootstrap file path} -m {message}
[-l {level}][-v]
+
+To show help:
+
+ notify.sh -h
+
+The following are available options:
+
+* `-b,--bootstrapConf <arg>` The _bootstrap.conf_ file to persist master
key
--- End diff --
@thesolson I think this was copied in from another document. This should
read:
`-b, --bootstrapConf <arg>` Existing Bootstrap Configuration file (required)
---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at [email protected] or file a JIRA ticket
with INFRA.
---
