[rs-commit] r348 - in /rs-manual/trunk/src/site/xhtml5: configuration.xhtml5 index.xhtml5
rs-commit at redwax.eu
rs-commit at redwax.eu
Fri Mar 20 00:37:56 CET 2020
Author: minfrin at redwax.eu
Date: Fri Mar 20 00:37:55 2020
New Revision: 348
Log:
Add initial skeleton of the configuration guide.
Added:
rs-manual/trunk/src/site/xhtml5/configuration.xhtml5
Modified:
rs-manual/trunk/src/site/xhtml5/index.xhtml5
Added: rs-manual/trunk/src/site/xhtml5/configuration.xhtml5
==============================================================================
--- rs-manual/trunk/src/site/xhtml5/configuration.xhtml5 (added)
+++ rs-manual/trunk/src/site/xhtml5/configuration.xhtml5 Fri Mar 20 00:37:55 2020
@@ -0,0 +1,136 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE html>
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
+ <head>
+ <title>Configuration</title>
+ <meta name="description" content="Configuring the Redwax Server." />
+ <link rel="canonical" href="https://redwax.eu/rs/docs/latest/configuration.html" />
+ </head>
+ <body>
+
+ <section class="spotlight style2 orient-right content-align-left image-position-left" id="configuration">
+ <div class="content null">
+ <h2>Configuring the Redwax Server</h2>
+ <p>
+ Configuration of a Redwax Server is identical to the configuration of any Apache
+ HTTP Server, however the following will give you an approach to turn a generic
+ Apache HTTP Server into a Redwax Certificate Authority.
+ </p>
+ </div>
+ <div class="image">
+ <img src="images/candles-green.jpg" alt="" />
+ </div>
+ </section>
+
+ <section class="wrapper style1 align-center inner"
+ id="goals">
+ <header>
+ <h2>Installing Apache HTTP Server and Redwax Server</h2>
+ <p>
+ Start with an installation of the Apache HTTP Server on your platform, then add Redwax Server.
+ </p>
+ </header>
+ <div class="content index align-left">
+
+ <section>
+ <header>
+ <h3>Install Apache</h3>
+ </header>
+ <div class="content none">
+ <p>
+ Different platforms have different methods for installing the Apache HTTP
+ Server. Instructions for common platforms can be found below:
+ </p>
+ <ul>
+ <li><a href="https://access.redhat.com/documentation/en-us/jboss_enterprise_application_platform/6.3/html/administration_and_configuration_guide/install_the_apache_httpd_in_red_hat_enterprise_linux_with_jboss_eap_6_rpm">Install on Redhat Enterprise Linux</a>.</li>
+ <li><a href="https://help.ubuntu.com/lts/serverguide/httpd.html">Install on Ubuntu</a>.</li>
+ <li><a href="https://www.freebsd.org/doc/handbook/network-apache.html">Install on FreeBSD</a>.</li>
+ <li><a href="http://httpd.apache.org/docs/2.4/install.html">Original Apache HTTP installation guide</a>.</li>
+ </ul>
+ </div>
+ </section>
+
+ <section>
+ <header>
+ <h3>Install Redwax</h3>
+ </header>
+ <div class="content none">
+ <p>
+ Different platforms have different methods for installing extra packages like the Redwax Server.
+ Redwax packages from common platforms can be found below:
+ </p>
+ <ul>
+ <li><a href="https://copr.fedorainfracloud.org/coprs/redwax/rs/">Install on Redhat / Fedora / Mageia / OpenSUSE</a>.</li>
+ </ul>
+ </div>
+ </section>
+
+ </div>
+ </section>
+
+ <section class="wrapper style1 align-center inner"
+ id="goals">
+ <header>
+ <h2>Configure a Virtual Host</h2>
+ <p>
+ There is no "correct" way to lay out a server. In this guide we use the following virtual
+ host configuration from the <a href="https://interop.redwax.eu/rs/">Interop / Demo</a>
+ site, but others are possible.
+ </p>
+ </header>
+ <div class="content index align-left">
+
+ <section>
+ <header>
+ <h3>Virtual Host</h3>
+ </header>
+ <div class="content none">
+ <p>
+ As a baseline, ensure that you have a running Apache HTTP server able to respond
+ to web requests. One such way is to configure a virtual server as below. In this
+ virtual host we configure a digital certificate that matches the default name of
+ the machine. We include additional configuration if present from the
+ <code>/etc/httpd/conf.d/secure/machine/</code> directory.
+ </p>
+<pre><code><![CDATA[<IfModule !dir_module>
+ LoadModule dir_module modules/mod_dir.so
+</IfModule>
+
+#
+# VirtualHost example:
+# Almost any Apache directive may go into a VirtualHost container.
+# The first VirtualHost section is used for requests without a known
+# server name.
+#
+<VirtualHost *:443>
+
+ DocumentRoot /var/www/secure/machine/web-docs
+ ErrorLog /var/log/httpd/secure/machine-error_log
+ CustomLog /var/log/httpd/secure/machine-access_log ssl-combined
+
+ SSLEngine on
+ SSLStrictSNIVHostCheck on
+ SSLCertificateFile /etc/pki/httpd/machine-hostCert.pem
+ SSLCertificateKeyFile /etc/pki/httpd/machine-hostKey.pem
+ SSLCertificateChainFile /etc/pki/httpd/machine-hostChain.pem
+ SSLCACertificateFile /etc/pki/httpd/machine-caCert.pem
+
+ <Directory "/var/www/secure/machine/web-docs">
+ Options +Indexes +FollowSymLinks +Includes
+ AllowOverride None
+ Require all granted
+ </Directory>
+
+ IncludeOptional /etc/httpd/conf.d/secure/machine/*.conf
+
+</VirtualHost>]]></code></pre>
+ </div>
+ </section>
+
+
+ </div>
+ </section>
+
+ </body>
+</html>
+
Modified: rs-manual/trunk/src/site/xhtml5/index.xhtml5
==============================================================================
--- rs-manual/trunk/src/site/xhtml5/index.xhtml5 (original)
+++ rs-manual/trunk/src/site/xhtml5/index.xhtml5 Fri Mar 20 00:37:55 2020
@@ -29,6 +29,7 @@
<h2>Reference Manual</h2>
<ul class="alt">
<li><a href="installation.html">Compiling and Installing</a></li>
+ <li><a href="configuration.html">Configuring Apache HTTP and Redwax Server</a></li>
<li><a href="directives.html">Run-time Configuration Directives</a></li>
<li><a href="modules.html">Modules</a></li>
<li><a href="hooks.html">Hook Implementations</a></li>
More information about the rs-commit
mailing list