SF.net SVN: mod-aspdotnet: [167] mod_aspdotnet/trunk/docs
Brought to you by:
wrowe
From: <wr...@us...> - 2006-10-12 17:46:27
|
Revision: 167 http://svn.sourceforge.net/mod-aspdotnet/?rev=167&view=rev Author: wrowe Date: 2006-10-12 10:46:02 -0700 (Thu, 12 Oct 2006) Log Message: ----------- Now hosted at Sourceforge, the source site generation files don't make much sense anymore. Removed Paths: ------------- mod_aspdotnet/trunk/docs/introduction.xml mod_aspdotnet/trunk/docs/mod_aspdotnet.html mod_aspdotnet/trunk/docs/mod_aspdotnet.xml mod_aspdotnet/trunk/docs/mod_aspdotnet.xml.meta Deleted: mod_aspdotnet/trunk/docs/introduction.xml =================================================================== --- mod_aspdotnet/trunk/docs/introduction.xml 2006-09-07 19:00:16 UTC (rev 166) +++ mod_aspdotnet/trunk/docs/introduction.xml 2006-10-12 17:46:02 UTC (rev 167) @@ -1,193 +0,0 @@ -<?xml version="1.0"?> -<document> - <properties> - <author email="us...@ht...">Apache httpd users</author> - <title>Introduction to mod_aspdotnet</title> - </properties> -<body> - -<section id="Server"> -<title>What is the Apache HTTP Server?</title> - -<p>The Apache HTTP Server is a robust implementation of an HTTP/1.1 server -which runs on Windows, various flavors of unix and other modern operating -systems. It is a modular framework, which allows modules supporting various -features to be loaded, or not, as required by the administrator.</p> - -<p>The mod_aspdotnet module is provided only for the Windows operating system, -and this module won't work for the other operating systems. See the -<a href="http://httpd.apache.org/mod_aspdotnet/">mod_aspdotnet main page</a> -for alternatives available to users of other operating systems.</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 users mailing list.</p> - -<p>See the <a href="http://httpd.apache.org/mod_aspdotnet/">mod_aspdotnet -pages</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 much 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> - -</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 modules; the first, 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 named 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 very 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> - -</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 -<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>This module effort explicitly does not support Windows NT, ME, or 9x. If you -are using a version of Windows prior to Windows 2000, your results will vary. -Please don't waste the developer's time contacting the project with questions -about these historical footnote platforms.</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 id="Example"> -<title>An Example Configuration - Microsoft's IBuySpy Sample</title> - -<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 - AspNet Files - 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 <code>StoreVBVS</code>.</p> - -</section> -</body> -</document> - Deleted: mod_aspdotnet/trunk/docs/mod_aspdotnet.html =================================================================== --- mod_aspdotnet/trunk/docs/mod_aspdotnet.html 2006-09-07 19:00:16 UTC (rev 166) +++ mod_aspdotnet/trunk/docs/mod_aspdotnet.html 2006-10-12 17:46:02 UTC (rev 167) @@ -1,3 +0,0 @@ -URI: mod_aspdotnet.html.en -Content-Language: en -Content-type: text/html; charset=ISO-8859-1 Deleted: mod_aspdotnet/trunk/docs/mod_aspdotnet.xml =================================================================== --- mod_aspdotnet/trunk/docs/mod_aspdotnet.xml 2006-09-07 19:00:16 UTC (rev 166) +++ mod_aspdotnet/trunk/docs/mod_aspdotnet.xml 2006-10-12 17:46:02 UTC (rev 167) @@ -1,227 +0,0 @@ -<?xml version="1.0"?> -<!DOCTYPE modulesynopsis SYSTEM "http://httpd.apache.org/docs-2.0/style/modulesynopsis.dtd"> -<?xml-stylesheet type="text/xsl" href="http://httpd.apache.org/docs-2.0/style/manual.en.xsl"?> -<!-- $LastChangedRevision$ --> - -<!-- - Copyright 2002-2004 The Apache Software Foundation - - Licensed under the Apache License, Version 2.0 (the "License"); - you may not use this file except in compliance with the License. - You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, software - distributed under the License is distributed on an "AS IS" BASIS, - WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - See the License for the specific language governing permissions and - limitations under the License. ---> - -<modulesynopsis metafile="mod_aspdotnet.xml.meta"> - -<name>mod_aspdotnet</name> -<description>Provides an interface for ASP.NET content between Apache HTTP -Server 2.0 and Microsoft's ASP.NET host.</description> -<status href="http://httpd.apache.org/mod_aspdotnet/">External</status> -<sourcefile>mod_aspdotnet.cpp</sourcefile> -<identifier>aspdotnet_module</identifier> -<compatibility>Compatible only with httpd 2.0.44 and later.</compatibility> - -<summary> - <p>The <directive module="mod_aspdotnet">AspNet</directive> and - <directive module="mod_aspdotnet">AspNetMount</directive> directives - and asp.net handler provided by <module>mod_aspdotnet</module> are used - to configure content to be served of the ASP.NET engine.</p> - - <p>The current version is compatible with the .NET Framework versions 1.x - (1.0, 1.1, etc). The current version is not compatible with .NET Framework - version 2.0 although this may be addressed in the future.</p> - - <p>Only modern Windows NT-based operating systems (2000, XP, 2003, etc) are - supported. Older versions such as Windows 98 and ME are not, Windows NT 6 - requires Service Pack 6, and the module authors will not invest time or - effort on these older versions. Do not contact the project regarding - support of older operating systems.</p> -</summary> - -<seealso><a href="../handler.html">Configuring Handlers</a></seealso> - -<section id="usage"><title>Usage</title> - <p>Several global configurations must be given to enable the Apache - HTTP Server to correctly serve ASP.NET application content.</p> - - <example><title>Example:</title> -LoadModule aspdotnet_module modules/mod_aspdotnet.so <br /> -<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 /> -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 /> -<Directory "C:/Windows/Microsoft.NET/Framework/v*/ASP.NETClientFiles"><br /> - Options FollowSymlinks<br /> - Order allow,deny<br /> - Allow from all<br /> -</Directory><br /> - </example> - - <p>This will direct all requests for ASP.NET-releated files to the - mod_aspdotnet handler, and serve Microsoft's ASP.NET client files - and support scripts as expected by ASP.NET applications.</p> - - <p>Provide individual <directive module="mod_aspdotnet" - >AspNet</directive> and <directive module="mod_aspdotnet" - >AspNetMount</directive> directives for each application (containing - a unique web.config file at it's application root.)</p> - - <example><title>Example:</title> -AspNetMount /app-uri "C:/path/to/app"<br /> -Alias /app-uri "C:/path/to/app"<br /> -<Directory "C:/path/to/app"><br /> - Options FollowSymlinks Indexes<br /> - AspNet files<br /> - Order allow,deny<br /> - Allow from all<br /> - DirectoryIndex default.htm default.aspx<br /> -</Directory><br /> - </example> - -</section> - -<directivesynopsis> -<name>AspNet</name> - -<description>Enables mod_aspdotnet to process ASP.NET content</description> -<syntax>AspNet [[<var>Files</var>] [<var>Directories</var>] - [<var>Virtual</var>] [<var>Errors</var>]] - | [<var>All</var>] | [<var>None</var>]</syntax> -<default>AspNet None</default> -<contextlist><context>server config</context><context>virtual host</context> -<context>directory</context><context>.htaccess</context> -</contextlist> -<override>Options</override> -<compatibility>Build 2004 and later</compatibility> - -<usage> - - <p>The <directive>AspNet</directive> directive determines what content - may be served by the ASP.NET host. This directive does -not- actually - expose the content or mount the URI to physical files, you must use the - <directive module="mod_alias">Alias</directive> and - <directive>AspNetMount</directive> directives to expose the content - to the remote user.</p> - - <p>The <directive>AspNet</directive> <var>files</var> directive is - the equivilant for ASP.NET files to the behavior of Options ExecCGI - for CGI content. In the original version of mod_aspdotnet, in fact, - Options ExecCGI was used to determine if ASP.NET content would be - invoked through mod_aspdotnet. In version 2.0.2 and later, this is - no longer true, and your configuration files must be updated from - Options ExecCGI to AspNet files.</p> - - <p>The None option disables all ASP.NET processing, while the individual - options below enable ASP.NET processing for specific request types:</p> - - <dl> - <dt><code>All</code></dt> - - <dd>All options below. This is generally not a recommended setting.</dd> - - <dt><code>Files</code></dt> - - <dd>Files that exist in the filesystem, which are directed to the - asp.net handler.</dd> - - <dt><code>Directories</code></dt> - - <dd>Directories that exist in the filesystem, which are directed to the - asp.net handler. This can be used to invoke an HttpHandler to produce - custom directory listings.</dd> - - <dt><code>Virtual</code></dt> - - <dd>Requests that map to neither a file nor directory in the filesystem, - which are directed to the asp.net handler. This is used to invoke any - HttpHandler which accesses non-file based resources, such as ASP.NET - remoting requests.</dd> - - <dt><code>Error</code></dt> - - <dd>Error result pages generated by ASP.NET. This option bypasses the - normal Apache ErrorDocument error content. This is required to return - the full debugging results from the ASP.NET environment in development - environments. Caution is urged before using this option in production - environments, where path-revealing flaws should be avoided.</dd> - - </dl> - - <p>Normally, if multiple <directive>AspNet</directive> directives could - apply to a directory, then the most specific one is used and others are - ignored; the AspNet directives are never merged. See <a - href="../sections.html#mergin">how sections are merged</a> for a better - understanding of which Files, Directory, or Location section will take - precedence.</p> - -</usage> -</directivesynopsis> - -<directivesynopsis> -<name>AspNetMount</name> - -<description>Mounts a URI to a physical ASP.NET directory</description> -<syntax>AspNetMount <var>URL-path</var> <var>directory-path</var></syntax> -<contextlist><context>server config</context> -</contextlist> - -<usage> - - <p>The <directive>AspNetMount</directive> directive determines which - physical directory is mounted by the ASP.NET host. This directive - does -not- actually expose the content, you must use the - <directive module="mod_alias">Alias</directive> - directive to expose the content to the remote user.</p> - -</usage> -</directivesynopsis> - -<directivesynopsis> -<name>AspNetVersion</name> - -<description>Force a specific .NET Framework version to be loaded</description> -<syntax>AspNetVersion <var>versionstring</var></syntax> -<contextlist><context>server config</context> -</contextlist> -<compatibility>Build 2004 and later</compatibility> - -<usage> - - <p>The <directive>AspNetVersion</directive> directive will override the - default (most current) .NET Framework environment, and elect a different - installed version of the .NET Framework. The chosen version must be - installed on the machine.</p> - - <p>If this directive is not present, the most current .NET Framework version - is used. This directive should be specified only once, only the last occurance - in the httpd.conf file is used to elect the .NET Framework version.</p> - - <p>See the c:\Windows\Microsoft.NET\Framework\ directory for all installed - versions and their version tags (the actual directory names).</p> - - <example><title>Example:</title> -# Load mod_aspdotnet using the 1.0 release version of the .NET Framework -AspNetVersion v1.0.3705<br /> - </example> - - <example><title>Example:</title> -# Load mod_aspdotnet using the 1.1 release version of the .NET Framework -AspNetVersion v1.1.4322<br /> - </example> - -</usage> -</directivesynopsis> -</modulesynopsis> Deleted: mod_aspdotnet/trunk/docs/mod_aspdotnet.xml.meta =================================================================== --- mod_aspdotnet/trunk/docs/mod_aspdotnet.xml.meta 2006-09-07 19:00:16 UTC (rev 166) +++ mod_aspdotnet/trunk/docs/mod_aspdotnet.xml.meta 2006-10-12 17:46:02 UTC (rev 167) @@ -1,11 +0,0 @@ -<?xml version="1.0" encoding="UTF-8" ?> - -<metafile> - <basename>mod_aspdotnet</basename> - <path>/mod/</path> - <relpath>..</relpath> - - <variants> - <variant>en</variant> - </variants> -</metafile> This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |