[
https://issues.apache.org/jira/browse/NIFI-3058?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15677781#comment-15677781
]
ASF GitHub Bot commented on NIFI-3058:
--------------------------------------
Github user jtstorck commented on a diff in the pull request:
https://github.com/apache/nifi/pull/1246#discussion_r88741590
--- Diff: nifi-docs/src/main/asciidoc/administration-guide.adoc ---
@@ -1599,7 +1599,97 @@ java.arg.16=-Dsun.security.krb5.debug=true
This will cause the debug output to be written to the NiFi Bootstrap log
file. By default, this is located at _$NIFI_HOME/logs/nifi-bootstrap.log_.
This output can be rather verbose but provides extremely valuable
information for troubleshooting Kerberos failures.
+[[zookeeper_migrator]]
+=== ZooKeeper Migrator
+You can use the NiFi ZooKeeper Migrator to perform the following tasks:
+* Move ZooKeeper information from one ZooKeeper cluster to another
+* Migrating ZooKeeper node ownership
+
+For example, you may want to use the ZooKeeper Migrator when you are:
+
+* Upgrading from NiFi 0.x to NiFi 1.x in which embedded ZooKeepers are used
+* Migrating from an embedded ZooKeeper in NiFi 0.x or 1.x to an external
ZooKeeper
+* Upgrading from NiFi 0.x with an external ZooKeeper to NiFi 1.x with the
same external ZooKeeper
+* Migrating from an external ZooKeeper to an embedded ZooKeeper in NiFi 1.x
+
+The NiFi ZooKeeper Migrator (`zk-migrator.sh`) is part of the NiFi Toolkit
and is downloaded separately from the
+link:https://nifi.apache.org/download.html[Apache NiFi download page].
+
+[[zk_migrator_command_line_parameters]]
+==== zk-migrator.sh Command Line Parameters
+
+You can use the following command line options with the ZooKeeper Migrator:
+
+* `-a,--auth <username:password>` Allows the specification
of a username and password for authentication with ZooKeeper. This option is
mutually exclusive with the `-k,--krb-conf` option.
+* `-f,--file <filename>` The file to be used for
JSON data. When used with the `-r,--receive` option, data read from ZooKeeper
will be stored in the given filename. When used with the `-s,--send` option,
the data in the file will be sent to ZooKeeper.
+* `-h,--help` Prints help, displays
available parameters with descriptions
+* `--ignore-source` Allows the ZooKeeper
Migrator to write to the ZooKeeper and path from which the data was obtained.
+* `-k,--krb-conf <jaas-filename>` Allows the specification
of a JAAS configuration file to allow authentication with a ZooKeeper
configured to use Kerberos. This option is mutually exclusive with the
`-a,--auth` option.
+* `-r,--receive` Receives data from
ZooKeeper and writes to the given filename (if the `-f,--file` option is
provided) or standard output. The data received will contain the full path to
each node read from ZooKeeper. This option is mutually exclusive with the
`-s,--send` option.
+* `-s,--send` Sends data to ZooKeeper
that is read from the given filename (if the `-f,--file` option is provided) or
standard input. The paths for each node in the data being sent to ZooKeeper are
absolute paths, and will be stored in ZooKeeper under the *path* portion of the
`-z,--zookeeper` argument. Typically, the *path* portion of the argument can
be omitted, which will store the nodes at their absolute paths. This option is
mutually exclusive with the `-r,--receive` option.
+* `-z,--zookeeper <zookeeper-endpoint>` The ZooKeeper server to
use, specified by a connection string with path, in the format of
_host:port/znode/path_.
+
+[[migrating_between_source_destination_zookeepers]]
+==== Migrating Between Source and Destination ZooKeepers
+
+Before you begin, confirm that:
+
+* You have installed the destination ZooKeeper cluster.
+* You have installed and configured a NiFi cluster to use the destination
ZooKeeper cluster.
+* If you are migrating ZooKeepers due to upgrading NiFi from 0.x to 1.x,,
you have already followed appropriate NiFi upgrade steps.
+* You have configured Kerberos as needed.
+* You have not started processing any dataflow (to avoid duplicate data
processing).
+* If one of the ZooKeeper clusters you are using is configured with
Kerberos, you are running the ZooKeeper Migrator from a host that has access to
NiFi’s ZooKeeper client jaas configuration file (see <<zk_kerberos_client>> for
more information).
+
+1. Collect the following information:
--- End diff --
When the document is previewed (at least in Atom), the first step looks
like it's indented along with the previouss section of the "Before you begin"
steps. Perhaps adding a ZooKeeper Migration Steps header for this section?
> Add documentation for ZooKeeper Migrator
> ----------------------------------------
>
> Key: NIFI-3058
> URL: https://issues.apache.org/jira/browse/NIFI-3058
> Project: Apache NiFi
> Issue Type: Improvement
> Components: Documentation & Website
> Affects Versions: 1.1.0
> Reporter: Andrew Lim
> Assignee: Andrew Lim
> Priority: Minor
>
> NIFI-2957 added the ZooKeeper Migrator to the NiFi Toolkit. Documentation
> should be added to guide the usage of the migrator.
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)
