Show Table of Contents
4.4. Start JBoss EAP 6 with an Alternative Configuration
If you do not specify a configuration file, the server starts with the default file. However, when you start the server, you can specify a configuration manually. The process varies slightly, depending on whether you are using a Managed Domain or Standalone Server, and depending on which operating system you are using.
Prerequisites
- Before using an alternate configuration file, prepare it using the default configuration as a template. For a Managed Domain, the configuration file needs to be placed in the
EAP_HOME/domain/configuration/directory. For a Standalone Server, the configuration file should be placed in theEAP_HOME/standalone/configuration/directory.
Note
Several example configurations are included in the
EAP_HOME/docs/examples/configs/ directory. Use these examples to enable extra features such as clustering or the Transactions XTS API.
Procedure 4.3. Start the Instance with an Alternative Configuration
Standalone server
For a Standalone Server, provide the filename of the configuration file as an option to the--server-configparameter. The configuration file must be located in theEAP_HOME/standalone/configuration/directory, and you need to specify the file path relative to that directory.Example 4.1. Using an alternate configuration file for a Standalone Server in Red Hat Enterprise Linux
[user@host bin]$
./standalone.sh --server-config=standalone-alternate.xmlThis example uses theEAP_HOME/standalone/configuration/standalone-alternate.xmlconfiguration file.Example 4.2. Using an alternate configuration file for a Standalone Server in Microsoft Windows Server
C:\EAP_HOME\bin>
standalone.bat --server-config=standalone-alternate.xmlThis example uses theEAP_HOME\standalone\configuration\standalone-alternative.xmlconfiguration file.Managed Domain
For a Managed Domain, provide the file name of the configuration file as an option to the--domain-configparameter. The file must be present in theEAP_HOME/domain/configuration/directory, and you need to specify the path relative to that directory.Example 4.3. Using an alternate configuration file for a Managed Domain in Red Hat Enterprise Linux
[user@host bin]$
./domain.sh --domain-config=domain-alternate.xmlThis example uses theEAP_HOME/domain/configuration/domain-alternate.xmlconfiguration file.Example 4.4. Using an alternate configuration file for a Managed Domain in Microsoft Windows Server
C:\EAP_HOME\bin>
domain.bat --domain-config=domain-alternate.xmlThis example uses theEAP_HOME\domain\configuration\domain-alternate.xmlconfiguration file.
Result
JBoss Enterprise Application Platform is now running, using your alternate configuration file.
Where did the comment section go?
Red Hat's documentation publication system recently went through an upgrade to enable speedier, more mobile-friendly content. We decided to re-evaluate our commenting platform to ensure that it meets your expectations and serves as an optimal feedback mechanism. During this redesign, we invite your input on providing feedback on Red Hat documentation via the discussion platform.