INSTALL.txt 4.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104
  1. APACHE INSTALLATION OVERVIEW
  2. Quick Start - Unix
  3. ------------------
  4. For complete installation documentation, see [ht]docs/manual/install.html or
  5. http://httpd.apache.org/docs/2.4/install.html
  6. $ ./configure --prefix=PREFIX
  7. $ make
  8. $ make install
  9. $ PREFIX/bin/apachectl start
  10. NOTES: * Replace PREFIX with the filesystem path under which
  11. Apache should be installed. A typical installation
  12. might use "/usr/local/apache2" for PREFIX (without the
  13. quotes).
  14. * Consider if you want to use a previously installed APR and
  15. APR-Util (such as those provided with many OSes) or if you
  16. need to use the APR and APR-Util from the apr.apache.org
  17. project. If the latter, download the latest versions and
  18. unpack them to ./srclib/apr and ./srclib/apr-util (no
  19. version numbers in the directory names) and use
  20. ./configure's --with-included-apr option. This is required
  21. if you don't have the compiler which the system APR was
  22. built with. It can also be advantageous if you are a
  23. developer who will be linking your code with Apache or using
  24. a debugger to step through server code, as it removes the
  25. possibility of version or compile-option mismatches with APR
  26. and APR-Util code. As a convenience, prepackaged source-code
  27. bundles of APR and APR-Util are occasionally also provided
  28. as a httpd-2.X.X-deps.tar.gz download.
  29. * If you are a developer building Apache directly from
  30. Subversion, you will need to run ./buildconf before running
  31. configure. This script bootstraps the build environment and
  32. requires Python as well as GNU autoconf and libtool. If you
  33. build Apache from a release tarball, you don't have to run
  34. buildconf.
  35. * If you want to build a threaded MPM (for instance worker)
  36. on FreeBSD, be aware that threads do not work well with
  37. Apache on FreeBSD versions before 5.4-RELEASE. If you wish
  38. to try a threaded Apache on an earlier version of FreeBSD,
  39. use the --enable-threads parameter to ./configure in
  40. addition to the --with-mpm parameter.
  41. * If you are building directly from Subversion on Mac OS X
  42. (Darwin), make sure to use GNU Libtool 1.4.2 or newer. All
  43. recent versions of the developer tools on this platform
  44. include a sufficiently recent version of GNU Libtool (named
  45. glibtool, but buildconf knows where to find it).
  46. For a short impression of what possibilities you have, here is a
  47. typical example which configures Apache for the installation tree
  48. /sw/pkg/apache with a particular compiler and flags plus the two
  49. additional modules mod_rewrite and mod_speling for later loading
  50. through the DSO mechanism:
  51. $ CC="pgcc" CFLAGS="-O2" \
  52. ./configure --prefix=/sw/pkg/apache \
  53. --enable-rewrite=shared \
  54. --enable-speling=shared
  55. The easiest way to find all of the configuration flags for Apache 2.4
  56. is to run ./configure --help.
  57. Quick Start - Windows
  58. ---------------------
  59. For complete documentation, see manual/platform/windows.html.en or
  60. http://httpd.apache.org/docs/2.4/platform/windows.html.
  61. The Apache/Win32 binaries are distributed as Windows Installer packages
  62. (.msi) named httpd-2.4.xx-win32-x86-no_ssl.msi for a version without mod_ssl
  63. and httpd-2.4.xx-win32-x86-openssl-1.0.1x.msi for a version including the
  64. mod_ssl plus the openssl library and command line utility. Additional 64 bit
  65. binaries have similarly named -win64-x64 package names. These packages
  66. may be unpacked without "installing" them by using the msiexec /a option.
  67. If you have unpacked a source distribution (named httpd-2.4.x-win32-src.zip,
  68. without any -x86 or -x64 notation) you must compile the package yourself,
  69. see the links mentioned above. Unless you intended to do this, please look
  70. again for an .msi package in http://www.apache.org/dist/httpd/binaries/win32/
  71. and install that desired .msi package.
  72. The .msi package configures the httpd.conf file, and installs and starts
  73. the Apache2.4 service for you. It also installs plenty of useful shortcuts
  74. and the taskbar ApacheMonitor. We strongly encourage you to use it.
  75. Postscript
  76. ----------
  77. To obtain help with installation problems, please see the resources at
  78. <http://httpd.apache.org/support.html>
  79. Thanks for using the Apache HTTP Server, version 2.4.
  80. The Apache Software Foundation
  81. http://www.apache.org/