[NIFI-2184] JettyServer should confirm "docs" path exists before using it in .createDocsWebApp().

• Type: Bug
• Status: Resolved
• Priority: Minor
• Resolution: Fixed
• Affects Version/s: 1.0.0, 0.7.0
• Fix Version/s: 1.5.0
• Component/s: Core Framework, Documentation & Website
• Labels: easyfix
• Environment: Tested with 0.7.0-SNAPSHOT. Looks like it will occur with 1.x, but that is not confirmed.
• Assignee: Mark Owens
• Reporter: Joe Skora
• Created: 06/Jul/16 18:21
• Updated: 28/Sep/17 22:36
• Resolved: 28/Sep/17 21:50

Description

Application throws exception and startup fails with "Resource directory paths are malformed: docs" if configured docs directory does not exist.

Ideally it should startup without online documentation, but if it doesn't start an explicit log message and possibly a message to the console should explain that the directory is missing.

2016-07-06 13:30:13,840 ERROR [main] org.apache.nifi.NiFi Failure to launch NiFi due to java.lang.reflect.InvocationTargetException
java.lang.reflect.InvocationTargetException: null
        at sun.reflect.NativeConstructorAccessorImpl.newInstance0(Native Method) ~[na:1.7.0_80]
        at sun.reflect.NativeConstructorAccessorImpl.newInstance(NativeConstructorAccessorImpl.java:57) ~[na:1.7.0_80]
        at sun.reflect.DelegatingConstructorAccessorImpl.newInstance(DelegatingConstructorAccessorImpl.java:45) ~[na:1.7.0_80]
        at java.lang.reflect.Constructor.newInstance(Constructor.java:526) ~[na:1.7.0_80]
        at org.apache.nifi.NiFi.<init>(NiFi.java:131) ~[nifi-runtime-0.7.0-SNAPSHOT.jar:0.7.0-SNAPSHOT]
        at org.apache.nifi.NiFi.main(NiFi.java:227) ~[nifi-runtime-0.7.0-SNAPSHOT.jar:0.7.0-SNAPSHOT]
Caused by: java.lang.IllegalStateException: Resource directory paths are malformed: docs
        at org.apache.nifi.web.server.JettyServer.createDocsWebApp(JettyServer.java:553) ~[nifi-jetty-0.7.0-SNAPSHOT.jar:0.7.0-SNAPSHOT]
        at org.apache.nifi.web.server.JettyServer.loadWars(JettyServer.java:337) ~[nifi-jetty-0.7.0-SNAPSHOT.jar:0.7.0-SNAPSHOT]
        at org.apache.nifi.web.server.JettyServer.<init>(JettyServer.java:140) ~[nifi-jetty-0.7.0-SNAPSHOT.jar:0.7.0-SNAPSHOT]
        ... 6 common frames omitted
2016-07-06 13:30:13,841 INFO [Thread-1] org.apache.nifi.NiFi Initiating shutdown of Jetty web server...

Issue Links

• links to: GitHub Pull Request #2164