Commit 686e4b3d authored by Richard Bowen's avatar Richard Bowen
Browse files

Based on report from alex.extreme2@gmail.com (Alex Smith) poked around a 

bit, and there were a lot of incorrect paths in this document. Also, the
'apache.exe' file is now named 'httpd.exe' as god intended.
"C:\Program Files\Apache Group" becomes "C:\Program Files\Apache
Software Foundation" and the cooresponding change also made in the
registry paths.


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

docs/manual/platform/windows.html.en

+26 −25
Changes for docs/manual/platform/windows.html.en: 26 added lines, 25 removed lines.
Original line number Diff line number Diff line
@@ -149,8 +149,9 @@ 
      site(s).</p></li>



      <li><p><strong>Where to install.</strong> The default path is

      <code>C:\Program Files\Apache Group</code> under which a directory

      called <code>Apache2</code> will be created by default.</p></li>

      <code>C:\Program Files\Apache Software Foundation</code>

      under which a directory called 

      <code>Apache2.2</code> will be created by default.</p></li>

    </ol>



    <p>During the installation, Apache will configure the files in the
@@ -300,7 +301,7 @@ 
    the command prompt at the Apache <code>bin</code> subdirectory:</p>



    <div class="example"><p><code>

      apache -k install

      httpd -k install

    </code></p></div>



    <p>If you need to specify the name of the service you want to
@@ -309,14 +310,14 @@ 
    computer.</p>



    <div class="example"><p><code>

      apache -k install -n "MyServiceName"

      httpd -k install -n "MyServiceName"

    </code></p></div>



    <p>If you need to have specifically named configuration files for

    different services, you must use this:</p>



    <div class="example"><p><code>

      apache -k install -n "MyServiceName" -f "c:\files\my.conf"

      httpd -k install -n "MyServiceName" -f "c:\files\my.conf"

    </code></p></div>



    <p>If you use the first command without any special parameters except
@@ -327,13 +328,13 @@ 
    <p>Removing an Apache service is easy. Just use:</p>



    <div class="example"><p><code>

      apache -k uninstall

      httpd -k uninstall

    </code></p></div>



    <p>The specific Apache service to be uninstalled can be specified by using:</p>



    <div class="example"><p><code>

      apache -k uninstall -n "MyServiceName"

      httpd -k uninstall -n "MyServiceName"

    </code></p></div>



    <p>Normal starting, restarting and shutting down of an Apache
@@ -344,34 +345,34 @@ 
    service's configuration file by using:</p>



    <div class="example"><p><code>

      apache -n "MyServiceName" -t

      httpd -n "MyServiceName" -t

    </code></p></div>



    <p>You can control an Apache service by its command line switches,

    too. To start an installed Apache service you'll use this:</p>



    <div class="example"><p><code>

      apache -k start

      httpd -k start

    </code></p></div>



    <p>To stop an Apache service via the command line switches, use

    this:</p>



    <div class="example"><p><code>

      apache -k stop

      httpd -k stop

    </code></p></div>



    <p>or</p>



    <div class="example"><p><code>

      apache -k shutdown

      httpd -k shutdown

    </code></p></div>



    <p>You can also restart a running service and force it to reread

    its configuration file by using:</p>



    <div class="example"><p><code>

      apache -k restart

      httpd -k restart

    </code></p></div>



    <p>By default, all Apache services are registered to run as the
@@ -463,7 +464,7 @@ 
      in the background. If you run the command</p>



      <div class="example"><p><code>

        apache -n "MyServiceName" -k start

        httpd -n "MyServiceName" -k start

      </code></p></div>



      <p>via a shortcut on your desktop, for example, then if the
@@ -532,7 +533,7 @@ 
    window and entering:</p>



    <div class="example"><p><code>

      apache -k shutdown

      httpd -k shutdown

    </code></p></div>



    <p>This should be preferred over pressing Control-C because this
@@ -543,7 +544,7 @@ 
    complete without interruption. To restart Apache, use:</p>



    <div class="example"><p><code>

      apache -k restart

      httpd -k restart

    </code></p></div>



    <div class="note">Note for people familiar with the Unix version of Apache:
