|
|
313.
|
|
|
The <emphasis>DocumentRoot</emphasis> directive specifies where Apache should look for the files that make up the site. The default value is /var/www. No site is configured there, but if you uncomment the <emphasis>RedirectMatch</emphasis> directive in <filename>/etc/apache2/apache2.conf</filename> requests will be redirected to /var/www/apache2-default where the default Apache2 site awaits. Change this value in your site's virtual host file, and remember to create that directory if necessary!
|
|
|
|
|
(no translation yet)
|
|
|
|
|
315.
|
|
|
Enable the new <emphasis>VirtualHost</emphasis> using the <application>a2ensite</application> utility and restart Apache:
|
|
|
|
|
(no translation yet)
|
|
|
|
|
324.
|
|
|
For example, when a user requests the page http://www.example.com/this_directory/, he or she will get either the DirectoryIndex page if it exists, a server-generated directory list if it does not and the Indexes option is specified, or a Permission Denied page if neither is true. The server will try to find one of the files listed in the DirectoryIndex directive and will return the first one it finds. If it does not find any of these files and if Options Indexes is set for that directory, the server will generate and return a list, in HTML format, of the subdirectories and files in the directory. The default value, found in <filename>/etc/apache2/apache2.conf</filename> is " index.html index.cgi index.pl index.php index.xhtml". Thus, if Apache2 finds a file in a requested directory matching any of these names, the first will be displayed.
|
|
|
|
|
(no translation yet)
|
|
|
|
|
325.
|
|
|
The <emphasis>ErrorDocument</emphasis> directive allows you to specify a file for Apache to use for specific error events. For example, if a user requests a resource that does not exist, a 404 error will occur, and per Apache2's default configuration, the file <filename>/usr/share/apache2/error/HTTP_NOT_FOUND.html.var </filename> will be displayed. That file is not in the server's DocumentRoot, but there is an Alias directive in <filename>/etc/apache2/apache2.conf</filename> that redirects requests to the /error directory to <filename>/usr/share/apache2/error/</filename>.
|
|
|
|
|
(no translation yet)
|
|
|
|
|
347.
|
|
|
Apache Modules
|
|
|
|
|
(no translation yet)
|
|
|
|
|
348.
|
|
|
Apache is a modular server. This implies that only the most basic functionality is included in the core server. Extended features are available through modules which can be loaded into Apache. By default, a base set of modules is included in the server at compile-time. If the server is compiled to use dynamically loaded modules, then modules can be compiled separately, and added at any time using the LoadModule directive. Otherwise, Apache must be recompiled to add or remove modules.
|
|
|
|
|
(no translation yet)
|
|
|
|
|
361.
|
|
|
There is a default HTTPS configuration file in <filename>/etc/apache2/sites-available/default-ssl</filename>. In order for <application>Apache</application> to provide HTTPS, a <emphasis>certificate</emphasis> and <emphasis>key</emphasis> file are also needed. The default HTTPS configuration will use a certificate and key generated by the <application>ssl-cert</application> package. They are good for testing, but the auto-generated certificate and key should be replaced by a certificate specific to the site or server. For information on generating a key and obtaining a certificate see <xref linkend="certificates-and-security"/>
|
|
|
|
|
(no translation yet)
|
|
|
|
|
362.
|
|
|
To configure <application>Apache</application> for HTTPS, enter the following:
|
|
|
|
|
(no translation yet)
|
|
|
|
|
365.
|
|
|
With Apache now configured for HTTPS, restart the service to enable the new settings:
|
|
|
|
|
(no translation yet)
|
|
|
|
|
366.
|
|
|
Depending on how you obtained your certificate you may need to enter a passphrase when <application>Apache</application> starts.
|
|
|
|
|
(no translation yet)
|
|
|
