Go to main content

man pages section 8: System Administration Commands

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

apache24 (8)

Name

apache24 - Apache HTTP Server Version 2.4 overview

Synopsis

apache2

Description

System Administration Commands                                     apache24(8)



NAME
       apache2 - Apache HTTP Server Version 2.4 overview

SYNOPSIS
       apache2


DESCRIPTION
       Apache  HTTP  Server  Version 2.4 (Apache 2) consists of a main  server
       daemon, loadable server modules,  some additional   support  utilities,
       configuration files, and documentation.


       Note  Apache  2.4  is 64-bit only and Apache 2.2 modules are not binary
       compatible with 2.4.

       Several Apache 2 modules are bundled in  separate  packages  to  reduce
       number of dependencies of main package. These are:

         web/server/apache-24/apache-dbd
         web/server/apache-24/apache-ldap
         web/server/apache-24/apache-lua
         web/server/apache-24/apache-ssl
         web/server/apache-24/apache-ssl-fips-140

       Apache  2  can be enabled by authorized user within the service manage-
       ment facility (SMF), using  the  following  fault  management  resource
       identifier (FMRI):

         svc:/network/http:apache24

       Available SMF properties are listed in the following table:


       +-----------------------------+-----------------------------------+
       |     SMF Property Name       |              Value                |
       +-----------------------------+-----------------------------------+
       |httpd/MPM                    |event (default), prefork or worker |
       +-----------------------------+-----------------------------------+
       |httpd/startup_options        |valid apachectl options            |
       +-----------------------------+-----------------------------------+
FILES
       The following files specify the installation locations for Apache 2:

       Note :

           o      The  string  [version]  should be expanded to "MAJOR.MINOR".
                  For example, /usr/apache2/2.4/*.

           o      To find the current version of Apache 2  installed  on  your
                  machine, type the following command:

                    $ /usr/apache2/[version]/bin/apachectl -v



       /etc/apache2/[version]/

           Contains  server configuration files. A newly-installed server con-
           tains a default httpd.conf file. This  is  the  main  configuration
           file.

           If  there is need to use different main configuration file (e.g. to
           run multiple Apache 2 instances), it's possible by providing Apache
           '-f' option via SMF property httpd/startup_options.


       /etc/apache2/[version]/conf.d/

           Contains additional server configuration files.

           By  default, server will load all the .conf files placed under this
           directory.


       /etc/apache2/[version]/envvars

           File for specifying the environment settings which the server  uses
           at   startup.   This   is   the   user-editable   version   of  the
           /usr/apache2/[version]/bin/envvars file.

           Note that this is default path to envvars file only in  case  where
           main configuration file is in directory /etc/apache2/[version]/. If
           this is not the case Apache 2 will look for  envvars  file  in  the
           same directory where is main configuration file.


       /etc/apache2/[version]/magic

           Magic data for mod_mime_magic Apache module as documented in the
           /usr/apache2/2.2/manual/mod/mod_mime_magic.html file.
           Editing this file is not recommended.


       /etc/apache2/[version]/mime.types

           Default  MIME  types  file. This file sets the default list of map-
           pings from filename extensions to content types, changing this file
           is not recommended. Use the AddType directive instead.


       /etc/apache2/[version]/original/

           Contents  under  this directory are delivered as-is from the apache
           distribution and these files are  not  meant  to  be  read  by  the
           server.


       /etc/apache2/[version]/sample-conf.d/

           Contains  sample  .conf  files.  These are not included in the main
           configuration file. To use the sample file, copy the file to conf.d
           directory and modify as per the need.


       /usr/apache2/[version]/bin/

           Contains  the  main  httpd executable as well as other utility pro-
           grams.


       /usr/apache2/[version]/bin/envvars

           Contains the default environment settings that the server  uses  at
           startup.
           Editing this file is not recommended.
           Instead, user should use /etc/apache2/[version]/envvars file.


       /usr/apache2/[version]/manual/

           Contains the Apache 2 manual in HTML format.


       /usr/apache2/[version]/include/

           Contains  the  Apache 2 header files, which are needed for building
           various optional server extensions with apxs(1).


       /usr/apache2/[version]/libexec/

           Contains loadable modules (DSOs) supplied with the server.


       /usr/apache2/[version]/man/

           Contains man pages for the server, utility programs, and mod_perl.

           Add this directory to your MANPATH to read the Apache 2 man  pages.
           See Notes.


       /var/apache2/[version]/cgi-bin/

           Default location for the CGI scripts.

           This  can be changed by altering the httpd.conf file and restarting
           the server.


       /var/apache2/[version]/htdocs/

           Default document root.

           This can be changed by altering the httpd.conf file and  restarting
           the server.


       /var/apache2/[version]/icons/

           Icons used by the server.

           This should not be changed.


       /var/apache2/[version]/libexec/

           Place holder for user Apache 2 modules.

           Any  modules  which  are  added  using apxs(1) are copied into this
           directory.




       /var/apache2/[version]/logs/

           Contains server log files.

           The formats, names, and locations of the files  in  this  directory
           can   be   altered  by  various  configuration  directives  in  the
           httpd.conf file.


       /var/apache2/[version]/proxy/

           Directory used to cache pages if  the caching feature of  mod_proxy
           is enabled in the httpd.conf file.

           The location of the cache can also be changed by changing the proxy
           configuration in the httpd.conf file.


       /usr/bin/

           Contains pkg(7) version based mediated symbolic links to the  vari-
           ous Apache 2 utility programs.



EXAMPLES
       Example 1 To switch to worker MPM type


         # svccfg -s apache24 setprop httpd/MPM=worker
         # svcadm refresh apache24
         # svcadm restart apache24



       Example 2 Create new SMF apache instance


       This   expects   that   valid   configuration   exists   in   /var/mya-
       pache/httpd.conf and it has altered  all  relevant  directives  against
       default  apache  instance (e.g. PidFile, Listen, DocumentRoot, ErrorLog
       and CustomLog).

         # cp /lib/svc/manifest/network/http-apache24.xml my-apache24.xml

         Edit my-apache24.xml and rename instance name to my-apache24.

         # svccfg import my-apache24.xml
         # svccfg -s my-apache24 setprop httpd/startup_options=\("-f" "/var/myapache/httpd.conf"\)
         # svcadm refresh my-apache24




ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+----------------------+
       |ATTRIBUTE TYPE |   ATTRIBUTE VALUE    |
       +---------------+----------------------+
       |Availability   | web/server/apache-24 |
       +---------------+----------------------+
       |Stability      | Uncommitted          |
       +---------------+----------------------+

SEE ALSO
       attributes(7), httpd(8), apachectl(8)


       http://httpd.apache.org/docs/

NOTES
       In addition to the documentation and man pages included  with  Solaris,
       more information is available at http://httpd.apache.org/.


       The  Apache  2  man pages are provided with the programming modules. To
       view the manual pages for the Apache 2 modules with  the  man  command,
       add  /usr/apache2/[version]/man  to  the  MANPATH environment variable.
       See man(1) for more information. Running catman(8) on the Apache 2 man-
       ual pages is not supported.


       Source  code  for open source software components in Oracle Solaris can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This     software     was    built    from    source    available    at
       https://github.com/oracle/solaris-userland.   The  original   community
       source         was         downloaded         from          https://ar-
       chive.apache.org/dist/httpd/httpd-2.4.54.tar.gz.

       Further information about this software can be found on the open source
       community website at https://httpd.apache.org/.



Solaris 11.4                      8 Dec 2016                       apache24(8)