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
-
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
- On the Swagger UI, navigate to .
- Click Try it out.
-
In the id field, enter
auth.reindex
and paste the entire request JSON body with the customized connector code. -
Click Execute. The server response appears in the
following manner:
Important: The request takes some time to complete.
- Restart all Elasticsearch services after the connector upgrade is completed.