Return-Path: Mailing-List: contact apache-docs-help@apache.org; run by ezmlm Delivered-To: mailing list apache-docs@apache.org Received: (qmail 39844 invoked by uid 500); 27 Dec 2000 22:20:28 -0000 Delivered-To: apmail-httpd-docs-1.3-cvs@apache.org Received: (qmail 39836 invoked by uid 1215); 27 Dec 2000 22:20:28 -0000 Date: 27 Dec 2000 22:20:28 -0000 Message-ID: <20001227222028.39834.qmail@locus.apache.org> From: pepper@locus.apache.org To: httpd-docs-1.3-cvs@apache.org Subject: cvs commit: httpd-docs-1.3/htdocs/manual win_service.html pepper 00/12/27 14:20:28 Modified: htdocs/manual win_service.html Log: Fix various typos and entities. Make menu paths consistent. Fix a mismatched

. Revision Changes Path 1.5 +23 -23 httpd-docs-1.3/htdocs/manual/win_service.html Index: win_service.html =================================================================== RCS file: /home/cvs/httpd-docs-1.3/htdocs/manual/win_service.html,v retrieving revision 1.4 retrieving revision 1.5 diff -u -r1.4 -r1.5 --- win_service.html 2000/12/27 21:59:18 1.4 +++ win_service.html 2000/12/27 22:20:27 1.5 @@ -57,7 +57,7 @@ for more information on installing and controlling Apache services.

Apache, unlike many other Windows NT/2000 services, logs most - errors to it's own error.log file, in the logs folder within the + errors to its own error.log file, in the logs folder within the Apache server root folder. You will find few Apache error details in the Windows NT Event Log. Only errors as Apache attempts to start are captured in the Event Log.

@@ -92,7 +92,7 @@

You can pass any other arguments, such as -d to change the default - server root directory, -D, -C or -c to change the config file processing, + server root directory, -D, -C or -c to change config file processing, etc. Since these are stored in the registry and are difficult to modify, use this command to clear the options and replace them with a new list of options;

@@ -127,7 +127,7 @@

Effective with Apache release 1.3.15, the -k install option was added as an alias to -i, and the -k uninstall option was added as an alias - to -u. The original -i and -u options are depreciated in Apache 2.0. + to -u. The original -i and -u options are deprecated in Apache 2.0. These aliases were added to ease the transition for administrators running both versions.

@@ -174,7 +174,7 @@

When Apache is first installed as a service (e.g. with the -i option) it will run as user "System" (the LocalSystem account). There should be few issues if all resources for the web server reside on the local - system, but it has broad security privilages to affect the local machine!

+ system, but it has broad security privileges to affect the local machine!

LocalSystem is a very privileged account locally, so @@ -184,10 +184,10 @@ file system, named pipes, DCOM, or secure RPC.
-

NEVER grant network privilages to the SYSTEM account! - Create a new user account instead, grant the appropriate privilages to - that user, and use the the 'Log On As:' option. Select the Start Menu -> - Settings -> Control Panel -> Services -> apache service ... and click +

NEVER grant network privileges to the SYSTEM account! + Create a new user account instead, grant the appropriate privileges to + that user, and use the 'Log On As:' option. Select the Start Menu -> + Settings -> Control Panel -> Services -> apache service ... and click the "Startup" button to access this setting.

@@ -197,7 +197,7 @@ user name, and password) to be used for verification.
-

The SYSTEM account has no privilages to the network, so shared pages or +

The SYSTEM account has no privileges to the network, so shared pages or a shared installation of Apache is invisible to the service. If you intend to use any network resources, the following steps should help:

@@ -225,13 +225,13 @@

If you allow the account to log in as a user, then you can log in yourself - and test that the account has the privilages to execute the scripts, read + and test that the account has the privileges to execute the scripts, read the web pages, and that you can start Apache in a console window. If this works, and you have followed the steps above, Apache should execute as a service with no problems.

Note: error code 2186 is a good indication that you need to review the 'Log On As' configuration, since the server can't access a - required network resource.

+ required network resource.

Troubleshooting Apache for Windows as a Service

@@ -253,7 +253,7 @@

Check the Application Event Log with the Event Viewer in case of any problems, even if no error message pops up to warn you that an error - occured.

+ occurred.

Running Apache for Windows from the Command Line

@@ -286,19 +286,19 @@

Note that you may specify startup options on the apache -k start command line, including the -D, -C and -c options. These affect the processing of - the service configuration, and may be used with the <IfDefine> block + the service configuration, and may be used within an <IfDefine> block to conditionally process directives. You may also override the server root path or configuration file with the -d or -f options. The options should also be passed to the -k restart command, but they are ignored if the service is running, and only processed if the service is started.

The service also appears in the Service Control applet on Windows NT/2000. - For NT, this is found in the Settings -- Control Panel -- Services entry, - and on 2000 it is found in the Settings -- Control Panel -- Administrative - Tools -- Services entry. Here you can select the desired Apache service - to start or stop it. Pass additional options such as -D, -C, and -c, or + For NT, this is found in the Settings -> Control Panel -> Services entry, + and on 2000 it is found in the Settings -> Control Panel -> Administrative + Tools -> Services entry. Here you can select the desired Apache service + to start or stop it. Pass additional options such as -D, -C and -c, or override the default -d or -f options in the Start Parameters box before - clicking the Start button. These options behave the identically to the + clicking the Start button. These options behave identically to the apache -k start command.

In addition, you can use the native Windows NT/2000 command NET to @@ -311,7 +311,7 @@

Again, quotes are only required if the service name contains spaces. There is no way using the NET START command to pass additional options such as - -D, -c or -C using the NET START command. If options are requied, use one + -D, -c or -C using the NET START command. If options are required, use one of the other two methods instead.

HIGHLY EXPERIMENTAL Windows 95/98 Service

@@ -322,7 +322,7 @@

There is some support for Apache on Windows 95/98 to behave in a similar manner as a service on Windows NT/2000. It is highly experimental, - if it works (at all) the Apache Sofware Foundation will not attest to it's + if it works (at all) the Apache Sofwtare Foundation will not attest to it's reliability or future support. Proceed at your own risk!

Once you have confirmed that Apache runs correctly at the @@ -332,13 +332,13 @@

There are, however, significant differences that you should note:

Apache will attempt to start and if successful it will run in the - background. If you run the command + background. If you run the command

      Apache -n "service name" -k start
- via a shortcut on your desktop, for example, then if the service starts +

via a shortcut on your desktop, for example, then if the service starts successfully a console window will flash up but immediately disappears. If Apache detects any errors on startup such as a incorrect entries in the httpd.conf file, then the console window will remain visible. This may @@ -352,7 +352,7 @@ it from the start menu or desktop to perform the required action.

Apache and Windows 95/98 offer no support for running the Apache service - as a specific user with network privilages. In fact, Windows 95/98 offers + as a specific user with network privileges. In fact, Windows 95/98 offers no security on the local machine, either. This is the simple reason that the Apache Software Foundation never endorses the use of Windows 95/98 as a public httpd server. These facilities exist only to assist the user in