@@ -555,15 +556,15 @@ 
    <p>If the Apache console window closes immediately or unexpectedly

    after startup, open the Command Prompt from the Start Menu --&gt;

    Programs. Change to the folder to which you installed Apache, type

    the command <code>apache</code>, and read the error message. Then

    the command <code>httpd</code>, and read the error message. Then

    change to the logs folder, and review the <code>error.log</code>

    file for configuration mistakes. If you accepted the defaults when

    you installed Apache, the commands would be:</p>



    <div class="example"><p><code>

      c: <br />

      cd "\Program Files\Apache Group\Apache2\bin" <br />

      apache

      cd "\Program Files\Apache Software Foundation\Apache2.2\bin" <br />

      httpd 

    </code></p></div>



    <p>Then wait for Apache to stop, or press Control-C. Then enter the
@@ -583,20 +584,20 @@ 
      a particular configuration file:</p>



      <div class="example"><p><code>

        apache -f "c:\my server files\anotherconfig.conf"

        httpd -f "c:\my server files\anotherconfig.conf"

      </code></p></div>



      <p>or</p>



      <div class="example"><p><code>

        apache -f files\anotherconfig.conf

        httpd -f files\anotherconfig.conf

      </code></p></div></li>



      <li><p><code>-n</code> specifies the installed Apache service

      whose configuration file is to be used:</p>



      <div class="example"><p><code>

        apache -n "MyServiceName"

        httpd -n "MyServiceName"

      </code></p></div>

      </li>

    </ul>
@@ -613,7 +614,7 @@ 
    invoking Apache with the <code>-V</code> switch, like this:</p>



    <div class="example"><p><code>

      apache -V

      httpd -V

    </code></p></div>



    <p>Apache will then try to determine its <code class="directive"><a href="../mod/core.html#&#10;    serverroot">
@@ -632,7 +633,7 @@ 


      <li>The server root compiled into the server. This is <code>

      /apache</code> by default, you can verify it by using <code>

      apache -V</code> and looking for a value labelled as

      httpd -V</code> and looking for a value labelled as

      <code>HTTPD_ROOT</code>.</li>

    </ol>
@@ -645,7 +646,7 @@ 
    </p>



    <div class="example"><p><code>

      HKEY_LOCAL_MACHINE\SOFTWARE\Apache Group\Apache\2.0.43

      HKEY_LOCAL_MACHINE\SOFTWARE\Apache Software Foundation\Apache\2.2.2

    </code></p></div>



    <p>Correspondingly, if you chose to install Apache for the current
@@ -654,7 +655,7 @@ 
    logged on:</p>



    <div class="example"><p><code>

      HKEY_CURRENT_USER\SOFTWARE\Apache Group\Apache\2.0.43

      HKEY_CURRENT_USER\SOFTWARE\Apache Software Foundation\Apache\2.2.2

    </code></p></div>



    <p>This key is compiled into the server and can enable you to test

docs/manual/platform/windows.xml

+26 −25
Changes for docs/manual/platform/windows.xml: 26 added lines, 25 removed lines.
Original line number Diff line number Diff line
@@ -147,8 +147,9 @@ 
      site(s).</p></li>



      <li><p><strong>Where to install.</strong> The default path is

      <code>C:\Program Files\Apache Group</code> under which a directory

      called <code>Apache2</code> will be created by default.</p></li>

      <code>C:\Program Files\Apache Software Foundation</code>

      under which a directory called 

      <code>Apache2.2</code> will be created by default.</p></li>

    </ol>



    <p>During the installation, Apache will configure the files in the
@@ -298,7 +299,7 @@ 
    the command prompt at the Apache <code>bin</code> subdirectory:</p>



    <example>

      apache -k install

      httpd -k install

    </example>



    <p>If you need to specify the name of the service you want to
@@ -307,14 +308,14 @@ 
    computer.</p>



    <example>

      apache -k install -n "MyServiceName"

      httpd -k install -n "MyServiceName"

    </example>



    <p>If you need to have specifically named configuration files for

    different services, you must use this:</p>



    <example>

      apache -k install -n "MyServiceName" -f "c:\files\my.conf"

      httpd -k install -n "MyServiceName" -f "c:\files\my.conf"

    </example>



    <p>If you use the first command without any special parameters except
@@ -325,13 +326,13 @@ 
    <p>Removing an Apache service is easy. Just use:</p>



    <example>

      apache -k uninstall

      httpd -k uninstall

    </example>



    <p>The specific Apache service to be uninstalled can be specified by using:</p>



    <example>

      apache -k uninstall -n "MyServiceName"

      httpd -k uninstall -n "MyServiceName"

    </example>



    <p>Normal starting, restarting and shutting down of an Apache
@@ -342,34 +343,34 @@ 
    service's configuration file by using:</p>



    <example>

      apache -n "MyServiceName" -t

      httpd -n "MyServiceName" -t

    </example>



    <p>You can control an Apache service by its command line switches,

    too. To start an installed Apache service you'll use this:</p>



    <example>

      apache -k start

      httpd -k start

    </example>



    <p>To stop an Apache service via the command line switches, use

    this:</p>



    <example>

      apache -k stop

      httpd -k stop

    </example>



    <p>or</p>



    <example>

      apache -k shutdown

      httpd -k shutdown

    </example>



    <p>You can also restart a running service and force it to reread

    its configuration file by using:</p>



    <example>

      apache -k restart

      httpd -k restart

    </example>



    <p>By default, all Apache services are registered to run as the
@@ -461,7 +462,7 @@ 
      in the background. If you run the command</p>



      <example>

        apache -n "MyServiceName" -k start

        httpd -n "MyServiceName" -k start

      </example>



      <p>via a shortcut on your desktop, for example, then if the
@@ -530,7 +531,7 @@ 
    window and entering:</p>



    <example>

      apache -k shutdown

      httpd -k shutdown

    </example>



    <p>This should be preferred over pressing Control-C because this
@@ -541,7 +542,7 @@ 
    complete without interruption. To restart Apache, use:</p>



    <example>

      apache -k restart

      httpd -k restart

    </example>



    <note>Note for people familiar with the Unix version of Apache:
@@ -553,15 +554,15 @@ 
    <p>If the Apache console window closes immediately or unexpectedly

    after startup, open the Command Prompt from the Start Menu --&gt;

    Programs. Change to the folder to which you installed Apache, type

    the command <code>apache</code>, and read the error message. Then

    the command <code>httpd</code>, and read the error message. Then

    change to the logs folder, and review the <code>error.log</code>

    file for configuration mistakes. If you accepted the defaults when

    you installed Apache, the commands would be:</p>



    <example>

      c: <br />

      cd "\Program Files\Apache Group\Apache2\bin" <br />

      apache

      cd "\Program Files\Apache Software Foundation\Apache2.2\bin" <br />

      httpd 

    </example>



    <p>Then wait for Apache to stop, or press Control-C. Then enter the
@@ -581,20 +582,20 @@ 
      a particular configuration file:</p>



      <example>

        apache -f "c:\my server files\anotherconfig.conf"

        httpd -f "c:\my server files\anotherconfig.conf"

      </example>



      <p>or</p>



      <example>

        apache -f files\anotherconfig.conf

        httpd -f files\anotherconfig.conf

      </example></li>



      <li><p><code>-n</code> specifies the installed Apache service

      whose configuration file is to be used:</p>



      <example>

        apache -n "MyServiceName"

        httpd -n "MyServiceName"

      </example>

      </li>

    </ul>
@@ -611,7 +612,7 @@ 
    invoking Apache with the <code>-V</code> switch, like this:</p>



    <example>

      apache -V

      httpd -V

    </example>



    <p>Apache will then try to determine its <directive module="core">
@@ -630,7 +631,7 @@ 


      <li>The server root compiled into the server. This is <code>

      /apache</code> by default, you can verify it by using <code>

      apache -V</code> and looking for a value labelled as

      httpd -V</code> and looking for a value labelled as

      <code>HTTPD_ROOT</code>.</li>

    </ol>
@@ -643,7 +644,7 @@ 
    </p>



    <example>

      HKEY_LOCAL_MACHINE\SOFTWARE\Apache Group\Apache\2.0.43

      HKEY_LOCAL_MACHINE\SOFTWARE\Apache Software Foundation\Apache\2.2.2

    </example>



    <p>Correspondingly, if you chose to install Apache for the current
@@ -652,7 +653,7 @@ 
    logged on:</p>



    <example>

      HKEY_CURRENT_USER\SOFTWARE\Apache Group\Apache\2.0.43

      HKEY_CURRENT_USER\SOFTWARE\Apache Software Foundation\Apache\2.2.2

    </example>



    <p>This key is compiled into the server and can enable you to test