.ig >>
<STYLE TYPE="text/css">
<!--
        A:link{text-decoration:none}
        A:visited{text-decoration:none}
        A:active{text-decoration:none}
        OL,UL,P,BODY,TD,TR,TH,FORM { font-family: arial,helvetica,sans-serif;; font-size:small; color: #333333; }

        H1 { font-size: x-large; font-family: arial,helvetica,sans-serif; }
        H2 { font-size: large; font-family: arial,helvetica,sans-serif; }
        H3 { font-size: medium; font-family: arial,helvetica,sans-serif; }
        H4 { font-size: small; font-family: arial,helvetica,sans-serif; }
-->
</STYLE>
<title>quisp: installing, examples, support and troubleshooting</title>
<body bgcolor=99cc99 vlink=0000FF>
<br>
<br>
<center>
<table cellpadding=2 bgcolor=FFFFFF width=550 ><tr>
<td align=right><a href="quisp_home.html">
<img src="img/quisp2.gif" border=0><br><small>quick server pages</a> &nbsp; &nbsp; </td></tr>
<td>
.>>

.TH Installing, examples, support and troubleshooting TDH "16-FEB-2005   TDH scg@jax.org" 

.SH Installing QUISP

.IP \(bu
Download from \fCquisp.sourceforge.net\fR.
Software distribution directory can be located anywhere (user directory or system directory)

.ig >>
<br><br>
.>>
.IP \(bu
If you're building \fCquisp_pl\fR (ploticus-enabled), take a look 
at \fCploticus/Makefile_api\fR in case you want to change any of the settings.
.ig >>
<a href="graphic.html#setup">
.>>
\0More info on quisp_pl and graphics
.ig >>
</a>
.>>

.ig >>
<br><br>
.>>

.IP \(bu
In the top level of the distribution, type: \fCmake all\fR
.br
\fBgcc\fR 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 \fC./bin\fR

.ig >>
<br><br>
.>>

.IP \(bu
Add the quisp bin to your search \fBPATH\fR to make the command line
utilities (\fCquisputil\fR and \fCshsql\fR) available.

.ig >>
<br><br>
.>>

.IP \(bu
Here's how to proceed with
.ig >>
<a href="project_setup.html">
.>>
\0setting up a QUISP-powered web site and trying some canned examples.
.ig >>
</a>
.>>


.ig >>
<br><br><br>
.>>

.SH Troubleshooting hints

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

.ig >>
<br><br>
.>>
.IP \(bu
Use your browser's \fCShow source\fR 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.


.ig >>
<br><br><br>
.>>
.IP \(bu
Try invoking \fCquisp\fR manually.  Supply user variables and values on the command
line as var=value pairs, eg. \fCquisp rtn=mypage x=2\fR.  The generated HTML
will be written to the screen.  You will also see any standard error content.

.ig >>
<br><br><br>
.>>
.IP \(bu
\fBWhat's the path name of my cgi bin?\fR 
Check with your local web administrators.

.ig >>
<br><br>
.>>

.IP \(bu
\fBWhy can't my web browser find quisp?\fR
Where CGI programs need to reside, and how they are named, can vary from site to site.
Check with your local web administrators.

.ig >>
<br><br>
.>>

.IP \(bu
\fBThe web server seems to be executing quisp, but quisp can't see any files outside
of the cgi bin or html docs directories.\fR
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.


.ig >>
<br><br><br>
.>>
.SH Support
.IP \0
Bugs and questions to Steve Grubb at \fCscg@jax.org\fR.
I am always happy to hear of interesting applications that this software used for.
.IP
.ig >>
<a href="http://ploticus.sourceforge.net/steve.html">
.>>
\0About the author.
.ig >>
</a>
.>>



.ig >>
<br>
<br>
</td></tr>
<td align=right>
<a href="quisp_home.html">
<img src="img/quisp2.gif" border=0></a><br>
<small>quick server pages &nbsp; &nbsp;<br>
<a href="Copyright.html">Copyright Steve Grubb</a> &nbsp; &nbsp;
</td></tr>
</table>
.>>
