Examples

Ten-plus examples users can actually run.

The examples cover blocked upgrades, bridge requirements, assisted rewrites, manual-change paths, assisted rewrites, manual-inspection findings, and safe auto-fixes across both `1.x` and `2.x` migration lines.

Featured Stories

Three richer examples that feel closer to a real migration review.

These featured stories use fuller fixtures and show the mixed-result cases real teams care about: blocked findings, safe rewrites, assisted rewrites, manual-change guidance, and policy review in the same flow.

Blocked + Safe + Assisted + Manual

Orders Platform 1.27 to 2.0

A fuller upgrade story with variable-registry blocking, cache-service renames, Base64 replacement, and assisted HTTP migration guidance in one run.

Total `5` Auto-fix `2` Assisted `1` Manual-change `1` Blocked `1` Rewrite `6 applied`
## blocked
- core.variable-registry.removed: Variable Registry expressions require explicit migration planning before NiFi 2.0.x.

## auto-fix
- core.distributed-map-cache-client.renamed
- core.base64-encode-content.replace

## assisted-rewrite
- core.get-http.replace

## manual-change
- core.invoke-http.proxy-properties.replace
Blocked + Rewrite + Review

Orders Platform 2.7 to 2.8

A fuller NiFi `2.x` story with removed Asana components, a safe ListenSyslog rewrite, custom Jolt recompilation review, and SSL-service migration guidance.

Total `6` Auto-fix `1` Manual-change `1` Manual-inspection `1` Blocked `2` Rewrite `1 applied`
## blocked
- core.get-asana-object.removed
- core.asana-client-provider.removed

## auto-fix
- core.listen-syslog.port-to-tcp-port

## manual-inspection
- core.jolt.custom-class.recompile
Policy Review Story

Integration Platform 1.22 to 1.23

A broader review example showing root-level policy guidance, several affected components, and a forward-looking warning for a later `2.0` migration.

Total `7` Manual-change `1` Manual-inspection `4` Info `2`
## manual-change
- core.rethinkdb.deprecated

## manual-inspection
- core.remote-resources.policy-affected-components
  PrimaryDatabase, JMSProvider, PublishOrdersToJMS, ValidateOrdersJson

## info
- core.reference-remote-resources.policy-review

Catalog

Quick single-purpose demos.

Use these when you want one small example per migration rule or outcome type.

Blocked

Asana removed in 2.8

The advisor blocks the upgrade and leaves replacement decisions to a person.

./demo/asana-2.7-to-2.8.sh
Assisted rewrite

GetHTTP to InvokeHTTP

The advisor scaffolds the target InvokeHTTP shape while keeping timeout, SSL, and response handling review visible.

./demo/get-http-1.27-to-2.0.sh
Auto-fix

Base64EncodeContent to EncodeContent

The advisor performs the explicit safe replacement and preserves the rest of the flow.

./demo/base64-1.27-to-2.0.sh
Bridge required

1.21 to 2.0 blocked

The advisor explains that a direct step to NiFi `2.0.x` is not supported before a `1.27.x` bridge upgrade.

./demo/bridge-upgrade-1.21-to-2.0.sh
Manual-change

H2 JDBC URL review

Shows how the tool flags H2 usage on DBCP/Hikari in the `1.21 -> 1.22` step.

./demo/h2-dbcp-1.21-to-1.22.sh
Manual-change

JNDI JMS LDAP review

Shows LDAP Provider URL detection for JNDI JMS migration caveats.

./demo/jndi-jms-ldap-1.21-to-1.22.sh
Assisted rewrite

ConvertAvroToJSON to ConvertRecord

Shows a guided `1.25 -> 1.26` scaffold where the processor type changes but record-service choices still remain visible for review.

./demo/convert-avro-1.25-to-1.26.sh
Manual-change

InvokeHTTP URL encoding

Shows how URL encoding review is surfaced for `1.23 -> 1.24`.

./demo/invoke-http-url-encoding-1.23-to-1.24.sh
Assisted rewrite

ListenHTTP rate limit removed

Shows removed rate-limit behavior for `2.3 -> 2.4` with a reviewed assisted cleanup.

./demo/listen-http-2.3-to-2.4.sh
Auto-fix

ListenSyslog property rename

Shows safe `Port -> TCP Port` rewrite behavior in the `2.6 -> 2.7` path.

./demo/listen-syslog-2.6-to-2.7.sh
Manual-inspection

Jolt custom class review

Shows recompilation guidance for custom Jolt transforms in the `2.7 -> 2.8` path.

./demo/jolt-custom-class-2.7-to-2.8.sh
Quiet path

Content viewer clean path

Shows a low-drama clean-path example where the built-in coverage finds no flow-specific issues.

./demo/content-viewer-2.4-to-2.5.sh
Policy review

Reference Remote Resources

Shows root-level and component-level policy review findings for the `1.22 -> 1.23` step.

./demo/reference-remote-resources-1.22-to-1.23.sh