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
|
2016-08-31 17:53:47 +00:00
|
|
|
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
|
2017-02-08 17:35:09 +00:00
|
|
|
the link:{{book.appserver.admindoc.link}}[_{{book.appserver.admindoc.name}}_] for more information.
|