You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by wr...@apache.org on 2004/11/21 03:36:10 UTC
svn commit: r106055 - httpd/site/trunk/xdocs/cli
Author: wrowe
Date: Sat Nov 20 18:36:08 2004
New Revision: 106055
Modified:
httpd/site/trunk/xdocs/cli/index.xml
httpd/site/trunk/xdocs/cli/introduction.xml
Log:
Here we go, no longer incubating, cleaning up some slop and
getting ready for the world.
Modified: httpd/site/trunk/xdocs/cli/index.xml
==============================================================================
--- httpd/site/trunk/xdocs/cli/index.xml (original)
+++ httpd/site/trunk/xdocs/cli/index.xml Sat Nov 20 18:36:08 2004
@@ -7,40 +7,55 @@
<body>
<section id="Welcome">
-<title>Welcome to the Apache HTTP Server CLI sub-project</title>
+<title>Welcome to the CLI sub-project of the Apache HTTP Server</title>
-<p><strong>The CLI project is currently under incubation. See the
-<a href="http://incubator.apache.org/projects/httpd-cli">httpd-cli</a>
-incubation page for more details, and learn what the incubation process
-consists of.</strong></p>
-
-<p>This project is focused on developing interfaces to the various CLR alternatives
-for .NET integration of the Apache HTTP Server Project. This is a subproject of the
-<a href="/">Apache HTTP Server Project</a>.</p>
+<p>This project is focused on developing interfaces to the various Common
+Language Runtime (CLR) alternatives for .NET integration into the Apache HTTP
+Server. This is a subproject of the <a href="../">Apache HTTP Server Project</a>.</p>
</section>
<section id="mod_aspdotnet">
<title>mod_aspdotnet Apache HTTP Server 2.0 Module</title>
-<p>mod_aspdotnet is an interface to Microsoft's ASP.NET engine. It is
-implemented with an Apache.Web assembly that provides ASP.NET with
-Apache-centric System.Web.Host and System.Web.Request interfaces.</p>
-
-<p>mod_aspdotnet works only with the .NET Framework version 1.1 at this
-time. Flexibility for 1.0 or 2.0 .NET Frameworks is being considered.</p>
-
-<p>This module is not compatible other .NET CLR interfaces, such as Rotor
-or Mono, and therefore it is only compatible with the Win32 port of
-Apache 2.0.</p>
+<p>mod_aspdotnet is an ASP.NET host interface to Microsoft's ASP.NET engine.
+It is implemented with an Apache.Web.dll assembly that provides ASP.NET with
+the necessary System.Web.Host and System.Web.Request interfaces to converse
+with mod_aspdotnet and the Apache HTTP Server.</p>
+
+<p>mod_aspdotnet works <strong>only</strong> with the .NET Framework version
+1.1 at this time. Flexibility for 1.0 or 2.0 .NET Frameworks is being
+considered.</p>
+
+<p>This module is <strong>not</strong> compatible other .NET CLR interfaces,
+such as Rotor or Mono, and therefore it is only compatible with the Win32
+port of Apache 2.0.</p>
+
+<p>Users on non-Win32 platforms may wish to explore the
+<a href="http://www.mono-project.com/about/index.html">mono project's</a>
+implementation of
+<a href="http://www.mono-project.com/contributing/asp-net.html">mod_mono</a>,
+also for Apache HTTP Server, and compatible with some non-Win32 platforms.
+The mono project is not affiliated with the Apache Software Foundation.</p>
-<p>The 2.0.0 release candidate 1 is now available for testing.</p>
+</section>
+<section id="Released">
+<title>mod_aspdotnet 2.0.0 release is current</title>
<ul>
-<li><a href="mod_aspdotnet">mod_aspdotnet</a> - The module reference page</li>
-<li><a href="http://httpd.apache.org/dev/dist/incubating-httpd-cli-mod_aspdotnet-2.0.0-rc1.msi">mod_aspdotnet</a> - Download RC1 .msi installer</li>
+<li><a href="introduction">An introduction</a> to mod_aspdotnet</li>
+<li>The <a href="mod_aspdotnet">mod_aspdotnet</a> module reference page</li>
+<li>Download the <a href="http://www.apache.org/dist/httpd/mod_aspdotnet/mod_aspdotnet-2.0.0.msi">mod_aspdotnet 2.0.0 .msi installer</a></li>
+<li>Obtain the <a href="http://www.apache.org/dist/httpd/mod_aspdotnet/mod_aspdotnet-2.0.0-src.zip">mod_aspdotnet 2.0.0 source files</a></li>
</ul>
+<p>Bugs are tracked at <a href="http://issues.apache.org/bugzilla/"
+ >http://issues.apache.org/bugzilla/</a> under the 'Apache mod_aspdotnet'
+ Bugzilla product name. Please consult
+ <a href="http://issues.apache.org/bugzilla/buglist.cgi?resolution=FIXED&resolution=WONTFIX&resolution=---&product=Apache+mod_aspdotnet;"
+ >this list of issues marked *open, *resolved, or *won't-fix</a>
+ before posting your questions to the mailing list or adding a new bug ticket.</p>
+
</section>
<section id="Mail">
@@ -48,6 +63,11 @@
<p>Our mailing lists are open to the public.</p>
+<p><strong>Please</strong> use cli-users to discuss how to deploy your ASP.NET
+applications (and discuss problems you encounter), while reserving the cli-dev list
+for (detailed) bug reports about the mod_aspdotnet and Apache.Web modules,
+once you are certain it is a bug in this module and not a misconfiguration.</p>
+
<p>Subscription</p>
<ul>
<li><a href="mailto:cli-dev-subscribe@httpd.apache.org">cli-dev@httpd.apache.org</a> - development discussions</li>
@@ -56,6 +76,7 @@
<p>Archives</p>
<ul>
+<li><a href="http://mail-archives.apache.org/eyebrowse/SummarizeList?listId=235">cli-dev Archives</a></li>
<li><a href="http://httpd.apache.org/mail/cli-dev/">cli-dev Archives (Raw)</a></li>
</ul>
</section>
@@ -63,17 +84,19 @@
<section id="SVN">
<title>SVN access</title>
-<p>You may browse the httpd-cli SVN repository <a href="http://svn.apache.org/viewcvs.cgi/incubator/httpd/cli/">online</a></p>
+<p>You may browse the mod_aspdotnet SVN repository <a href="http://svn.apache.org/viewcvs.cgi/httpd/mod_aspdotnet/">online</a></p>
<p>Anonymous SVN access (via http) is available.</p>
<pre>
- % svn co http://svn.apache.org/repos/asf/incubator/httpd/cli
+ % svn co http://svn.apache.org/repos/asf/httpd/mod_aspdotnet/trunk mod_aspdotnet
</pre>
+</section>
+
<section id="License">
<title>License</title>
-<p>Like all Apache Software Foundation projects, flood is licensed under
+<p>Like all Apache Software Foundation projects, mod_aspdotnet is licensed under
<a href="http://www.apache.org/licenses/">The Apache License</a>.</p>
</section>
@@ -92,7 +115,6 @@
<p align="center"><a href="/images/apache_pb.gif"><img border="0"
src="/images/apache_pb.gif" alt="Powered by Apache" width="259"
height="32" /></a></p>
-</section>
</section>
</body>
Modified: httpd/site/trunk/xdocs/cli/introduction.xml
==============================================================================
--- httpd/site/trunk/xdocs/cli/introduction.xml (original)
+++ httpd/site/trunk/xdocs/cli/introduction.xml Sat Nov 20 18:36:08 2004
@@ -1,13 +1,30 @@
<?xml version="1.0"?>
<document>
<properties>
- <author email="cli-dev@httpd.apache.org">cli-dev subproject team</author>
+ <author email="cli-users@httpd.apache.org">cli-users support team</author>
<title>Introduction to mod_aspdotnet</title>
</properties>
<body>
-<section>
-<title>What Is ASP.NET?</title>
+<section id="Project">
+<title>What is the cli (.NET) project?</title>
+
+<p>The cli subproject stands for Common Language Interfaces. These include
+only mod_aspdotnet today, but the developers in the cli subproject are looking
+forward to building additional .NET flexibility into Apache HTTP Server.</p>
+
+<p>This document will introduce you to all of the key concepts you might be
+unfamiliar with, introduce you to mod_aspdotnet and the purpose it serves,
+and what you can accomplish with it. This document is a work in progress,
+feedback is welcome at the cli-users mailing list.</p>
+
+<p>See the <a href="http://httpd.apache.org/cli/">cli subproject site</a>
+for information about mailing lists, other resources and how to participate
+in these ongoing efforts!</p>
+
+</section>
+<section id=".NET">
+<title>What Is .NET?</title>
<p>Microsoft's marketing of .NET is a vision encompasing a wide spectrum of
technologies, not one specific new technology. This leads to some confusion
about .NET development and what web development under .NET really entails.</p>.
@@ -25,27 +42,44 @@
<p>Microsoft's .NET Framework includes many core facilities, packaged as
language-agnostic classes that can be generally used by any .NET language.
-It includes the C# compiler, and the ASP.NET related classes (known internally
-as System.Web) that provide web applications the facilities to query and
-collect information on the current request, prepare the response and maintain
-session state information. ASP.NET simplifies the chore of building web
-applications down to the essential task of generating and serving content.</p>
+It includes the C# compiler, and the ASP.NET related classes.</p>
</section>
-<section>
+<section id="ASP.NET">
+<title>What Is ASP.NET?</title>
+<p>ASP.NET (known inside the .NET framework as System.Web) is a hosting
+environment for web applications that provides facilities to query and
+collect information about the current request, prepare the response, and
+maintain session state information. ASP.NET simplifies the chore of
+building web applications down to the essential task of generating and
+serving content.</p>
+
+<p>The converse question, "are ASP.NET and ASP the same thing?", deserves
+a resounding answer of <strong>NO</strong>. Although in some respects
+they offer similar facilities, they have no relation to each other.
+mod_aspdotnet only provides the ASP.NET environment, and does nothing
+for ASP content. Simply put, ASP.NET has replaced ASP, and ASP runs in
+its own environment(s), (one per scripting language) and not inside the
+.NET framework.</p>
+
+<p>If you have ASP pages to serve, consider porting them to ASP.NET.
+There are many fine books and online guides to assist you.</p>
+
+</section>
+<section id="mod_aspdotnet">
<title>What is mod_aspdotnet?</title>
-<p>This is actually two moduless; mod_aspdotnet.so is an in-process
+<p>This is actually two modules; mod_aspdotnet.so is an in-process
Apache 2.0 module, which starts the ASP.NET engine and hands off requests
to the ASP.NET engine. There is a second module compiled for .NET, which
is Apache.Web.dll. The Apache.Web.dll is loaded into Microsoft's ASP.NET
host environment and dispatches request and response operations back to
-the mod_aspdotnet.so. This combination of managed (ASP.NET-side) and
+the mod_aspdotnet.so. This combination of managed (.NET-side) and
unmanaged (Apache-side) code, running in the same process as the Apache 2.0
server, attains the optimal performance for serving ASP.NET content. The
-solution maintains tight compatibility with existing, IIS-hosted ASP.NET
-because the Microsoft ASP.NET hosting environment is running under both
-of these scenarios.</p>
+solution maintains tight compatibility with existing, IIS-hosted ASP.NET,
+because the same Microsoft ASP.NET hosting environment is running under
+either of these scenarios.</p>
<p>Multiple ASP.NET virtual webs are supported by the mod_aspdotnet module.
A request is directed to the asp.net handler using conventional Apache
@@ -70,18 +104,25 @@
implementation of ASP.NET for Apache httpd server.</p>
</section>
-<section>
+<section id="Starting">
<title>Getting Started</title>
<p>Microsoft's .NET Framework is available as a free download for Windows 2000
or 2003 Professional and Server versions, XP Professional, and .NET Server
-platforms from <http://asp.net/download.aspx>. You must minimally install
-the .NET Framework Resdistributable version, while developers will prefer to
-install the .NET Framework Software Development Kit, or another .NET
-development tool such as VisualStudio .NET.</p>
+platforms from <a href="http://asp.net/download.aspx">http://asp.net/download.aspx</a>.
+You must minimally install the .NET Framework Resdistributable version, while
+developers will prefer to install the .NET Framework Software Development Kit, or
+another .NET development tool such as VisualStudio .NET.</p>
+
+<p>Once you download and install the mod_aspdotnet .msi package, it will install
+both mod_aspdotnet.so into your Apache2/modules/ directory, and the Apache.Web.dll
+into the Global Assembly Cache. You then need to modify your Apache2/conf/httpd.conf
+file to load the mod_aspdotnet.so module, and declare what content you will serve.
+See the <a href="mod_aspdotnet">mod_aspdotnet</a> module documentation for the
+directives to add for a typical scenario, or follow the Example below.</p>
</section>
-<section>
+<section id="Example">
<title>An Example Configuration - Microsoft's IBuySpy Sample</title>
<p>The following configuration will support the Microsoft IBuySpy sample, an
@@ -92,58 +133,46 @@
for the C# flavor of the IBuySpy Store sample, installed into the default
installation directory:</p>
-<code>
-LoadModule aspdotnet_module modules/mod_aspdotnet.so<br />
-<br />
-# Use the asp.net handler for all common 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 />
-<br />
-<IfModule mod_aspdotnet.cpp><br />
-<br />
- # Mount the IBuySpy C# example application<br />
- AspNetMount /StoreCSVS "C:/StoreCSVS/StoreCSVS"<br />
-<br />
- # Map all requests for /StoreCSVS to the IBuySpy application files<br />
- Alias /StoreCSVS "C:/StoreCSVS/StoreCSVS"<br />
-<br />
- # Allow asp.net scripts to be executed in the IBuySpy example<br />
- <Directory "C:/StoreCSVS/StoreCSVS"><br />
- Options FollowSymlinks ExecCGI<br />
- Order allow,deny<br />
- Allow from all<br />
- DirectoryIndex Default.htm Default.aspx<br />
- </Directory><br />
-<br />
- # For all virtual ASP.NET webs, we need the aspnet_client files <br />
- # to serve the client-side helper scripts.<br />
- AliasMatch /aspnet_client/system_web/(\d+)_(\d+)_(\d+)_(\d+)/(.*) \<br />
- "C:/Windows/Microsoft.NET/Framework/v$1.$2.$3/ASP.NETClientFiles/$4"<br />
- <Directory \<br />
- "C:/Windows/Microsoft.NET/Framework/v*/ASP.NETClientFiles"><br />
- Options FollowSymlinks<br />
- Order allow,deny<br />
- Allow from all<br />
- </Directory><br />
-<br />
-</IfModule><br />
-</code>
+<pre>
+LoadModule aspdotnet_module modules/mod_aspdotnet.so
+
+# Use the asp.net handler for all common ASP.NET file types
+AddHandler asp.net asax ascx ashx asmx aspx axd config cs csproj \
+ licx rem resources resx soap vb vbproj vsdisco webinfo
+
+<IfModule mod_aspdotnet.cpp>
+
+ # Mount the IBuySpy C# example application
+ AspNetMount /StoreCSVS "C:/StoreCSVS/StoreCSVS"
+
+ # Map all requests for /StoreCSVS to the IBuySpy application files
+ Alias /StoreCSVS "C:/StoreCSVS/StoreCSVS"
+
+ # Allow asp.net scripts to be executed in the IBuySpy example
+ <Directory "C:/StoreCSVS/StoreCSVS">
+ Options FollowSymlinks ExecCGI
+ Order allow,deny
+ Allow from all
+ DirectoryIndex Default.htm Default.aspx
+ </Directory>
+
+ # For all virtual ASP.NET webs, we need the aspnet_client files
+ # to serve the client-side helper scripts.
+ AliasMatch /aspnet_client/system_web/(\d+)_(\d+)_(\d+)_(\d+)/(.*) \
+ "C:/Windows/Microsoft.NET/Framework/v$1.$2.$3/ASP.NETClientFiles/$4"
+ <Directory \
+ "C:/Windows/Microsoft.NET/Framework/v*/ASP.NETClientFiles">
+ Options FollowSymlinks
+ Order allow,deny
+ Allow from all
+ </Directory>
+
+</IfModule>
+</pre>
<p>Configuring the VisualBasic.NET version is very similar, simply change the
<code>StoreCSVS</code> directory names above to the name
<code>StoreVBVS</code>.</p>
-
-</section>
-<section>
-<title> What is the cli subproject of Apache httpd project?</title>
-
-<p>The cli subproject stands for Common Language Interfaces. These include
-only mod_aspdotnet today, but the developers in the cli subproject are looking
-forward to building more Apache-specific framework, tightly coupled to Apache
-httpd server, similar to the flexibility offered by mod_perl.</p>
-
-<p>See the <a href="http://httpd.apache.org/cli/>cli subproject site</a>
-for information on how to participate in these ongoing efforts!</p>
</section>
</body>