Upgrading the Connector

If you are using the VMware Greenplum Connector for Apache NiFi in your current Apache NiFi installation, you must perform some upgrade actions when you install a new version of the Connector:

1. Satisfy the prerequisites.
2. Download the new version of the Connector.
3. Register the new version of the Connector with Apache NiFi.

Prerequisites

You can run a single instance of Apache NiFi, or run NiFi in a clustered environment. Before you upgrade the Connector, ensure that you meet the following prerequisites:

• You can identify the base directory of the Apache NiFi installation on the system (possibly $NIFI_HOME).
• You can identify the mode in which you are running Apache NiFi (single instance or clustered).
• You can identify the method in which you previously registered the Connector (ran install.sh or copied NAR files to autoload or custom directory).
• You have administrative access to the NiFi host(s).

Downloading the Connector Package

Download and unpack the new version of the Connector from VMware Tanzu Network as described in Downloading the Connector Package.

Registering the Connector with Apache NiFi

You register a new version of the Connector with Apache NiFi by copying the new NAR files to the Apache NiFi installation on the host(s).

Your registration tasks will differ depending on how you initially registered the connector. (If you are running an Apache NiFi cluster, be sure to register the Connector NAR files on each NiFi host.)

If you ran the install.sh script to register the Connector:

1. Ensure that you have set the $NIFI_HOME environment variable, that it identifies your Apache NiFi installation directory, and that you have permission to write to this directory.

2. Run the install script:

   $ ./install.sh
   Removing old Greenplum NiFi Connector artifacts ...
   Installing new Greenplum NiFi Connector (version 1.1.0) ...
   ...
   Successfully installed Greenplum NiFi Connector (version 1.1.0) into /usr/local/nifi/lib
   

   The script removes any previously-installed Connector artifacts in $NIFI_HOME/lib before it copies the contents of nar/* to that directory.

3. Restart Apache NiFi.

If you copied the NAR files to the Apache NiFi autoload directory (nifi.nar.library.autoload.directory):

1. Remove the previous version Connector NAR files from the directory.
2. Copy the the new Connector NAR files to the autoload directory.

If you copied the NAR files to a location of your choosing (nifi.nar.library.directory.<custom>):

1. Remove the previous version Connector NAR files from the directory.
2. Copy the the new Connector NAR files to the custom directory.
3. Restart Apache NiFi.