In an effort the keep the mod_aspdotnet project alive, I've created a
small tutorial for implementing mod_aspdotnet in Apache 2.0.x. The
xml file is as complete as I can get it (it took me a few hours to
scout out the coding conventions), but I can't take it any farther
myself. It's attached to this email. If anyone can help me get it
applied, I would appreciate it greatly.
Several questions:
Where does this go? In the /docs/howtos/ directory?
Bill Rowe and/or Matt Lewandowski, can you please review this and put
your stamp of approval on it?
Is this specifically 2.0.x, or does it also apply to 2.2.x? I'd hate
to stick something in the 2.0 docs and have it vanish in the
2.2/2.3/2.4 docs.
Thanks.
The official release of mod_aspdotnet only works with 2.0.x (that is,
release 2.0.0), but the latest beta will work with 2.2.x. However, since
it wasn't ratified, I stuck with the official release. It will be
trivial to update the documentation if the beta is ever released though.
In reviewing the document, I updated a few lines and fixed a code error.
I've also tested it step-by-step on my machine without any contention of
quality. Thanks.
-Wraith
<?xml version="1.0"?>
<document>
<properties>
<author email="[email protected]">Apache httpd users</author>
<title>'Hello World' - a starter's tutorial to mod_aspdotnet</title>
</properties>
<body>
<section id="Prerequisites">
<title>Prerequisites</title>
<p>The following must be already in place on your system before you can install mod_aspdotnet:
<dl>
<dt>Windows NT or similar operating system</dt>
<dd>mod_aspdotnet will only run on a Windows system; for implementing asp.net applications
in other environments, there is <a href="http://www.mono-project.com/";>Mono</a>.
Furthermore, the Windows system must be based off of the NT kernel (Windows NT, 2000, XP,
and Vista).</dd>
<dt>The .NET runtime (<a href="http://asp.net/download.aspx";>http://asp.net/download.aspx</a>)</dt>
<dd>.NET runtime 1.0 or 1.1 must be installed. Support for 2.0 is being considered and can be used,
but that is beyond the scope of this tutorial.</dd>
<dt>Apache 2.0.x</dt>
<dd>For information on setting up your server, the Apache project provides
<a href="http://httpd.apache.org/docs/2.0/";>documentation</a>.</dd>
<dt>A simple knowledge of server configuration</dt>
<dd>This article assumes you know how to open the httpd.conf file, write lines to it, and save it (and optionally close it).</dd>
</dl></p>
</section>
<section id="Installing">
<title>Installing mod_aspdotnet</title>
<p>Assuming the prerequisites above are met, go ahead and download
<a href="http://archive.apache.org/dist/httpd/mod_aspdotnet/mod_aspdotnet-2.0.0.msi";>mod_aspdotnet 2.0.0</a>.
This is a self-installing MSI; simply run it to start the automated installation process. Accept all the prompts
and continue. Note again that only the Apache 2.0.x binaries are accepted in this official mod_aspdotnet release; support for
httpd 2.2 binaries are being considered.</p>
<p>After the MSI finished its installation, the mod_aspdotnet.so module is ready to be used. Open your httpd.conf
file and scroll to the end of the file. Create a new section there and copy the following code:
<p><strong>Basic Configuration</strong>
<code>
## Start mod_aspdotnet configuration section ## <br />
<br />
# Load in the mod_aspdotnet module<br />
LoadModule aspdotnet_module modules/mod_aspdotnet.so <br />
<br />
# Add support for ASP.NET file types <br />
AddHandler asp.net asax ascx ashx asmx aspx axd config cs csproj \ <br />
licx rem resources resx soap vb vbproj vsdisco webinfo <br />
# Technical jargon for attaching to the ASP.NET pipeline; <br />
# Note that the path to Windows below may be incorrect. You'll have to adjust it <br />
# based on your system.<br />
AliasMatch "^/(?i)aspnet_client/system_web/(\d+)_(\d+)_(\d+)_(\d+)/(.*)" \ <br />
"C:/Windows/Microsoft.NET/Framework/v$1.$2.$3/ASP.NETClientFiles/$4" <br />
<br />
# Technical jargon to allow files from the ASP.NET cache <br />
<Directory "C:/Windows/Microsoft.NET/Framework/v*/ASP.NETClientFiles"> <br />
Options FollowSymlinks <br />
Order allow,deny <br />
Allow from all <br />
</Directory>
</code>
</p> <br />
Note that the paths to Windows contained in the AliasMatch and Directory sections above may need to
be corrected from the default of C:/Windows. Note that Apache uses forward slash notation ( / ) instead of
the Windows default backslash notation ( \ ).</p></section>
<section id="Mounting">
<p>mod_aspdotnet is now ready to go. Before you can run any ASP.NET applications, however, you must
mount them into Apache. The aspdotnet module is extremely powerful and can mount a number of applications
without difficulty; for the purpose of this tutorial we will simply mount a sample directory. First, create the sample
directory (in this article, I will use C:/helloworld). Inside that directory, create a file called HelloWorld.aspx and copy
the following code into it:
<p><strong>HelloWorld.aspx:</strong>
<code>
<pre>
<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
</script>
<html xmlns="http://www.w3.org/1999/xhtml"; >
<head runat="server">
<title>Hello World! - mod_aspdotnet</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<% Response.Write("<h1>Hello World!</h1>")%>
</div>
</form>
</body>
</html>
</pre>
</code>
</p><br />
Save this file and close it. Open httpd.conf again and scroll down the bottom. Now we will mount the application:
<p><strong>Mounting HelloWorld:</strong> <br />
<code>
AspNetMount /HelloWorld "C:/HelloWorld" <br />
Alias /HelloWorld "C:/HelloWorld" <br />
<pre>
<Directory "C:/HelloWorld" >
Options FollowSymlinks Indexes
Order allow,deny
Allow from all
DirectoryIndex HelloWorld.aspx
</Directory>
</pre>
</code>
</p></p>
<p>The sample application is ready to run! Open up your browser, go to <a href="http://localhost/HelloWorld";>the sample</a>,
and view your ASP.NET masterpiece. From here, the sky is the limit! For further information on mod_aspdotnet, refer to
<a href="http://httpd.apache.org/docs/trunk/mod/mod_aspdotnet.html";>http://httpd.apache.org/docs/trunk/mod/mod_aspdotnet.html</a>.</p>
</section>
</body>
</document>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
