How To Build the Apache of Your Dreams - Diversion: Layouts
(Page 5 of 8 )

Using --with-layout you can easily indicate where should Apache go after it's compiled. Locations for binaries, man pages, configuration files, and the like can be set using specific options to the configure script, or they can be defined all at once in a layout. Layouts are defined in the config.layout file, in the root of the Apache source. There are several layouts prefined, including Mac OS X server, BeOS, a typical GNU layout, and others. We'll use the layout named Apache as an example, since it's the default; if a layout is not specified, configure uses the Apache layout as a base, and any command l ine options overrride individual directives. (The comments on the right hand side of this table indicate the command line options that can be used for overrides.)

<Layout Apache>
prefix:        /usr/local/apache       # --prefix=DIR
exec_prefix:   $prefix                 # --exec-prefix=DIR
bindir:        $exec_prefix/bin        # --bindir=DIR
sbindir:       $exec_prefix/bin        # --sbindir=DIR
libexecdir:    $exec_prefix/libexec    # --libexecdir=DIR
mandir:        $prefix/man             # --mandir=DIR
sysconfdir:    $prefix/conf            # --sysconfdir=DIR
datadir:       $prefix                 # --datadir=DIR
iconsdir:      $datadir/icons          # --iconsdir=DIR
htdocsdir:     $datadir/htdocs         # --htdocsdir=DIR
cgidir:        $datadir/cgi-bin        # --cgidir=DIR
includedir:    $prefix/include         # --includedir=DIR
localstatedir: $prefix                 # --localstatedir=DIR
runtimedir:    $localstatedir/logs     # --runtimedir=DIR
logfiledir:    $localstatedir/logs     # --logfiledir=DIR
proxycachedir: $localstatedir/proxy    # --proxycachedir=DIR
</Layout>

These sections define where the various pieces of the final package will go. The whole thing will based in /usr/local/apache, with all binaries (httpd and the support programs) in /usr/local/apache/bin, man pages based in /usr/local/apache/man, configuration files in /usr/local/apache/conf, and so on. Changes to the layout can be made to one of the existing <Layout> sections, or a new one can be added by copying and pasting.

Here is the layout similar to the one that I generally use:

<Layout MyLayout>
prefix:        /usr/local/apache
exec_prefix:   $prefix
bindir:        $exec_prefix/bin
sbindir:       $exec_prefix/bin
libexecdir:    $exec_prefix/libexec
mandir:        /usr/local/man
sysconfdir:    /etc/apache
datadir:       $prefix
iconsdir:      $datadir/icons
htdocsdir:     $datadir/html
cgidir:        $datadir/cgi-bin
includedir:    /usr/include/apache
localstatedir: /var/apache
runtimedir:    $localstatedir/logs
logfiledir:    $localstatedir/logs
proxycachedir: $localstatedir/proxy
</Layout>

This is very similar to the Apache layout, except for a few things: man pages go into /usr/local/man, so they can be easily retrieved with a regular call to 'man httpd'; include files go into /usr/include/apache, so that they can be more easily used when I write to the Apache API, and configuration files go into /etc/apache. Logs, proxy stuff, and things like PID files go into /var/apache; I mount a separate partition as /var so my root filesystem doesn't fill up with logs, which makes it an ideal place for webserver logs.

Next: Building Apache, Really >>
 

More Administration Articles
More By Darren Chamberlain

Comments On: How To Build the Apache of Your Dreams

>>> Be the FIRST to comment on this article!