[SOLR-13145] Provide better error when ref guide deps are not installed

• Type: Improvement
• Status: Closed
• Priority: Trivial
• Resolution: Fixed
• Affects Version/s: 8.0
• Fix Version/s: 8.0, 9.0
• Component/s: Build
• Assignee: Gus Heck
• Reporter: Gus Heck
• Created: 17/Jan/19 22:21
• Updated: 08/Jun/19 15:01
• Resolved: 18/Jan/19 16:48

Description

Recently I tried to build the ref guide only to find I didn't have the deps installed on that particular machine (mostly I do solr dev on my desktop cause it's faster). The error I got was unenlightening:

build-site:
[java] Exception in thread "main" java.lang.NullPointerException
[java] at CheckLinksAndAnchors.main(CheckLinksAndAnchors.java:156)
BUILD FAILED

This happens because CheckLinksAndAnchors.main() is trying to list the files in the directory into which Jeckyll didn't put the html.... and getting null. I think the problem here is that we let the build continue when Jeckyll failed. Attaching patch to fail out when Jeckyll is not found with this message:

-build-site:
[echo] Running Jekyll...
[exec] rbenv: jekyll: command not found
BUILD FAILED
/Users/gus/projects/solr/lucene-solr/solr/solr-ref-guide/build.xml:299: exec returned: 127

That at least will point the dev in the right direction, since clearly something required is not found.