Naming /etc/httpd/conf.d/*.conf files in apache 2.4 on RHEL 7?
How do I decide what names to give configuration files that I need to create and place in /etc/httpd/conf.d? I need to change some of the default values of directives, and I understand that I need to put them in file(s) that end with .conf in that directory, but how do I decide on the part to the left of the .conf?
Example: /etc/httpd/conf/httpd.conf has this block:
<IfModule dir_module>
DirectoryIndex index.html
</IfModule>
while my 2.0/2.2 servers have the block:
DirectoryIndex index.html index.html.var index.jsp
I understand that I need to stick a file in /etc/httpd/conf.d/ and have the lines:
<IfModule dir_module>
DirectoryIndex index.html index.html.var index.jsp
</IfModule>
be in that file.
Ok, how do I decide what to name the file? Surely the apache gurus don't intend for the chaos of having every site have a different name for their little file -- DirectoryIndex.conf, directory_index.conf, dir_indx.conf, indexdir.conf, etc. And if like things ought to be grouped together (as in the conf.d/userdir.conf sample file) then how do we know what the canonical way is to structure all that?
Am I missing a piece of the install that documents/templates all that out?
Other details:
I have a new RHEL 7 server that was built for me by our systems group, and I have installed apache on it as specified in the manual
yum install httpd
That gets me the executables, and a skeleton of the configuration:
$ ls -Rl /etc/httpd
/etc/httpd:
total 0
drwxr-xr-x 2 root root 35 Dec 14 01:30 conf
drwxr-xr-x 2 root root 78 Dec 14 01:30 conf.d
drwxr-xr-x 2 root root 139 Dec 14 01:30 conf.modules.d
lrwxrwxrwx 1 root root 19 Dec 14 01:30 logs -> ../../var/log/httpd
lrwxrwxrwx 1 root root 29 Dec 14 01:30 modules -> ../../usr/lib64/httpd/modules
lrwxrwxrwx 1 root root 10 Dec 14 01:30 run -> /run/httpd
/etc/httpd/conf:
total 28
-rw-r--r-- 1 root root 11753 Aug 3 12:24 httpd.conf
-rw-r--r-- 1 root root 13077 Aug 3 12:33 magic
/etc/httpd/conf.d:
total 16
-rw-r--r-- 1 root root 2926 Aug 3 12:33 autoindex.conf
-rw-r--r-- 1 root root 366 Aug 3 12:34 README
-rw-r--r-- 1 root root 1252 Aug 3 12:24 userdir.conf
-rw-r--r-- 1 root root 516 Aug 3 12:24 welcome.conf
/etc/httpd/conf.modules.d:
total 28
-rw-r--r-- 1 root root 3739 Aug 3 12:24 00-base.conf
-rw-r--r-- 1 root root 139 Aug 3 12:24 00-dav.conf
-rw-r--r-- 1 root root 41 Aug 3 12:24 00-lua.conf
-rw-r--r-- 1 root root 742 Aug 3 12:24 00-mpm.conf
-rw-r--r-- 1 root root 957 Aug 3 12:24 00-proxy.conf
-rw-r--r-- 1 root root 88 Aug 3 12:24 00-systemd.conf
-rw-r--r-- 1 root root 451 Aug 3 12:24 01-cgi.conf
Notice that there are only 3 .conf files in conf.d. Ok, then later on in the manual there is reference to /usr/share/doc/httpd-VERSION, which looks like this:
$ ls -l /usr/share/doc/httpd-2.4.6/
total 244
-rw-r--r-- 1 root root 13507 Mar 29 2011 ABOUT_APACHE
-rw-r--r-- 1 root root 138742 Jul 15 2013 CHANGES
-rw-r--r-- 1 root root 1797 Aug 3 12:33 httpd-dav.conf
-rw-r--r-- 1 root root 2942 Aug 3 12:33 httpd-default.conf
-rw-r--r-- 1 root root 1119 Aug 3 12:33 httpd-info.conf
-rw-r--r-- 1 root root 5078 Aug 3 12:33 httpd-languages.conf
-rw-r--r-- 1 root root 1004 Aug 3 12:33 httpd-manual.conf
-rw-r--r-- 1 root root 4450 Aug 3 12:33 httpd-mpm.conf
-rw-r--r-- 1 root root 2216 Aug 3 12:33 httpd-multilang-errordoc.conf
-rw-r--r-- 1 root root 1511 Aug 3 12:33 httpd-vhosts.conf
-rw-r--r-- 1 root root 25852 Jul 23 2011 LICENSE
-rw-r--r-- 1 root root 550 Jan 5 2013 NOTICE
-rw-r--r-- 1 root root 3161 Aug 3 12:33 proxy-html.conf
-rw-r--r-- 1 root root 5158 Feb 20 2012 README
-rw-r--r-- 1 root root 8183 Feb 28 2007 VERSIONING