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 05:09:57 UTC
svn commit: r106066 - httpd/site/trunk/docs/cli
Author: wrowe
Date: Sat Nov 20 20:09:56 2004
New Revision: 106066
Added:
httpd/site/trunk/docs/cli/introduction.html
Log:
Here we go, new intro
Added: httpd/site/trunk/docs/cli/introduction.html
==============================================================================
--- (empty file)
+++ httpd/site/trunk/docs/cli/introduction.html Sat Nov 20 20:09:56 2004
@@ -0,0 +1,267 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html>
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
+ <meta name="author" content="cli-users support team" /><meta name="email" content="cli-users@httpd.apache.org" />
+ <title>Introduction to mod_aspdotnet - The Apache HTTP Server Project</title>
+ </head>
+ <body bgcolor="#ffffff" text="#000000" link="#525D76">
+<p><a href="/"><img src="../images/httpd_logo_wide.gif" alt="The Apache HTTP Server Project" border="0"/></a></p>
+ <table border="0" width="100%" cellspacing="4">
+ <tr>
+ <!-- LEFT SIDE NAVIGATION -->
+ <td valign="top" nowrap="nowrap">
+ <a href="http://apachecon.com/"
+ ><img src="http://www.apache.org/images/ac2004us_logo_only.gif" height="100"
+ width="170" border="0" alt="ApacheCon 2004" /></a>
+ <p><b>Essentials</b></p>
+ <menu compact="compact">
+ <li><a href="/ABOUT_APACHE.html">About</a></li>
+ <li><a href="http://www.apache.org/licenses/">License</a></li>
+ <li><a href="/docs/misc/FAQ.html">FAQ</a></li>
+ <li><a href="/security_report.html">Security<br />Reports</a></li>
+ </menu>
+ <p><b>Download!</b></p>
+ <menu compact="compact">
+ <li><a href="/download.cgi">from a mirror</a></li>
+ </menu>
+ <p><b><a
+href="/docs-project/">Documentation</a></b></p>
+ <menu compact="compact">
+ <li><a href="/docs/">Apache 1.3</a></li>
+ <li><a href="/docs-2.0/">Apache 2.0</a></li>
+ </menu>
+ <p><b>Get Involved</b></p>
+ <menu compact="compact">
+ <li><a href="/lists.html">Mailing Lists</a></li>
+ <li><a href="/bug_report.html">Bug Reports</a></li>
+ <li><a href="/dev/">Developer Info</a></li>
+ </menu>
+ <p><b>Subprojects</b></p>
+ <menu compact="compact">
+ <li><a href="/docs-project/">Docs</a></li>
+ <li><a href="/test/">Test</a></li>
+ <li><a href="/test/flood/">Flood</a></li>
+ <li><a href="/apreq/">libapreq</a></li>
+ <li><a href="/modules/">Modules</a></li>
+ <li><a href="/cli/">cli (.NET)</a></li>
+ </menu>
+ <p><b><a
+href="/info/">Miscellaneous</a></b></p>
+ <menu compact="compact">
+ <li><a href="/contributors/">Contributors</a></li>
+ <li><a href="/awards.html">Awards</a></li>
+ <li><a href="http://webring.com/hub?ring=apachesupport">Support<br />Webring</a></li>
+ </menu>
+ </td>
+ <!-- RIGHT SIDE INFORMATION -->
+ <td align="left" valign="top">
+ <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#525D76">
+ <font color="#ffffff" face="arial,helvetica,sanserif">
+ <a name="Project"><strong>What is the cli (.NET) project?</strong></a>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+<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>
+ </blockquote>
+ </td></tr>
+</table>
+ <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#525D76">
+ <font color="#ffffff" face="arial,helvetica,sanserif">
+ <a name=".NET"><strong>What Is .NET?</strong></a>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+<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>
+<p>The deepest underpinning of .NET is a new program execution model, the CLR
+(Common Language Runtime), which hosts IL (Intermediate Language) code.
+This model is very similar to Java's JVM running .class'es compiled into
+Java bytecode. Far different than the classic interpreted script (such as
+Perl) or compiled machine code (such as C or C++), the CLR enforces rules
+to ensure code trust, machine security and data integrity. Many languages
+are already available for writing code to run within the CLR, including
+C#, and Microsoft's C++.NET, VisualBasic.NET and J#. Many third party
+companies are bringing additional languages to the .NET managed code world,
+there are more than 20 different languages shipping today.</p>
+<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.</p>
+ </blockquote>
+ </td></tr>
+</table>
+ <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#525D76">
+ <font color="#ffffff" face="arial,helvetica,sanserif">
+ <a name="ASP.NET"><strong>What Is ASP.NET?</strong></a>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+<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>
+ </blockquote>
+ </td></tr>
+</table>
+ <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#525D76">
+ <font color="#ffffff" face="arial,helvetica,sanserif">
+ <a name="mod_aspdotnet"><strong>What is mod_aspdotnet?</strong></a>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+<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 (.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 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
+configuration options, and is mapped to a specific ASP.NET virtual web by
+matching the requested URI to the AspNetMount directives given for the
+specific Apache virtual host, uri, and file location. The same AspNetMount
+can be given in multiple Apache virtual hosts. Any given AspNetMount is
+created only once for all Apache virtual hosts that share the same AspNetMount,
+conserving memory and resources.</p>
+<p>AspNetMount and other directive changes are processed when the server is
+restarted. With Apache 2.0, the original Windows child process continues to
+serve requests until a new child process is ready to process requests itself.
+This provides minimal interruption of service when modifying the web server
+configuration. The restart option begins a graceful restart sequence, loading
+and initializing the new server while the old server finishes fulfilling open
+requests, and there is no interruption in web services during the transition
+from the old to the new configuration.</p>
+<p>This is not a module for Unix platforms. The Mono project's mod_mono
+provides very similar features for non-Win32 machines, with their own
+implementation of ASP.NET for Apache httpd server.</p>
+ </blockquote>
+ </td></tr>
+</table>
+ <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#525D76">
+ <font color="#ffffff" face="arial,helvetica,sanserif">
+ <a name="Starting"><strong>Getting Started</strong></a>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+<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 <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>
+ </blockquote>
+ </td></tr>
+</table>
+ <table border="0" cellspacing="0" cellpadding="2" width="100%">
+ <tr><td bgcolor="#525D76">
+ <font color="#ffffff" face="arial,helvetica,sanserif">
+ <a name="Example"><strong>An Example Configuration - Microsoft's IBuySpy Sample</strong></a>
+ </font>
+ </td></tr>
+ <tr><td>
+ <blockquote>
+<p>The following configuration will support the Microsoft IBuySpy sample, an
+illustration of a web storefront. IBuySpy is available as a free download
+from <a href="http://asp.net/ibuyspy/">http://asp.net/ibuyspy/</a>. Note that
+Microsoft SQL Server version 7.0 must be installed before installing the
+Microsoft IBuySpy sample. The configuration below illustrates configuration
+for the C# flavor of the IBuySpy Store sample, installed into the default
+installation directory:</p>
+<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>
+ </blockquote>
+ </td></tr>
+</table>
+ </td>
+ </tr>
+ <!-- FOOTER -->
+ <tr><td colspan="2"><hr noshade="noshade" size="1"/></td></tr>
+ <tr><td colspan="2" align="center">
+ <font size="-1">
+ <em>Copyright © 1999-2004, The Apache Software Foundation</em>
+ </font>
+ </td>
+ </tr>
+ </table>
+ </body>
+</html>