Start WildFly as a System V Service on Linux: Difference between revisions

From NovaOrdis Knowledge Base
Jump to navigation Jump to search
No edit summary
Line 31: Line 31:
</pre>
</pre>


=Configure the Startup Script from <tt>init.d</tt>=
=Customize the WildFly Startup Wrapper=


Add at the top of the file:
<blockquote style="background-color: #f9f9f9; border: solid thin lightgrey;">
 
:[[Customize WildFly Startup Wrapper]]
<pre>
</blockquote>
JBOSS_HOME=/home/eap/EAP-6.4.0
JBOSS_USER=eap
#
# The amount of time to wait for startup
#
STARTUP_WAIT=30
#
# The amount of time to wait for shutdown
#
SHUTDOWN_WAIT=30
#
# Location to keep the console log
#
JBOSS_CONSOLE_LOG=${JBOSS_HOME}/domain/log/console.log
[ ! -d ${JBOSS_HOME}/domain/log ] && { mkdir -p ${JBOSS_HOME}/domain/log; chown ${JBOSS_USER} ${JBOSS_HOME}/domain/log; chmod a+rx ${JBOSS_HOME}/domain/log; }
</pre>
 
==Domain Controller High Availability Considerations==
 
If you're building a host controller that is expected to fail over among multiple HA domain controllers, increase the STARTUP_WAIT (see [[WildFly High Availability Domain Controller#The_Failover_Process|HA Domain Controller Failover Process]] for details).
 
==Backup Domain Controller Considerations==
 
If you're building a backup domain controller you will need to add this into <tt>jboss-host-controller</tt>}:
 
<pre>
JBOSS_BACKUP_DOMAIN_CONTROLLER=true
</pre>
 
and then add this to the start line:
 
<pre>
  ...
  local backup_option
  ${JBOSS_BACKUP_DOMAIN_CONTROLLER} && backup_option="--backup"
 
  if [ ! -z "$JBOSS_USER" ]; then
    if [ -r /etc/rc.d/init.d/functions ]; then
      daemon  [...] --host-config=$JBOSS_HOST_CONFIG ${backup_option} [...]
    else
      su [...] --host-config=$JBOSS_HOST_CONFIG ${backup_option}" [...]  
    fi
  fi
  ...
</pre>
 
===Optional===
 
If you deleted <tt>domain.xml</tt>, you will also need to set:
 
<pre>
JBOSS_DOMAIN_CONFIG=domain.cached-remote.xml
</pre>
 
but this is undocumented, so it's probably best NOT to remove <tt>domain.xml</tt> and leave <tt>JBOSS_DOMAIN_CONFIG</tt> definition in <tt>jboss-host-controller</tt> alone.
 
==Permissions==
 
Then adjust permissions:
 
<pre>
chmod a+rx ./jboss
chmod a+rx ./jboss-host-controller
</pre>


=Add the Startup Script As a Service=
=Add the Startup Script As a Service=

Revision as of 07:50, 16 February 2016

Internal

Overview

This procedure applies when the installation was done by unzipping or via the installer. This does not apply to an RPM installation.

The procedure is similar for standalone mode and domain mode. The only difference is the name of the original startup scripts (jboss-as-standalone.sh, jboss-as-domain.sh below).

Note that this procedure differs slightly from the manual procedure (https://access.redhat.com/documentation/en-US/JBoss_Enterprise_Application_Platform/6.4/html/Installation_Guide/sect-Service_Configuration.html#Install_JBoss_Enterprise_Application_Platform_6_Red_Hat_Enterprise_Linux_Service). This procedure is simpler, and does not require supplementary configuration files in /etc.

Locate the Pre-Packaged Startup Scripts

They are available in $JBOSS_HOME/bin/init.d as jboss-as-domain.sh and jboss-as-standalone.sh.

Install the Scripts into their Standard Locations

Perform the following operations as "root", name the scripts accordingly:

For a standalone installation, name the script jboss. 

cp $JBOSS_HOME/bin/init.d/jboss-as-standalone.sh  /etc/init.d/jboss

For a domain installation, name the script jboss-host-controller, regardless of whether we're configuring to start the domain controller or a subordinate host controller. This is because on the domain controller host, the domain controller process and the host controller process coincide. 

cp $JBOSS_HOME/bin/init.d/jboss-as-domain.sh  /etc/init.d/jboss-host-controller

Customize the WildFly Startup Wrapper

Customize WildFly Startup Wrapper

Add the Startup Script As a Service

chkconfig --add jboss|jboss-host-controller
chkconfig --list jboss|jboss-host-controller
chkconfig --level 2345 jboss|jboss-host-controller on

The Line that Starts The Process

...
su - $JBOSS_USER -c "LAUNCH_JBOSS_IN_BACKGROUND=1 JBOSS_PIDFILE=$JBOSS_PIDFILE $JBOSS_SCRIPT --domain-config=$JBOSS_DOMAIN_CONFIG --host-config=$JBOSS_HOST_CONFIG" 2>&1 > $JBOSS_CONSOLE_LOG &
...
Retrieved from "https://kb.novaordis.com/index.php?title=Start_WildFly_as_a_System_V_Service_on_Linux&oldid=3526"