1 files changed, 71 insertions, 0 deletions
diff --git a/qpid/doc/book/src/Configure-the-Broker-via-config.xml.xml b/qpid/doc/book/src/Configure-the-Broker-via-config.xml.xml
new file mode 100644
index 0000000000..b91e0796b8
--- /dev/null
+++ b/qpid/doc/book/src/Configure-the-Broker-via-config.xml.xml
@@ -0,0 +1,71 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+<!--
+ 
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements.  See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership.  The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License.  You may obtain a copy of the License at
+ 
+   http://www.apache.org/licenses/LICENSE-2.0
+ 
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied.  See the License for the
+ specific language governing permissions and limitations
+ under the License.
+ 
+-->
+
+<section>
+  <title>
+      Configure the Broker via config.xml
+    </title>
+  <section role="h2" id="ConfiguretheBrokerviaconfig.xml-Brokerconfig.xmlOverview">
+    <title>
+            Broker config.xml Overview
+          </title>
+  <para>
+            The broker config.xml file which is shipped in the etc directory
+            of any Qpid binary distribution details various options and
+            configuration for the Java Qpid broker implementation.
+          </para>
+  <para>
+            In tandem with the virtualhosts.xml file, the config.xml file
+            allows you to control much of the deployment detail for your Qpid
+            broker in a flexible fashion.
+          </para>
+  <para>
+            Note that you can pass the config.xml you wish to use for your
+            broker instance to the broker using the -c command line option.
+            In turn, you can specify the paths for the broker password file
+            and virtualhosts.xml files in your config.xml for simplicity.
+          </para>
+  <para>
+            For more information about command line configuration options
+            please see <xref linkend="QpidDesign-Configuration-ConfigurationMethods"/>.
+          </para>
+    <!--h2-->
+  </section>
+
+  <section role="h2" id="ConfiguretheBrokerviaconfig.xml-QpidVersion">
+    <title>
+            Qpid
+            Version
+          </title>
+  <para>
+            The config format has changed between versions here you can find
+            the configuration details on a per version basis.
+          </para>
+  <para>
+            <xref linkend="qpid_M2-20--20config.xml"/>
+            <xref linkend="qpid_M2.1-20--20config.xml"/>
+          </para>
+    <!--h2-->
+  </section>
+
+</section>