quick server pages
   
Manual page for Installing,(examples,)

Installing QUISP

  • Download from quisp.sourceforge.net. Software distribution directory can be located anywhere (user directory or system directory)

  • If you're building quisp_pl (ploticus-enabled), take a look at ploticus/Makefile_api in case you want to change any of the settings. More info on quisp_pl and graphics

  • In the top level of the distribution, type: make all
    gcc is required. There are no external library dependencies. You can be any UID to do the build. This will build shsql and quisp (and libploticus if appropriate). The resulting executables will be placed in ./bin

  • Add the quisp bin to your search PATH to make the command line utilities (quisputil and shsql) available.

  • Here's how to proceed with setting up a QUISP-powered web site and trying some canned examples.


Troubleshooting hints

  • You can add _DEBUG=1 to an invoking URL to get diagnostic information (the name _DEBUG can be changed to something more obscure in your config file if desired).

  • Use your browser's Show source feature to see the raw HTML. Sometimes error messages are hidden in formatted result (especially within tables or option lists), but will be visible in the raw HTML. Note that standard error (eg. error messages from subprocesses) is not captured when in CGI mode.


  • Try invoking quisp manually. Supply user variables and values on the command line as var=value pairs, eg. quisp rtn=mypage x=2. The generated HTML will be written to the screen. You will also see any standard error content.


  • What's the path name of my cgi bin? Check with your local web administrators.

  • Why can't my web browser find quisp? Where CGI programs need to reside, and how they are named, can vary from site to site. Check with your local web administrators.

  • The web server seems to be executing quisp, but quisp can't see any files outside of the cgi bin or html docs directories. Some web servers are configured to not allow CGI programs to access files outside of these areas. Check with your local web administrators. If the restriction can't be relaxed you may need to put the quisp shsql trees within the allowed directories.


Support

Bugs and questions to Steve Grubb at scg@jax.org. I am always happy to hear of interesting applications that this software used for.

About the author.


quick server pages    
Copyright Steve Grubb    


Markup created by unroff 1.0,    February 16, 2005.