Skip to content

Building WildFly

Jump to bottom
linuxonz edited this page Mar 28, 2024 · 46 revisions

Building WildFly

General Notes:

  • When following the steps below please use a standard permission user unless otherwise specified.
  • A directory /<source_root>/ will be referred to in these instructions, this is a temporary writable directory anywhere you'd like to place it.

WildFly binaries are available and can be downloaded from here. To use these binaries, different Java flavors can be installed on mentioned distributions.

Note: WildFly (v31.0.1.Final) was verified at the time of creation of these instructions

Step 1: Install Java

export SOURCE_ROOT=/<source_root>/

  • With IBM Semeru Runtime

    • Download and install IBM Semeru Runtime (Java 11 or 17 or 21) from here.

  • With Eclipse Adoptium Temurin Runtime

    • Download and install Eclipse Adoptium Temurin Runtime (Java 11 or 17 or 21) from here.

  • With OpenJDK 11

    • RHEL (7.8, 7.9, 8.6, 8.8, 8.9, 9.0, 9.2, 9.3) 
      sudo yum install -y java-11-openjdk
    • SLES (12 SP5, 15 SP5) 
      sudo zypper install -y java-11-openjdk
    • Ubuntu (20.04, 22.04, 23.10) 
      sudo apt-get install -y openjdk-11-jre

  • With OpenJDK 17

    • RHEL (8.6, 8.8, 8.9, 9.0, 9.2, 9.3) 
      sudo yum install -y java-17-openjdk
    • SLES (15 SP5) 
      sudo zypper install -y java-17-openjdk
    • Ubuntu (20.04, 22.04, 23.10) 
      sudo apt-get install -y openjdk-17-jre

  • With OpenJDK 21

    • RHEL (8.6, 8.8, 8.9, 9.0, 9.2, 9.3) 
      sudo yum install -y java-21-openjdk
    • Ubuntu (22.04, 23.10) 
      sudo apt-get install -y openjdk-21-jre

Note: Versions (v11.0.21, v17.0.9 and v21.0.1.0) of IBM Semeru Runtime and (v11.0.21 and v17.0.9) of Adoptium Temurin Runtime were used at the time of creation of these instructions

Step 2: Set environment variables

export JAVA_HOME=<path to Java installation directory>
export PATH=$JAVA_HOME/bin:$PATH

Step 3: Run the server

To start the server, extract binary tar to /<source_root>/ and follow steps given below

export SOURCE_ROOT=/<source_root>/
  • Standalone Mode
sh $SOURCE_ROOT/<wildfly-<version>_binary_folder>/bin/standalone.sh -b 0.0.0.0 -bmanagement 0.0.0.0
  • Domain Mode
sh $SOURCE_ROOT/<wildfly-<version>_binary_folder>/bin/domain.sh -b 0.0.0.0 -bmanagement 0.0.0.0

Note: If the server fails to start on with the error WFLYCTL0113: '' is an invalid value for parameter instance-id. Values must have a minimum length of 1 characters, make sure the hostname command is installed and the environment variable is set via export HOSTNAME=`hostname`

Open http://<ip_address>:8080/ in your browser to access Web UI.

References:

The information provided in this article is accurate at the time of writing, but on-going development in the open-source projects involved may make the information incorrect or obsolete. Please open issue or contact us on IBM Z Community if you have any questions or feedback.

Clone this wiki locally