keycloak-uncached

Removed details on using deployment overrides, this will need

1/28/2015 7:48:07 AM

Details

diff --git a/docbook/reference/en/en-US/modules/server-installation.xml b/docbook/reference/en/en-US/modules/server-installation.xml
index 3861a43..c2ec089 100755
--- a/docbook/reference/en/en-US/modules/server-installation.xml
+++ b/docbook/reference/en/en-US/modules/server-installation.xml
@@ -701,175 +701,4 @@ keycloak-war-dist-all-&project.version;/
         </section>
 
     </section>
-    <section>
-        <title>Configuring Servers from the Subsystem</title>
-        <para>
-            If you are using WildFly or EAP,he Keycloak server is deployed and configured from the Keycloak subsystem.  This makes provisioning simpler in a domain environment.
-            It also allows you to create more than one Keycloak server instance inside a single WildFly instance.  And, you can upload providers, themes, and
-            server configurations without disturbing Keycloak's auth-server.war.
-        </para>
-        <section>
-            <title>Manually Creating A Server</title>
-            <para>
-                A Keycloak server can be declared by editing standalone.xml or domain.xml.
-            </para>
-<para>
-<programlisting><![CDATA[
-<server xmlns="urn:jboss:domain:1.4">
-
-  <profile>
-    <subsystem xmlns="urn:jboss:domain:keycloak:1.0">
-        <auth-server name="keycloak-1">
-            <enabled>true</enabled>
-            <web-context>auth</web-context>
-        </auth-server>
-        <auth-server name="keyclaok-2">
-            <enabled>false</enabled>
-            <web-context>auth2</web-context>
-        </auth-server>
-    </subsystem>
-  </profile>
-]]>
-</programlisting>
-</para>
-            <warning>
-                <para>
-                    If you create more than one Keycloak server, you will need to use CLI to fully configure each instance.  At the least, 
-                    you will need to run the <link linkend="uploading-extra-config">update-server-config</link> operation.
-                </para>
-            </warning>
-        </section>
-        <section>
-            <title>Using CLI and CLI GUI with the Keycloak Subsystem</title>
-            <para>
-                Servers can also be added/removed or enabled/disabled at runtime using the <ulink url="https://developer.jboss.org/wiki/CommandLineInterface">CLI</ulink> or 
-                <ulink url="https://developer.jboss.org/wiki/AGUIForTheCommandLineInterface">CLI GUI</ulink> tool.  These are tools that ship with WildFly/EAP and also with
-                the Keycloak Appliance installation.  See <ulink url="https://developer.jboss.org/wiki/CommandLineInterface">CLI</ulink> or 
-                <ulink url="https://developer.jboss.org/wiki/AGUIForTheCommandLineInterface">CLI GUI</ulink> documentation to learn more about how to start the tools,
-                issue commands, and create CLI scripts.
-            </para>
-<para>
-To start CLI with the Keycloak Appliance install:
-<programlisting><![CDATA[
-cd <APPLIANCE_INSTALL_DIR>/keycloak/bin
-./jboss-cli.sh --gui
-or
-./jboss.cli.bat --gui]]>
-</programlisting>
-<note>Your server must be running to start in --gui mode.</note>
-</para>  
-            <section>
-                <title>Basic CLI Commands</title>
-<para>
-Command to add a server in CLI:
-<programlisting><![CDATA[
-/subsystem=keycloak/auth-server=my-auth-server/:add(web-context=my-auth, enabled=true)]]>
-</programlisting>
-Because "enabled=true", a new Keycloak server will be immediately deployed.  By default "enabled" is set to false.
-</para>  
-<para>
-Command to remove a server in CLI:
-<programlisting><![CDATA[
-/subsystem=keycloak/auth-server=my-auth-server/:remove]]>
-</programlisting>
-The Keycloak server will be immediately deleted and undeployed.
-</para>  
-<para>
-Command to enable or disable a server in CLI:
-<programlisting><![CDATA[
-/subsystem=keycloak/auth-server=foo/:write-attribute(name=enabled,value=true)]]>
-</programlisting>
-The Keycloak server will be immediately deployed or undeployed, but not deleted.
-</para>
-            </section>
-            <section id="uploading-extra-config">
-                <title>Uploading extra configuration using CLI</title>
-                <para>
-                    The Keycloak subsystem allows you to upload keycloak-server.json, provider jars, and theme jars to a Keycloak server instance.  The
-                    CLI operations for this are "update-server-config" and "add-provider".  You may use CLI, CLI GUI, or CLI scripts for these operations.  The following
-                    examples are shown using <ulink url="https://developer.jboss.org/wiki/AGUIForTheCommandLineInterface">CLI GUI</ulink> for clarity.
-                </para>
-                <para>
-                    To use a new keycloak-server.json file for your server, find your server under the Keycloak subsystem.  Then right-click the server,
-                    select "update-server-config", and upload your file.
-                </para>
-            
-                <para>
-                    <imagedata fileref="images/update-server-config-select.png"/>
-                </para>
-                <para>
-                    <imagedata fileref="images/update-server-config-dialog.png"/>
-                </para>
-            
-                <warning>
-                    <para>
-                    If you use the update-server-config operation, you should delete or rename &lt;WILDFLY_HOME&gt;/standalone/configuration/keycloak-server.json.
-                    Otherwise, all Keycloak server instances will use this file instead of your uploaded file.
-                    </para>
-                </warning>
-                <para>
-                    To upload a new provider jar or theme jar to your server, find your server under the Keycloak subsystem.  Then right-click the server,
-                    select "add-provider", and upload your file.
-                </para>
-                <para>
-                    <imagedata fileref="images/add-provider-select.png"/>
-                </para>
-                <para>
-                    <imagedata fileref="images/add-provider-dialog.png"/>
-                </para>
-            </section>
-            <section>
-                <title>Working with overlays</title>
-                <para>
-                    When you upload a provider jar, theme jar, or keycloak-server.json file, you are creating an overlay.  That is, the file is "overlayed"
-                    onto the Keycloak server at deploy time.  There are two additional operations that help you manage these overlays.  They are "list-overlays" and
-                    "remove-overlay".  Here are CLI examples of these operations.
-                </para>
-<para>
-    <programlisting>
-/subsystem=keycloak/auth-server=my-auth-server/:list-overlays
-{
-    "outcome" => "success",
-    "result" => [
-        "/WEB-INF/classes/META-INF/keycloak-server.json",
-        "/WEB-INF/lib/federation-properties-example.jar"
-    ],
-}</programlisting>
-    <programlisting>
-/subsystem=keycloak/auth-server=my-auth-server/:remove-overlay(overlay-file-path=/WEB-INF/lib/federation-properties-example.jar,redeploy=true)
-{
-    "outcome" => "success",
-}</programlisting>
-</para>
-                <para>
-                    <note>
-                        Notice in the "list-overlays" operation, the full path to the server config is 
-                        /WEB-INF/classes/META-INF/keycloak-server.json.  This is always the uploaded path for an "update-server-config" operation.
-                        If you remove this overlay, the Keycloak server will revert to its default keycloak-server.json.  If you have a 
-                        keycloak-server.json file in your &lt;WILDFLY_HOME&gt;/standalone/configuration directory, it will always take precedence
-                        over both the default and the overlay.
-                    </note>
-                </para>
-            </section>
-        </section>
-        <section>
-            <title>Adding a Keycloak server in Domain Mode</title>
-            <para>
-                In domain mode, you start the server with the "domain" command instead of the "standalone" command.  In this case, the Keycloak subsystem is
-                defined in domain/configuration/domain.xml instead of standalone/configuration.standalone.xml.  Inside domain.xml, you will see more than one
-                profile.  A Keycloak subsystem can be defined in zero or more of those profiles.
-            </para>
-            <para>
-                In the example below, a Keycloak server named "foo" is defined in the "full" profile.  The "full" profile is assigned to the "main-server-group".
-                Every WildFly instance that belongs to "main-server-group" will get an identically configured deployment of the "foo" Keycloak server.
-            </para>
-            <para>
-                All operations discussed earlier are valid for a Keycloak server in a domain.  You can enable/disable, upload new keyclaok-server.json, and add provider jars.
-                In the following example, any changes that are made to the "foo" server will be automatically propogated to every instance in "main-server-group".
-            </para>
-            <para>
-                <imagedata fileref="images/domain-mode.png"/>
-            </para>
-        </section>
-    </section>
 </chapter>