backport windows silent install options for PR50990

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.2.x@1200989 13f79535-47bb-0310-9956-ffa450edef68

diff --git a/docs/manual/platform/windows.html.en b/docs/manual/platform/windows.html.en
index 692d2631bc8c1ca7c265a4f2b5b9262884be2141..897096986cde9a9e730fe7432e8e1c55b70fd60d 100644 (file)
--- a/docs/manual/platform/windows.html.en
+++ b/docs/manual/platform/windows.html.en
@@ -38,6 +38,7 @@
 <div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#req">Operating System Requirements</a></li>
 <li><img alt="" src="../images/down.gif" /> <a href="#down">Downloading Apache for Windows</a></li>
 <li><img alt="" src="../images/down.gif" /> <a href="#inst">Installing Apache for Windows</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#advinst">Advanced Installation Topics</a></li>
 <li><img alt="" src="../images/down.gif" /> <a href="#cust">Customizing Apache for Windows</a></li>
 <li><img alt="" src="../images/down.gif" /> <a href="#winsvc">Running Apache as a Service</a></li>
 <li><img alt="" src="../images/down.gif" /> <a href="#wincons">Running Apache as a Console Application</a></li>
@@ -164,6 +165,63 @@
     should work as installed.</p>
   </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 <div class="section">
