WildFly Unzip Installation: Difference between revisions
Line 83: | Line 83: | ||
</blockquote> | </blockquote> | ||
===Host Controller=== | ===Subordinate Host Controller=== | ||
A subordinate host controller does not need to expose its management interface. However, it needs to know the domain controller(s) it'll connect to. This is done by setting the values of <tt>jboss.domain.master.address</tt> and <tt>jboss.domain.master.port</tt> in its <tt>$JBOSS_HOME/bin/domain.conf</tt>: | |||
<pre> | |||
</pre> | |||
For more details see [[WildFly System Properties#jboss.domain.master.address]] and [[WildFly System Properties#jboss.domain.master.port]]. | |||
===Domain Controller=== |
Revision as of 02:17, 12 February 2016
Internal
Overview
This document describes the WildFly "manual" installation procedure. It consists in unzipping a release zip file and configuring the deployment. It applies to both standalone and domain mode for WildFly and EAP releases. Additional configuration such as enabling SSL, adding data sources, adding HA to the domain controller, etc. can be performed after the installation. The examples below mention "jboss", as the procedure was applied to an EAP installation.
Extract Release from ZIP File
Extraction User
Unzip in place as the user intended to run the server. For example, if the application server will be run by an "eap" user, become that user and extract under that user's identity. If there are no sufficient permissions on the parent directory, temporarily lessen the permission during the unzip operation, then restore more restrictive permissions on the parent folder.
Unzip
unzip .../jboss-eap-6.4.0.zip
The operation will create a ./jboss-eap-6.4 directory.
Create a Symbolic Link
ln -s ./jboss-eap-6.4 jboss
Optional for a Standalone Installation
If you perform a standalone installation you can remove the domain subdirectory to reduce the clutter and confusion. You won't need it.
Optional on a Host Controller and/or Domain Controller
This applies when we install a host controller and when the host controller is also the domain controller: the standalone directory can be removed.
cd jboss rm -r standalone cd bin rm standalone *
Optional on a non-Windows Machine
The *.bat files from bin can be removed.
cd jboss/bin rm *.bat
Post-Install Configuration
Post-Install Configuration User
Perform all post-install configuration operations as the JBoss runtime user.
Unset the JBOSS_HOME Environment Variable
If the JBOSS_HOME value is accidentally set to point to another WildFly deployment, it will interfere with the next steps, so it is best if you unset it.
Security
Add a management user, conventionally named admin. Note that this user does not represent the identity used by a subordinate host controller to connect to the domain controller, that will be configured later. The procedure is described here:
Network
Configure the bind addresses for management and public interfaces. The bind address of the management interface can be set externally with jboss.bind.address.management system property. The bind address of the public interface can be set externally with jboss.bind.address system property.
Note that in domain mode, host controllers connect to the domain controller's management interface to get domain configuration, so the domain controller management functions have to be externally accessible over the management interface, hence the management interface has to be visible on the management (internal) network. A subordinate host controller does not have to expose its management interface. The public interface must be configured on all hosts and accessible externally, provided that the server instances must be available externally.
Standalone Node
Subordinate Host Controller
A subordinate host controller does not need to expose its management interface. However, it needs to know the domain controller(s) it'll connect to. This is done by setting the values of jboss.domain.master.address and jboss.domain.master.port in its $JBOSS_HOME/bin/domain.conf:
For more details see WildFly System Properties#jboss.domain.master.address and WildFly System Properties#jboss.domain.master.port.