Deprecated feature

Upgrade connector descriptor of the existing connector

In this lesson, you upgrade auth.reindex connector descriptor with the customized connector code.

Procedure

Complete the following steps to upgrade auth.reindex connector with the customized connector code.
Warning: All Ingest Service processing in NiFi should be completed prior to initiating the Upgrade API to upgrade pipeline process groups (dataflows). NiFi should show no queued data, indicated by "0 / 0 bytes" in the NiFi UI Status Bar. Ingest service processes can be allowed to complete or can be cancelled using the Ingest connectors "cancel" endpoint, as described in Managing connectors in the Ingest service.

If the Upgrade API was executed with queued data or Ingest Service processes running and the NiFi UI Status Bar indicates invalid components, the Upgrade process will fail. The queue must be cleared by locating the Process Groups in the pipeline that has queued flowfile data. Stop the Process Groups that have queued data. For more information, see Stopping a component.

After the Process Group stops, right-click on the Process Group and click on Empty all queues. After the queues are cleared for the pipeline, rerun the Upgrade API for the connector associated with the pipeline. For example, 
/connectors/auth.reindex/upgrade
  1. Use the following URL to access Swagger UI to interact with Search Ingest Service API.
    http://<ElasticSearchHostname/IP>:30800/swagger-ui/index.html?url=/v3/api-docs&validatorUrl=#/Connector%20Configuration/upgradeConnector
  2. On the Swagger UI, navigate to Connector Configuration > POST: /connectors/{id}/upgrade.
  3. Click Try it out.
  4. In the id field, enter auth.reindex and paste the entire request JSON body with the customized connector code.
  5. Click Execute. The server response appears in the following manner:
    Important: The request takes some time to complete.
  6. Restart all Elasticsearch services after the connector upgrade is completed.