Docs for AS 7.1.1 and EAP 6.2 workaround

docbook/pom.xml

@@ -110,6 +110,10 @@
                             <name>project.version</name>
                             <value>${project.version}</value>
                         </injection>
+                        <injection>
+                            <name>picketlink.version</name>
+                            <value>${picketlink.version}</value>
+                        </injection>
                     </injections>
                     <options>
                         <xmlTransformerType>saxon</xmlTransformerType>

docbook/reference/en/en-US/modules/server-installation.xml

@@ -120,6 +120,9 @@ keycloak-war-dist-all-&project.version;/
             Password: <emphasis>admin</emphasis>. Keycloak will then prompt you to
             enter in a new password.
         </para>
+        <para>
+            If you have Keycloak on JBoss AS 7.1.1 or EAP 6.2 make sure to follow <link linkend="as7-specifics">these steps</link>.
+        </para>
     </section>
     <section>
         <title id="configure-server">Configuring the Server</title>
@@ -389,6 +392,45 @@ keycloak-war-dist-all-&project.version;/
             </para>
         </section>
 
+        <section id="as7-specifics">
+            <title>AS7/EAP6.x specifics</title>
+            <para>
+                If you have Keycloak on JBoss AS 7.1.1 or JBoss EAP 6.2, you need to do few other things in order to have Keycloak up and running. This includes:
+                <orderedlist>
+                    <listitem>
+                        <para>
+                            Remove or comment the element from file <literal>KEYCLOAK_HOME/standalone/deployments/auth-server.war/WEB-INF/jboss-deployment-structure.xml</literal>.
+<programlisting><![CDATA[
+<exclude-subsystems>
+    <subsystem name="webservices"/>
+</exclude-subsystems>
+]]></programlisting>
+                        </para>
+                    </listitem>
+                    <listitem>
+                        <para>
+                            Then either:
+                        </para>
+                        <para>
+                            <itemizedlist>
+                                <listitem>
+                                    <para>
+                                        Disable webservices extension and subsystem by remove (or comment) both in <literal>KEYCLOAK_HOME/standalone/configuration/standalone.xml</literal>.
+                                    </para>
+                                </listitem>
+                                <listitem>
+                                    <para>
+                                        If you want to use webservices subsystem, the alternative is to remove 2 JAR files
+                                        <literal>KEYCLOAK_HOME/standalone/deployments/auth-server.war/WEB-INF/lib/keycloak-saml-protocol-&project.version;.jar</literal>
+                                        and <literal>KEYCLOAK_HOME/standalone/deployments/auth-server.war/WEB-INF/lib/picketlink-federation-&picketlink.version;.jar</literal>
+                                        but note that <link linkend="saml">SAML</link> won't work.
+                                    </para>
+                                </listitem>
+                            </itemizedlist>
+                        </para>
+                    </listitem>
+                </orderedlist>
+            </para>
             <section>
                 <title>AS7/EAP6.x Logging</title>
                 <para>
@@ -411,6 +453,8 @@ keycloak-war-dist-all-&project.version;/
 ]]>
 </programlisting>
             </section>
+        </section>
+
         <section id="ssl_modes">
             <title>SSL/HTTPS Requirement/Modes</title>
             <warning>