pcs 98/05/30 05:57:48
Modified: . README.NT Log: This file duplicated too much of windows.html. Refer people to that file for the details. Revision Changes Path 1.11 +6 -150 apache-1.3/README.NT Index: README.NT =================================================================== RCS file: /export/home/cvs/apache-1.3/README.NT,v retrieving revision 1.10 retrieving revision 1.11 diff -u -r1.10 -r1.11 --- README.NT 1998/04/17 16:14:27 1.10 +++ README.NT 1998/05/30 12:57:48 1.11 @@ -28,157 +28,13 @@ webserver performance are asked to compare against Apache on a Unix platform such as Solaris, FreeBSD, or Linux. -Changes for the Windows version -------------------------------- +Installation or Compilation Instructions +---------------------------------------- -1. It is multithreaded - -2. It can run as a service (run apache -i to install the service) - or as a regular program (run apache -s to avoid waiting for - the program to hook up to the Service Manager). On Windows 95 - it runs as a regular program. - -3. There is only ever one child process for handling requests. - However for fault tolerance, if this process dies, another one - takes its place. Also after dealing with a certain number of - requests, each process voluntarily exits, to clean up any resources - it might have forgotten to free up. - -By default Apache uses the directory \Apache for the ServerRoot ON THE -DRIVE WHERE THE EXECUTABLE EXISTS. This can be changed with the -d -command line argument. - -There are a couple of new directives: - -ThreadsPerChild - Number of threads to use to handle requests -ExcessRequestsPerChild - Number of additional requests a server responds - to, after it decides to exit (this is not - currently used) - -Compilation ------------ - -If you have downloaded the source code you will need to compile -it. This requires Microsoft Visual C++ version 5.0 or higher. - -To compile Apache, run the command - - nmake -f Makefile.nt _apacher - -in the src directory. To install Apache to the \Apache directory, run - - nmake -f Makefile.nt installr - -To specify a different install directory, use - - nmake -f Makefile.nt installr INSTDIR=c:\mydir - -You can also build and install debug versions of Apache, with the -targets "_apached" and "installd". - -Make sure that before you run "nmake" that you've run VCVARS32.BAT -so that your environment is configured to run nmake from the command -line. - -To build Apache within MSVC, you will need to build the following -projects in this order. Make sure that you build the same -configuration (i.e. Debug or Release) for all of the various projects. - - regex/Makefile.dsp - ap/ap.dsp - os/win32/ApacheOS.dsp - src/ApacheCore.dsp - src/Apache.dsp - -Additional modules can also be built using project files in the os/win32 -directory. - -Installing a Binary Release ---------------------------- - -Since this file is installed as part of the install process, you have -probably already figured out how to install the binary. But for -reference, here are the instructions: - -Run the Apache distribution file. This will ask for a location to -install Apache into (the default is \Program Files\Apache -Group\Apache), for a start menu name (default is Apache Web Server) -and for a choice of installations. The Typical installation installs -everything except the source code. The Minimum installations does not -install the manuals either. Choose Custom install if you want to -install the source code. - -After installation is completed, there are three new items on the -start menu. On NT you should run the "Install Apache as Service" -program, then start Apache as a normal service. On Windows 95 or if -you do not want to run Apache as a service, click on the "Apache -Server" option. This will start Apache running in a console window, -where it will print its version number, then wait to start serving -requests. The third start menu option accessing the manual, if it was -installed. If it was not installed, you can access the Apache manual -at the URL http://www.apache.org/. - -Once Apache is running (either in a console window, or as a service), -if you have not edited the configuration files, it will be listening -on port 80, so you can connect to it at this URL: - - http://localhost/ - -To configure Apache, go into the directory where you installed it and -edit the "httpd.conf" file in the "conf" directory. - -Running Apache --------------- - -Apache can run as either a service (NT only) or a regular executable. - -To run as an executable, simply run apache.exe from the command -line. This will print the version number, then wait to serve -requests. If the server root is a directory other than \Apache, use -the -d option to give the correct server root, or store it in the -registry (see below). - -To stop Apache, press Control-C to stop it running. Note -that there may be a delay between typing the command line and Apache -being ready to accept requests as it checks the service manager. Use -the -s option to prevent this delay. - -When Apache starts it will look at the registry key - - HKEY_LOCAL_MACHINE\Software\Apache Group\Apache\1.3 beta\ServerRoot - -to find the server root, unless specified by the -d command line -flag. The correct server root is stored in this key by the binary -installation, or when Apache is run with the -i option. - -To install Apache as a service on NT and set the server root registry -key, run - - apache -i -d serverroot - -This will store the value of "serverroot" into the Apache ServerRoot -registry key, as above. Note that this can be used on both Windows NT -and Windows 95, however it will not install a service on 95. - -On NT you can now start the Apache service within the service manager -(Control Panel, Services), and set it to start automatically at boot -time if required. You can also stop Apache from the manager. - -To remove the Apache service, run - - apache -u - -Uninstalling Apache -------------------- - -If you installed a binary release, you can uninstall Apache using the -normal method of removing programs (Start menu, Control Panel, -Add/Remove Programs). You may have to remove the directory manually -because of the configuration files. - -If you installed a source release, you should delete the directory -where you installed Apache. You might also want to delete the registry -key, as given above. +See the file http://www.apache.org/docs/windows.html for details of +how to install Apache from a binary release or how to compile Apache +from scratch. (This file is also available as +htdocs/manual/windows.html in either a source or binary distribution). Known Problems --------------
