dragonfly-newlisp / TROUBLESHOOTING

This document addresses problems getting Dragonfly up and running
in various environments, currently two: newlisp as server, and Apache.

+=================+
 NEWLISP AS SERVER
+=================+

------------------------------------------------------------
Problem
ERR:500 Need \tmp directory on current drive: index.cgi

:: Solution ::
This happens on Windows. newlisp needs a "tmp" folder in C:.
Just create it here so that it's here: C:\tmp

------------------------------------------------------------
Problem
ERR:404 File or Directory not found: index.html

Solution
Make sure you're running the newlisp command from within
the 'example-site' directory, or whatever contains your
'index.cgi' file. This is the command to run:

	./newlispServer
	
On Windows double-click on 'newlispServerWin' instead.

+=================+
 APACHE AS SERVER 
+=================+

------------------------------------------------------------
Problem
500 Internal Server Error

Solution
See example in README to check and make sure that the
path to newlisp is set correctly in index.cgi.

------------------------------------------------------------
Problem
index.cgi is not being run.

Solution
Try adding this to your .htaccess file at the site root:

	AddHandler cgi-script .cgi
	
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.