Hi.
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.
Here's to mod_aspdotnet.
-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>
## 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>
</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>
<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>
</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 />
AspNetMount /HelloWorld "C:/HelloWorld" <br />
Alias /HelloWorld "C:/HelloWorld" <br />
<pre>
<Directory "C:/HelloWorld" >
Options FollowSymlinks Indexes
AspNet files
Order allow,deny
Allow from all
DirectoryIndex HelloWorld.aspx
</Directory>
</pre>
</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]
