keycloak-scim/topics/operating-mode/standalone-ha.adoc

47 lines
2.1 KiB
Text
Raw Normal View History

2016-04-30 04:39:32 +00:00
2016-04-22 20:02:59 +00:00
[[_standalone-ha-mode]]
=== Standalone Clustered Mode
2016-04-21 20:18:15 +00:00
Standalone clustered operation mode is for when you want to run {{book.project.name}} within a cluster. This mode
2016-04-29 16:09:09 +00:00
requires that you have a copy of the {{book.project.name}} distribution on each machine you want to run a server instance.
This mode can be very easy to deploy initially, but can become quite cumbersome. To make a configuration change
you'll have to modify each distribution on each machine. For a large cluster this can become time consuming and error prone.
2016-04-21 20:18:15 +00:00
==== Standalone Clustered Configuration
2016-04-22 20:02:59 +00:00
The distribution has a mostly pre-configured app server configuration file for running within a cluster. It has all the specific
2016-04-29 16:09:09 +00:00
infrastructure settings for networking, databases, caches, and discovery. This file resides
2016-04-22 20:02:59 +00:00
in _.../standalone/configuration/standalone-ha.xml_. There's a few things missing from this configuration.
You can't run {{book.project.name}} in a cluster without a configuring a shared database connection. You also need to
deploy some type of load balancer in front of the cluster. The <<fake/../../clustering.adoc#_clustering,clustering>> and
<<fake/../../database.adoc#_database,database>> sections of this guide walk you though these things.
2016-04-21 20:18:15 +00:00
.Standalone HA Config
image:../../{{book.images}}/standalone-ha-config-file.png[]
2016-04-29 16:09:09 +00:00
WARNING: Any changes you make to this file while the server is running will not take effect and may even be overwritten
2016-04-21 20:18:15 +00:00
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.
2016-04-29 16:09:09 +00:00
==== Standalone Clustered Boot Script
2016-04-21 20:18:15 +00:00
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
----