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_.
|
|
|
|
|
|
|
|
|
|
.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.
|
|
|
|
|
|
|
|
|
|
|
2016-04-24 00:29:41 +00:00
|
|
|
==== Standalone {{book.project.name}} JSON Configuration
|
2016-04-21 16:36:12 +00:00
|
|
|
|
2016-04-29 16:09:09 +00:00
|
|
|
{{book.project.name}} has a json configuration file that is specific to {{book.project.name}} components. This configuration is located within
|
2016-06-01 09:52:02 +00:00
|
|
|
the file.../standalone/configuration/keycloak-server.json. This file is used to configure non-infrastructure level things that are
|
2016-04-21 16:36:12 +00:00
|
|
|
only applicable to {{book.project.name}}
|
|
|
|
|
|
|
|
|
|
.Standalone {{book.project.name}} Config File
|
2016-04-21 16:48:50 +00:00
|
|
|
image:../../{{book.images}}/standalone-json-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. You'll need to reboot the
|
2016-04-21 20:18:15 +00:00
|
|
|
server.
|
|
|
|
|
|
2016-04-21 16:36:12 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
