components/web/apache24/Solaris/apache2.1m.sunman

   1 '\" te
   2 .\" Copyright (c) 2008, 2011, Oracle and/or its affiliates. All rights reserved.
   3 .TH apache24 1M "Mar 1, 2019" "SunOS 5.11" "System Administration Commands"
   4 .SH NAME
   5 apache24 \- Apache HTTP Server Version 2.4 overview
   6 .SH SYNOPSIS
   7 .LP
   8 .nf
   9 \fBapache24\fR
  10 .fi
  11
  12 .SH DESCRIPTION
  13 .sp
  14 .LP
  15 Apache HTTP Server Version 2 (Apache 2) consists of a main  server daemon,
  16 loadable server modules,  some additional  support utilities, configuration
  17 files, and documentation.
  18 .sp
  19 .LP
  20 Note Apache 2.4 is 64-bit only.
  21 .sp
  22 Apache 2.4 can be enabled by authorized user within the service
  23 management facility (SMF), using the following fault management
  24 resource identifier (FMRI):
  25 .sp
  26 .in +2
  27 .nf
  28 svc:/network/http:apache24
  29 .fi
  30 .in -2
  31 .sp
  32 Available SMF properties are listed in the following table:
  33 .sp
  34 .TS
  35 allbox;
  36 cw(2.750000i)| cw(2.750000i)
  37 lw(2.750000i)| lw(2.750000i).
  38 SMF Property Name       Value
  39 httpd/MPM       event (default), prefork or worker
  40 httpd/startup_options   valid apachectl options
  41 .TE
  42 .SH FILES
  43 .sp
  44 .LP
  45 The following files specify the installation locations for Apache 2:
  46 .LP
  47 Note :
  48 .RS +4
  49 .TP
  50 .ie t \(bu
  51 .el o
  52 The string \fB[version]\fR should be expanded
  53 to \fB"MAJOR.MINOR"\fR. For example, \fB/usr/apache2/2.4/*\fR.
  54 .RE
  55 .RS +4
  56 .TP
  57 .ie t \(bu
  58 .el o
  59 To find the current version of Apache 2 installed on your
  60 machine, type the following command:
  61 .sp
  62 .in +2
  63 .nf
  64 $ /usr/apache2/[version]/bin/apachectl -v
  65 .fi
  66 .in -2
  67 .sp
  68
  69 .RE
  70 .RE
  71 .sp
  72 .ne 2
  73 .mk
  74 .na
  75 \fB\fB/etc/apache2/[version]/\fR\fR
  76 .ad
  77 .sp .6
  78 .RS 4n
  79 Contains server configuration files. A newly-installed server
  80 contains a default \fBhttpd.conf\fR file. This is the main configuration file.
  81 .sp
  82 If there is need to use different main configuration file (e.g. to run
  83 multiple Apache 2 instances), it's possible by providing Apache '-f'
  84 option via SMF property httpd/startup_options.
  85 .RE
  86
  87 .sp
  88 .ne 2
  89 .mk
  90 .na
  91 \fB\fB/etc/apache2/[version]/conf.d/\fR\fR
  92 .ad
  93 .sp .6
  94 .RS 4n
  95 Contains additional server configuration files.
  96 .sp
  97 By default, server will load all the \fB\&.conf\fR files
  98 placed under this directory.
  99 .RE
 100
 101 .sp
 102 .ne 2
 103 .mk
 104 .na
 105 \fB\fB/etc/apache2/[version]/envvars\fR\fR
 106 .ad
 107 .sp .6
 108 .RS 4n
 109 File for specifying the environment settings which the server uses at
 110 startup. This is the user-editable version of the
 111 /usr/apache2/[version]/bin/envvars file.
 112 .sp
 113 Note that this is default path to envvars file only in case where main
 114 configuration file is in directory /etc/apache2/[version]/. If this
 115 is not the case Apache 2 will look for envvars file in the same
 116 directory where is main configuration file.
 117 .RE
 118
 119 .sp
 120 .ne 2
 121 .mk
 122 .na
 123 \fB\fB/etc/apache2/[version]/magic\fR\fR
 124 .ad
 125 .sp .6
 126 .RS 4n
 127 Magic data for \fBmod_mime_magic\fR Apache module as documented in the
 128 .nf
 129 \fB/usr/apache2/2.4/manual/mod/mod_mime_magic.html\fR file.
 130 .fi
 131 .nf
 132 Editing this file is not recommended.
 133 .fi
 134 .RE
 135
 136 .sp
 137 .ne 2
 138 .mk
 139 .na
 140 \fB\fB/etc/apache2/[version]/mime.types\fR\fR
 141 .ad
 142 .sp .6
 143 .RS 4n
 144 Default MIME types file. This file sets the default list of
 145 mappings from filename extensions to content types, changing this file is
 146 not recommended. Use the \fBAddType\fR directive instead.
 147 .RE
 148
 149 .sp
 150 .ne 2
 151 .mk
 152 .na
 153 \fB\fB/etc/apache2/[version]/original/\fR\fR
 154 .ad
 155 .sp .6
 156 .RS 4n
 157 Contents under this directory are delivered as-is from the
 158 apache distribution and these files are not meant to be read by the server.
 159 .RE
 160
 161 .sp
 162 .ne 2
 163 .mk
 164 .na
 165 \fB\fB/etc/apache2/[version]/sample-conf.d/\fR\fR
 166 .ad
 167 .sp .6
 168 .RS 4n
 169 Contains sample \fB\&.conf\fR files. These are
 170 not included in the main configuration file. To use the sample file, copy
 171 the file to \fBconf.d\fR directory and modify as per the need.
 172 .RE
 173
 174 .sp
 175 .ne 2
 176 .mk
 177 .na
 178 \fB\fB/usr/apache2/[version]/bin/\fR\fR
 179 .ad
 180 .sp .6
 181 .RS 4n
 182 Contains the main httpd executable as well as other utility programs.
 183 .RE
 184
 185 .sp
 186 .ne 2
 187 .mk
 188 .na
 189 \fB\fB/usr/apache2/[version]/bin/envvars\fR\fR
 190 .ad
 191 .sp .6
 192 .RS 4n
 193 Contains the default environment settings that the server uses at startup.
 194 .nf
 195 Editing this file is not recommended.
 196 .fi
 197 Instead, user should use /etc/apache2/[version]/envvars file.
 198 .RE
 199
 200 .sp
 201 .ne 2
 202 .mk
 203 .na
 204 \fB\fB/usr/apache2/[version]/manual/\fR\fR
 205 .ad
 206 .sp .6
 207 .RS 4n
 208 Contains the Apache 2 manual in HTML format.
 209 .RE
 210
 211 .sp
 212 .ne 2
 213 .mk
 214 .na
 215 \fB\fB/usr/apache2/[version]/include/\fR\fR
 216 .ad
 217 .sp .6
 218 .RS 4n
 219 Contains the Apache 2 header files, which are needed for building
 220 various optional server extensions with \fBapxs(8)\fR.
 221 .RE
 222
 223 .sp
 224 .ne 2
 225 .mk
 226 .na
 227 \fB\fB/usr/apache2/[version]/libexec/\fR\fR
 228 .ad
 229 .sp .6
 230 .RS 4n
 231 Contains loadable modules (DSOs) supplied with the server.
 232 .RE
 233
 234 .sp
 235 .ne 2
 236 .mk
 237 .na
 238 \fB\fB/usr/apache2/[version]/man/\fR\fR
 239 .ad
 240 .sp .6
 241 .RS 4n
 242 Contains man pages for the server, utility programs, and \fBmod_perl\fR.
 243 .sp
 244 Add this directory to your MANPATH to read the Apache 2 man pages. See
 245 Notes.
 246 .RE
 247
 248 .sp
 249 .ne 2
 250 .mk
 251 .na
 252 \fB\fB/var/apache2/[version]/cgi-bin/\fR\fR
 253 .ad
 254 .sp .6
 255 .RS 4n
 256 Default location for the CGI scripts.
 257 .sp
 258 This can be changed by altering the \fBhttpd.conf\fR file
 259 and restarting the server.
 260 .RE
 261
 262 .sp
 263 .ne 2
 264 .mk
 265 .na
 266 \fB\fB/var/apache2/[version]/htdocs/\fR\fR
 267 .ad
 268 .sp .6
 269 .RS 4n
 270 Default document root.
 271 .sp
 272 This can be changed by altering the \fBhttpd.conf\fR file
 273 and restarting the server.
 274 .RE
 275
 276 .sp
 277 .ne 2
 278 .mk
 279 .na
 280 \fB\fB/var/apache2/[version]/icons/\fR\fR
 281 .ad
 282 .sp .6
 283 .RS 4n
 284 Icons used by the server.
 285 .sp
 286 This should not be changed.
 287 .RE
 288
 289 .sp
 290 .ne 2
 291 .mk
 292 .na
 293 \fB\fB/var/apache2/[version]/libexec/\fR\fR
 294 .ad
 295 .sp .6
 296 .RS 4n
 297 Place holder for user Apache 2 modules.
 298 .sp
 299 Any modules which are added using \fBapxs(8)\fR are
 300 copied into this directory.
 301 .RE
 302
 303 .sp
 304 .ne 2
 305 .mk
 306 .na
 307 \fB\fB/var/apache2/[version]/logs/\fR\fR
 308 .ad
 309 .sp .6
 310 .RS 4n
 311 Contains server log files.
 312 .sp
 313 The formats, names, and locations of the files in this directory can
 314 be altered by various configuration directives in the \fBhttpd.conf\fR file.
 315 .RE
 316
 317 .sp
 318 .ne 2
 319 .mk
 320 .na
 321 \fB\fB/var/apache2/[version]/proxy/\fR\fR
 322 .ad
 323 .sp .6
 324 .RS 4n
 325 Directory used to cache pages if  the caching feature of \fBmod_proxy\fR is enabled in the \fBhttpd.conf\fR file.
 326 .sp
 327 The location of the cache can also be changed by changing the proxy
 328 configuration in the \fBhttpd.conf\fR file.
 329 .RE
 330
 331 .SH EXAMPLES
 332 .LP
 333 \fBExample 1 \fRTo switch to worker MPM type
 334 .sp
 335
 336 .in +2
 337 .nf
 338 # \fBsvccfg -s apache24 setprop httpd/MPM=worker\fR
 339 # \fBsvcadm refresh apache24\fR
 340 # \fBsvcadm restart apache24\fR
 341 .fi
 342 .in -2
 343 .sp
 344
 345 .LP
 346 \fBExample 2 \fRCreate new SMF apache instance
 347 .sp
 348 .LP
 349 This expects that valid configuration exists in
 350 /var/myapache/httpd.conf and it has altered all relevant directives
 351 against default apache instance (e.g. PidFile, Listen, DocumentRoot,
 352 ErrorLog and CustomLog).
 353 .sp
 354 .in +2
 355 .nf
 356 # \fBcp /lib/svc/manifest/network/http-apache24.xml my-apache24.xml\fR
 357 .sp
 358 Edit my-apache24.xml and rename instance name to my-apache24.
 359
 360 # \fBsvccfg import my-apache24.xml\fR
 361 # \fBsvccfg -s my-apache24 setprop httpd/startup_options=\\("-f" "/var/myapache/httpd.conf"\\)\fR
 362 # \fBsvcadm refresh my-apache24\fR
 363 .fi
 364 .in -2
 365 .sp
 366
 367 .SH SEE ALSO
 368 .sp
 369 .LP
 370 \fBattributes(5)\fR, \fBhttpd(8)\fR, apachectl(8)
 371 .sp
 372 .LP
 373 http://www.apache.org
 374 .SH NOTES
 375 .sp
 376 .LP
 377 In addition to the documentation and man pages included with Solaris,
 378 more information is available at http://www.apache.org\&.
 379 .sp
 380 .LP
 381 The Apache 2 man pages are provided with the programming modules. To
 382 view the manual pages for the Apache 2 modules with the man command, add \fB/usr/apache2/[version]/man\fR to the MANPATH environment variable.
 383 See \fBman(1)\fR for more information. Running \fBcatman(1M)\fR on
 384 the Apache 2 manual pages is not supported.