view release on metacpan or  search on metacpan

site/config.html  view on Meta::CPAN

sub second timing of the time it takes Apache::ASP to process
a request.  This will not include the time spent in the 
session manager, nor modperl or Apache, and is only a 
rough approximation at best.
<font face="courier new" size=3><pre>
</pre></font>If Debug is set also, you will get a comment in your
HTML output that indicates the time it took to process
that script.
<font face="courier new" size=3><pre>
</pre></font>If system debugging is set with Debug -1 or -2, you will
also get this time in the Apache error log with the 
other system messages.</font>
	
	<p>
	<a name=Mail%20Adminis1a4d2b59></a>
	<font face=verdana><font class=title size=+0 color=#555555><b>Mail Administration</b></font>
<font face="courier new" size=3><pre>
</pre></font>Apache::ASP has some powerful administrative email
extensions that let you sleep at night, knowing full well
that if an error occurs at the web site, you will know
about it immediately.  With these features already enabled,
it was also easy to provide the $Server-&gt;Mail(\%mail) API 
extension which you can read up about in the <a href=objects.html><font size=-1 face=verdana><b>OBJECTS</b></font></a> section.</font>
	
	<p>
	<a name=MailHost></a>
	<font face=verdana><font class=title size=-1 color=#555555><b>MailHost</b></font>
<font face="courier new" size=3><pre>
</pre></font>The mail host is the smtp server that the below Mail* config directives
will use when sending their emails.  By default Net::SMTP uses
smtp mail hosts configured in Net::Config, which is set up at
install time, but this setting can be used to override this config.
<font face="courier new" size=3><pre>
</pre></font>The mail hosts specified in the Net::Config file will be used as
backup smtp servers to the MailHost specified here, should this
primary server not be working.
<font face="courier new" size=3><pre>
  PerlSetVar MailHost smtp.yourdomain.com.foobar
</pre></font>
	
	<p>
	<a name=MailFrom></a>
	<font face=verdana><font class=title size=-1 color=#555555><b>MailFrom</b></font>
<font face="courier new" size=3><pre>
</pre></font>Default NONE, set this to specify the default mail address placed 
in the From: mail header for the $Server-&gt;Mail() API extension, 
as well as MailErrorsTo and MailAlertTo.
<font face="courier new" size=3><pre>
  PerlSetVar MailFrom <b>&#121;&#111;&#117;&#114;&#101;&#109;&#097;&#105;&#108;&#064;&#121;&#111;&#117;&#114;&#100;&#111;&#109;&#097;&#105;&#110;&#046;&#099;&#111;&#109;&#046;&#102;&#111;&#111;&#098;&#097;&#114;</b>
</pre></font>
	
	<p>
	<a name=MailErrorsTo></a>
	<font face=verdana><font class=title size=-1 color=#555555><b>MailErrorsTo</b></font>
<font face="courier new" size=3><pre>
</pre></font>No default, if set, ASP server errors, error code 500, that result
while compiling or running scripts under Apache::ASP will automatically
be emailed to the email address set for this config.  This allows
an administrator to have a rapid response to user generated server
errors resulting from bugs in production ASP scripts.  Other errors, such 
as 404 not found will be handled by Apache directly.
<font face="courier new" size=3><pre>
</pre></font>An easy way to see this config in action is to have an ASP script which calls
a die(), which generates an internal ASP 500 server error.
<font face="courier new" size=3><pre>
</pre></font>The Debug config of value 2 and this setting are mutually exclusive,
as Debug 2 is a development setting where errors are displayed in the browser,
and MailErrorsTo is a production setting so that errors are silently logged
and sent via email to the web admin.
<font face="courier new" size=3><pre>
  PerlSetVar MailErrorsTo <b>&#121;&#111;&#117;&#114;&#101;&#109;&#097;&#105;&#108;&#064;&#121;&#111;&#117;&#114;&#100;&#111;&#109;&#097;&#105;&#110;&#046;&#099;&#111;&#109;</b>
</pre></font>
	
	<p>
	<a name=MailAlertTo></a>
	<font face=verdana><font class=title size=-1 color=#555555><b>MailAlertTo</b></font>
<font face="courier new" size=3><pre>
</pre></font>The address configured will have an email sent on any ASP server error 500,
and the message will be short enough to fit on a text based pager.  This
config setting would be used to give an administrator a heads up that a www
server error occurred, as opposed to MailErrorsTo would be used for debugging
that server error.
<font face="courier new" size=3><pre>
</pre></font>This config does not work when Debug 2 is set, as it is a setting for
use in production only, where Debug 2 is for development use.
<font face="courier new" size=3><pre>
  PerlSetVar MailAlertTo <b>&#121;&#111;&#117;&#114;&#101;&#109;&#097;&#105;&#108;&#064;&#121;&#111;&#117;&#114;&#100;&#111;&#109;&#097;&#105;&#110;&#046;&#099;&#111;&#109;</b>
</pre></font>
	
	<p>
	<a name=MailAlertPer096b67a8></a>
	<font face=verdana><font class=title size=-1 color=#555555><b>MailAlertPeriod</b></font>
<font face="courier new" size=3><pre>
</pre></font>Default 20 minutes, this config specifies the time in minutes over 
which there may be only one alert email generated by MailAlertTo.
The purpose of MailAlertTo is to give the admin a heads up that there
is an error at the www server.  MailErrorsTo is for to aid in speedy 
debugging of the incident.
<font face="courier new" size=3><pre>
  PerlSetVar MailAlertPeriod 20
</pre></font>
	
	<p>
	<a name=File%20Uploads></a>
	<font face=verdana><font class=title size=+0 color=#555555><b>File Uploads</b></font>
</font>
	
	<p>
	<a name=FileUploadMa625d7c4d></a>
	<font face=verdana><font class=title size=-1 color=#555555><b>FileUploadMax</b></font>
<font face="courier new" size=3><pre>
</pre></font>default 0, if set will limit file uploads to this
size in bytes.  This is currently implemented by 
setting $<a href=cgi.html><font size=-1 face=verdana><b>CGI</b></font></a>::POST_MAX before handling the file
upload.  Prior to this, a developer would have to
hardcode a value for $CGI::POST_MAX to get this 
to work.
<font face="courier new" size=3><pre>
  PerlSetVar 100000
</pre></font>