+<h2><a name="advinst" id="advinst">Advanced Installation Topics</a></h2>
+    
+
+    <p>One feature of the installer, "Build Headers and Libraries", can be
+    ignored by most users, but should be installed if compiling third party
+    modules.  The "APR Iconv Code Pages" can similarly be omitted by most
+    users, unless using <code class="module"><a href="../mod/mod_charset_lite.html">mod_charset_lite</a></code> or a third party
+    module which relies on APR internationalization features.</p>
+
+    <p>There are requests to ship a .zip file from time to time.  There is
+    no point in the ASF consuming additional storage, mirroring and bandwidth
+    for this purpose, because the .msi installer allows the installation
+    artifacts to all be unpacked using the <code>msiexec /a</code> network
+    installation option.  Using this command against any .msi will result
+    in an exploded tree of all of the individual files and components.</p>
+
+    <p>The installation options above can be customized by users familiar
+    with msiexec.exe options and silent installation.  The actual installer
+    sources are available in the httpd/httpd/win32-msi/ tree of the httpd
+    project subversion respository.  For reference, some of the more common
+    variables which may be modified are;</p>
+
+    <ul>
+      <li><code>AgreeToLicense</code> (toggle to "Yes")</li>
+      <li><code>ALLUSERS</code> (choose between Null and "1")</li>
+      <li><code>ApplicationUsers</code> (toggle to "OnlyCurrentUser")</li>
+      <li><code>EXISTING_APACHE_SERVICE_PATH</code></li>
+      <li><code>INSTALLDIR</code> (default "ProgramFilesFolder\Apache Software Foundation\Apache2.2\")</li>
+      <li><code>INSTALLLEVEL</code> (default "100", refer to list below)</li>
+      <li><code>RESOLVED_WINSOCK2</code> (toggle to "1")</li>
+      <li><code>SERVERADMIN</code></li>
+      <li><code>SERVERDOMAIN</code></li>
+      <li><code>SERVERNAME</code></li>
+      <li><code>SERVERPORT</code> (default "80")</li>
+      <li><code>SERVERSSLPORT</code> (default "443")</li>
+      <li><code>SERVICEINTERNALNAME</code> (default "Apache2.2", no spaces!)</li>
+      <li><code>SERVICENAME</code> (default "Apache2.2", include spaces)</li>
+      <li><code>SetupType</code> (default "Typical")</li>
+    </ul>
+
+    <p>The installation level of various features, which may be individually
+    toggled, include;</p>
+
+    <ul>
+      <li>Apache (1, base Apache HTTP Server 2.2 feature)</li>
+      <li>ApacheDocs (11, Apache Documentation)</li>
+      <li>ApacheMonitoring (41, Apache Service Taskbar Icon)</li>
+      <li>ApacheRuntime (1, Apache Runtime)</li>
+      <li>BuildFiles (101, Build Headers and Libraries)</li>
+      <li>Iconv (21, APR Iconv Code Pages)</li>
+      <li>OpensslBin (31, OpenSSL Runtime)</li>
+      <li>SslBin (41, Ssl Binaries)</li>
+    </ul>
+
+
+  </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
 <h2><a name="cust" id="cust">Customizing Apache for Windows</a></h2>
     
 

diff --git a/docs/manual/platform/windows.xml b/docs/manual/platform/windows.xml
index b02b3d9727a2db3baf2f855041d7fafcb5ab9723..f5313ee7d5692b1252adc3e7a5b7ef8f6bac5d94 100644 (file)
--- a/docs/manual/platform/windows.xml
+++ b/docs/manual/platform/windows.xml
@@ -158,6 +158,63 @@
     should work as installed.</p>
   </section>
 
+  <section id="advinst">
+    <title>Advanced Installation Topics</title>
+
+    <p>One feature of the installer, "Build Headers and Libraries", can be
+    ignored by most users, but should be installed if compiling third party
+    modules.  The "APR Iconv Code Pages" can similarly be omitted by most
+    users, unless using <module>mod_charset_lite</module> or a third party
+    module which relies on APR internationalization features.</p>
+
+    <p>There are requests to ship a .zip file from time to time.  There is
+    no point in the ASF consuming additional storage, mirroring and bandwidth
+    for this purpose, because the .msi installer allows the installation
+    artifacts to all be unpacked using the <code>msiexec /a</code> network
+    installation option.  Using this command against any .msi will result
+    in an exploded tree of all of the individual files and components.</p>
+
+    <p>The installation options above can be customized by users familiar
+    with msiexec.exe options and silent installation.  The actual installer
+    sources are available in the httpd/httpd/win32-msi/ tree of the httpd
+    project subversion respository.  For reference, some of the more common
+    variables which may be modified are;</p>
+
+    <ul>
+      <li><code>AgreeToLicense</code> (toggle to "Yes")</li>
+      <li><code>ALLUSERS</code> (choose between Null and "1")</li>
+      <li><code>ApplicationUsers</code> (toggle to "OnlyCurrentUser")</li>
+      <li><code>EXISTING_APACHE_SERVICE_PATH</code></li>
+      <li><code>INSTALLDIR</code> (default "ProgramFilesFolder\Apache Software Foundation\Apache2.2\")</li>
+      <li><code>INSTALLLEVEL</code> (default "100", refer to list below)</li>
+      <li><code>RESOLVED_WINSOCK2</code> (toggle to "1")</li>
+      <li><code>SERVERADMIN</code></li>
+      <li><code>SERVERDOMAIN</code></li>
+      <li><code>SERVERNAME</code></li>
+      <li><code>SERVERPORT</code> (default "80")</li>
+      <li><code>SERVERSSLPORT</code> (default "443")</li>
+      <li><code>SERVICEINTERNALNAME</code> (default "Apache2.2", no spaces!)</li>
+      <li><code>SERVICENAME</code> (default "Apache2.2", include spaces)</li>
+      <li><code>SetupType</code> (default "Typical")</li>
+    </ul>
+
+    <p>The installation level of various features, which may be individually
+    toggled, include;</p>
+
+    <ul>
+      <li>Apache (1, base Apache HTTP Server 2.2 feature)</li>
+      <li>ApacheDocs (11, Apache Documentation)</li>
+      <li>ApacheMonitoring (41, Apache Service Taskbar Icon)</li>
+      <li>ApacheRuntime (1, Apache Runtime)</li>
+      <li>BuildFiles (101, Build Headers and Libraries)</li>
+      <li>Iconv (21, APR Iconv Code Pages)</li>
+      <li>OpensslBin (31, OpenSSL Runtime)</li>
+      <li>SslBin (41, Ssl Binaries)</li>
+    </ul>
+
+
+  </section>
+
   <section id="cust">
     <title>Customizing Apache for Windows</title>