Quick guide of installing Apache NiFi on local

1. LOCAL NIFI SETUP
DEON HUANG

2. WHY LOCAL NIFI
• Easy to remote debug with IDE
• Local debug with stuck NiFi from handle other request
• Easy to deploy custom processor
• Deploy custom processor require NiFi instance to reboot
• Faster
• Own your own NiFi instance for some quick processor or data
flow validation

3. STEP 1 DOWNLOAD NIFI-BIN
• NiFi bin official download
• https://nifi.apache.org/download.html
• Pick nifi-x.x.x-bin.zip for Windows

4. STEP 2 SOME ENVIRONMENT SETTING BEFORE START NIFI
• Set more jvm memory depend on your (Originally too small)
• Edit /conf/bootstrap.conf
• # JVM memory settings
• java.arg.2=-Xms4g (Initial allocate)
• java.arg.3=-Xmx4g (Maximum allocate)
• Enable remote debug (Uncomment this line to enable
remote debug)
• # Enable Remote Debugging
• java.arg.debug=-
agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=8000
• Download stop-nifi.bat for Window
• https://community.hortonworks.com/questions/104577/how-to-stop-
nifi-running-in-the-background-on-wind.html

5. STEP 3 LAUNCH NIFI
• Double click run-nifi.bat
• Connect to http://localhost:8080/nifi/ by default
(Notice that it will delay for 1~2 mins for NiFi web UI
launch)

6. WHAT YOU SHOULD DO IF THERE IS ANY KIND OF ERROR
• 1. Use cmd.exe to execute bat to check interactive response
• 2. Check nifi liveness : jps, nifi status, curl nifi
• 3. Check nifi logs : nifi-app.log, nifi-bootstrap.log

7. REFERENCE
• HDF/NIFI Best practices for setting up a high performance NiFi
installation.
• https://community.hortonworks.com/articles/7882/hdfnifi-best-
practices-for-setting-up-a-high-perfo.html
• NiFi official document
• https://nifi.apache.org/docs.html