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

45 lines
1.9 KiB
Text
Raw Normal View History

2016-04-30 04:39:32 +00:00
2016-04-21 20:18:15 +00:00
[[_standalone-mode]]
2016-04-21 16:36:12 +00:00
=== Standalone Mode
2016-04-22 20:02:59 +00:00
Standalone operating mode is only useful when you want to run one, and only one {{book.project.name}} server instance.
2016-04-29 16:09:09 +00:00
It is not usable for clustered deployments and all caches are non-distributed and local-only. It is not recommended that
2016-04-22 20:02:59 +00:00
you use standalone mode in production as you will have a single point of failure. If your standalone mode server goes down,
users will not be able to log in. This mode is really only useful to test drive and play with the features of {{book.project.name}}
2016-04-21 16:36:12 +00:00
==== Standalone Boot Script
When running the server in standalone mode, there is a specific script you need to run to boot the server depending on your
operating system. These scripts live in the _bin/_ directory of the server distribution.
.Standalone Boot Scripts
2016-04-21 20:18:15 +00:00
image:../../{{book.images}}/standalone-boot-files.png[]
2016-04-21 16:36:12 +00:00
To boot the server:
.Linux/Unix
[source]
----
$ .../bin/standalone.sh
----
.Windows
[source]
----
> ...\bin\standalone.bat
----
==== Standalone Configuration
The bulk of this guide walks you through how to configure infrastructure level aspects of {{book.project.name}}. These
aspects are configured in a configuration file that is specific to the application server that {{book.project.name}} is a
derivative of. In the standalone operation mode, this file lives in _.../standalone/configuration/standalone.xml_. This file
is also used to configure non-infrastructure level things that are specific to {{book.project.name}} components.
2016-04-21 16:36:12 +00:00
.Standalone Config File
2016-04-21 16:46:05 +00:00
image:../../{{book.images}}/standalone-config-file.png[]
2016-04-21 16:36:12 +00:00
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.