more

SUMMARY.adoc

@@ -15,6 +15,7 @@
  .. link:topics/openshift.adoc[Installing on OpenShift]
  . link:topics/operating-mode.adoc[Choosing an Operating Mode]
  .. link:topics/operating-mode/standalone.adoc[Standalone Mode]
+ .. link:topics/operating-mode/standalone-ha.adoc[Standalone Clustered Mode]
  . link:topics/cache.adoc[Server Cache]
  . link:topics/clustering.adoc[Clustering]
  . link:topics/proxy.adoc[Keycloak Security Proxy]

topics/installation/system-requirements.adoc

@@ -10,4 +10,4 @@ These are the requirements to run the {{book.project.name}} authentication serve
 * At least 1G of diskspace
 
 {{book.project.name}} can be clustered without multicast, but this requires a bunch of configuration changes.  Please see
-the <<fake/../../clustering.adoc#_clustering>> section of this guide for more information.
+the <<fake/../../clustering.adoc#_clustering,clustering>> section of this guide for more information.

topics/operating-mode/standalone-ha.adoc

@@ -0,0 +1,52 @@
+=== Standalone Clustered
+
+Standalone clustered operation mode is for when you want to run {{book.project.name}} within a cluster.  This mode
+requires that you have a copy of each distribution for each node you want to run in the cluster.  While very easy to
+deploy initially, this mode can become cumbersome if you end up having a large cluster because you will have to
+modify the configuration in each node anytime you need to make a change.
+
+==== Standalone Clustered Configuration
+
+The distribution has a pre-configured app server configuration file for running within a cluster.  It has all the specific
+infrasture settings you need for the clustered caches and discovery that {{book.project.name}} needs.  This file resides
+in _.../standalone/configuration/standalone-ha.xml_
+
+.Standalone HA Config
+image:../../{{book.images}}/standalone-ha-config-file.png[]
+
+NOTE: Any changes you make to this file while the server is running will not take effect and may even be overwritten
+      by the server.  Instead use the the command line scripting or the web console of {{book.appserver.name}}.  See
+      the link:{{book.appserver.admindoc.link}}[{{book.appserver.admindoc.name}}] for more information.
+
+==== Standalone Boot Script
+
+You use the same boot scripts to start {{book.project.name}} as you do in standalone mode.  The difference is that
+you pass in an additional flag to point to the HA config file.
+
+.Standalone Clustered Boot Scripts
+image:../../{{book.images}}/standalone-boot-files.png[]
+
+To boot the server:
+
+.Linux/Unix
+[source]
+----
+$ .../bin/standalone.sh --server-config=standalone-ha.xml
+----
+
+.Windows
+[source]
+----
+> ...\bin\standalone.bat --server-config=standalone-ha.xml
+----
+
+==== Standalone Clustered{{book.project.name}} Configuration
+
+The {{book.project.name}} specific json configure file resides in the same place as in standalone mode: _.../standalone/configuration/keycloak.json_.
+Like _standalone-ha.xml_ you have to modify this file in each distribution in your cluster in order for changes to take effect.
+
+NOTE: Any changes you make to this file while the server is running will not take effect.  You'll need to reboot the
+      server.
+
+
+

topics/operating-mode/standalone.adoc

@@ -1,3 +1,4 @@
+[[_standalone-mode]]
 === Standalone Mode
 
 Standalone operating mode is only useful when you want to run one, and only one {{book.project.name}} server instance.  Standalone
@@ -12,12 +13,7 @@ When running the server in standalone mode, there is a specific script you need
 operating system.  These scripts live in the _bin/_ directory of the server distribution.
 
 .Standalone Boot Scripts
-{% if book.product %}
-image:../../rhsso-images/standalone-boot-files.png[]
-{% endif %}
-{% if book.community %}
-image:../../keycloak-images/standalone-boot-files.png[]
-{% endif %}
+image:../../{{book.images}}/standalone-boot-files.png[]
 
 To boot the server:
 
@@ -42,6 +38,11 @@ derivative of.  In the standalone operation mode, this file lives in _.../standa
 .Standalone Config File
 image:../../{{book.images}}/standalone-config-file.png[]
 
+NOTE: Any changes you make to this file while the server is running will not take effect and may even be overwritten
+      by the server.  Instead use the the command line scripting or the web console of {{book.appserver.name}}.  See
+      the link:{{book.appserver.admindoc.link}}[{{book.appserver.admindoc.name}}] for more information.
+
+
 ==== Standalone {{book.project.name}} Configuration
 
 {{book.project.name}} has a json configuration file that is specific to {{book.project.name}} this is located within
@@ -51,6 +52,9 @@ only applicable to {{book.project.name}}
 .Standalone {{book.project.name}} Config File
 image:../../{{book.images}}/standalone-json-config-file.png[]
 
+NOTE: Any changes you make to this file while the server is running will not take effect.  You'll need to reboot the
+      server.
+