From 8b70148897b92f9ece299419dd3bce931ac68cce Mon Sep 17 00:00:00 2001 From: Nadya2502 Date: Thu, 11 Jun 2026 17:50:13 +0200 Subject: [PATCH 1/3] ELSDOC-295, added wildfly page --- docs/.vuepress/components/ELSApplication.vue | 6 + docs/.vuepress/config-client/sidebar.ts | 4 + docs/.vuepress/public/images/Wildfly.webp | Bin 0 -> 814 bytes docs/els-for-applications/wildfly/README.md | 170 +++++++++++++++++++ 4 files changed, 180 insertions(+) create mode 100644 docs/.vuepress/public/images/Wildfly.webp create mode 100644 docs/els-for-applications/wildfly/README.md diff --git a/docs/.vuepress/components/ELSApplication.vue b/docs/.vuepress/components/ELSApplication.vue index 41a3020a3..8064ada2a 100644 --- a/docs/.vuepress/components/ELSApplication.vue +++ b/docs/.vuepress/components/ELSApplication.vue @@ -92,6 +92,12 @@ const applications = [ link: "./mysql-and-percona-server/", icon: "/images/mysql.webp", }, + { + name: "Wildfly", + versions: "19.0.1.Final", + link: "./wildfly/", + icon: "/images/Wildfly.webp", + }, ]; diff --git a/docs/.vuepress/config-client/sidebar.ts b/docs/.vuepress/config-client/sidebar.ts index c8a26f64f..90f2193b2 100644 --- a/docs/.vuepress/config-client/sidebar.ts +++ b/docs/.vuepress/config-client/sidebar.ts @@ -587,6 +587,10 @@ export default { title: 'MySQL and Percona Server', icon: '/images/mysql.webp', }, + { + path: '/els-for-applications/wildfly/', + icon: '/images/Wildfly.webp', + }, "/els-for-applications/managing-els-repository/", ] }, diff --git a/docs/.vuepress/public/images/Wildfly.webp b/docs/.vuepress/public/images/Wildfly.webp new file mode 100644 index 0000000000000000000000000000000000000000..6dc1b416218a0c38d2f48c2a6d04db44cb2c8464 GIT binary patch literal 814 zcmWIYbaPWgTLb3hT<1uC z&b^^8queE9BP_F@U64(EThg%jpD$1B1&jBc%XwGv2(M@CF+cJpg(t*2MxI|}I?H>W z+U6#W$a`Np3>y@;Nv-%P;-L6=(zCe_f*cGkMlw$3o&H#);ak&orZrD`7s}X6GZ+Ui z(&;kNIl1r6`9H1ew zNT*qT`*Og1@@mOX2}>I0NI%;DB0j8nfKk4o!if1Oan^;7Im?rrPu{$J0e1z-5K zzkc5TUlH{Op9^lg-TpCz!y&TuZTX|M{{lB|3oF=Z-)mVDx-8#mksapU4fYN2N_y1Wvd*@8A7*${_ z#mEY#!+?BgC_4_w)_|&E0 + +TuxCare's Endless Lifecycle Support (ELS) for Wildfly provides security patches and selected bug fixes that are integral to the stable operation of applications running on these versions of Wildfly. These components have either reached their end of standard support from vendors or have reached End of Life (EOL). +Our ELS for Wildfly service is designed to provide solutions for organizations that are not yet ready to migrate to newer versions and that are seeking long-term stability for their legacy Wildfly applications. + +## Supported Versions + +* Wildfly 19.0.1.Final + +## Installation + + + +* Nexus repository access credentials (username and password) — contact [sales@tuxcare.com](mailto:sales@tuxcare.com) +* To browse available artifacts, visit TuxCare [Nexus](https://nexus.repo.tuxcare.com/#browse/browse:els_java) and click **Sign in** in the top right corner. You may need to refresh the page after logging in. + + + + + +1. **Navigate to the build tool directory** + * Windows + ```text + Maven: C:\Users\{username}\.m2 + Gradle: C:\Users\{username}\.gradle + ``` + * macOS + ```text + Maven: /Users/{username}/.m2 + Gradle: /Users/{username}/.gradle + ``` + * Linux + ```text + Maven: /home/{username}/.m2 + Gradle: /home/{username}/.gradle + ``` + +2. **Configure credentials** + + :::tip + For Maven, you may choose any valid `` value instead of `tuxcare-registry`, but the same value must be used in both `settings.xml` and `pom.xml`. + ::: + + + + Replace `USERNAME` and `PASSWORD` with your TuxCare credentials (see [Prerequisites](#prerequisites) above). + +3. **Add the TuxCare repository** + + Add the TuxCare Wildfly repository and plugins to your build configuration. + + + + * To fully switch from the official Wildfly repository, replace it with the TuxCare repository. + * To keep both, add TuxCare after the official one. + + Example Maven and Gradle projects are available on GitHub. Remember to set the required environment variables. + * [Maven](https://github.com/cloudlinux/securechain-java/tree/main/examples/maven) + * [Gradle](https://github.com/cloudlinux/securechain-java/tree/main/examples/gradle) + +4. **Update dependencies** + + Replace Wildfly dependencies with TuxCare-maintained versions. You can find artifact versions on [Nexus](https://nexus.repo.tuxcare.com/#browse/browse:els_java) — sign in with your TuxCare credentials. + + + +5. **Verify the setup** + + Use your build tool to list the project's dependencies and confirm TuxCare packages are resolved correctly. + + + +6. **Build the project** + + Include any library from the repository and run a build. + + + + The build tool you're using should be able to identify and resolve dependencies from the TuxCare ELS for Wildfly repository. + + + +## What's Next? + + + +* ![](/images/eye.webp) [CVE Tracker](https://tuxcare.com/cve-tracker/?product=Wildfly) — Track vulnerability fixes and updates +* ![](/images/shield.webp) [Available fixes](https://tuxcare.com/cve-tracker/fixes?product=Wildfly) — Patched versions and changelogs +* ![](/images/clipboard-notes.webp) [Supported components](https://tuxcare.com/cve-tracker/products?product=Wildfly) — Full list of product parts covered by ELS +* ![](/images/shield-alert.webp) [VEX feed](https://security.tuxcare.com/vex/cyclonedx/els_lang_java/org.wildfly.core/) — Vulnerability Exploitability eXchange feed +* ![](/images/wrench.webp) [Managing the ELS repository](/els-for-applications/managing-els-repository/) — Update to newer versions + + + + + + From 260ecfb7b3f222355e27580a3e090b6df2f36726 Mon Sep 17 00:00:00 2001 From: Nadya2502 Date: Mon, 22 Jun 2026 15:20:56 +0200 Subject: [PATCH 2/3] ELSDOC-295, updated wildfly instruction --- docs/.vuepress/components/ELSApplication.vue | 2 +- docs/els-for-applications/wildfly/README.md | 225 ++++++++++--------- 2 files changed, 120 insertions(+), 107 deletions(-) diff --git a/docs/.vuepress/components/ELSApplication.vue b/docs/.vuepress/components/ELSApplication.vue index 8064ada2a..6eadcc851 100644 --- a/docs/.vuepress/components/ELSApplication.vue +++ b/docs/.vuepress/components/ELSApplication.vue @@ -94,7 +94,7 @@ const applications = [ }, { name: "Wildfly", - versions: "19.0.1.Final", + versions: "27.0.1.Final", link: "./wildfly/", icon: "/images/Wildfly.webp", }, diff --git a/docs/els-for-applications/wildfly/README.md b/docs/els-for-applications/wildfly/README.md index c61338404..268dcc409 100644 --- a/docs/els-for-applications/wildfly/README.md +++ b/docs/els-for-applications/wildfly/README.md @@ -7,95 +7,166 @@ Wildfly is a trademark of Red Hat, Inc. TuxCare's Endless Lifecycle Support (ELS) for Wildfly provides security patches and selected bug fixes that are integral to the stable operation of applications running on these versions of Wildfly. These components have either reached their end of standard support from vendors or have reached End of Life (EOL). Our ELS for Wildfly service is designed to provide solutions for organizations that are not yet ready to migrate to newer versions and that are seeking long-term stability for their legacy Wildfly applications. +This guide outlines the steps needed for Wildfly server setup and configuration. + ## Supported Versions -* Wildfly 19.0.1.Final +* Wildfly 27.0.1.Final ## Installation +* Java Development Kit (JDK) 11 or later installed (verify with `java -version`) +* `JAVA_HOME` set to your JDK installation directory * Nexus repository access credentials (username and password) — contact [sales@tuxcare.com](mailto:sales@tuxcare.com) * To browse available artifacts, visit TuxCare [Nexus](https://nexus.repo.tuxcare.com/#browse/browse:els_java) and click **Sign in** in the top right corner. You may need to refresh the page after logging in. +## Linux Installation + -1. **Navigate to the build tool directory** - * Windows +1. **Prepare a `wildfly` group** + + Create a `wildfly` group: + ```text - Maven: C:\Users\{username}\.m2 - Gradle: C:\Users\{username}\.gradle + sudo groupadd wildfly ``` - * macOS + +2. **Create a `wildfly` user** + + Create a new user as a member of the `wildfly` group, with a home directory of `/opt/wildfly` and the login shell set to `/bin/false`. + ```text - Maven: /Users/{username}/.m2 - Gradle: /Users/{username}/.gradle + sudo useradd -s /bin/false -g wildfly -d /opt/wildfly wildfly ``` - * Linux + +3. **Download the TuxCare build** + + Download from TuxCare using your credentials. For example, Wildfly 27.0.1.Final: + ```text - Maven: /home/{username}/.m2 - Gradle: /home/{username}/.gradle + curl -u USERNAME:PASSWORD -O https://nexus.repo.tuxcare.com/repository/els_java/org/wildfly/wildfly-ee-dist/27.0.1.Final-tuxcare.1/wildfly-ee-dist-27.0.1.Final-tuxcare.1.tar.gz ``` -2. **Configure credentials** + Replace `USERNAME` and `PASSWORD` with your TuxCare credentials (see [Prerequisites](#prerequisites) above). + +4. **Create the installation directory and extract the archive** + + * Create the `/opt/wildfly` directory: + + ```text + sudo mkdir -p /opt/wildfly + ``` + + * Extract the archive into it: + + ```text + sudo tar -xvzf wildfly-ee-dist-27.0.1.Final-tuxcare.1.tar.gz -C /opt/wildfly --strip-components=1 + ``` + +5. **Configure ownership and permissions** + + Change ownership of the installation to the `wildfly` user and group: + + ```text + sudo chown -R wildfly:wildfly /opt/wildfly + ``` + +6. **Set `JBOSS_HOME` and reload the shell** + + * Add the following line at the end of your `~/.bashrc` file, updating the path if needed. + + ```text + export JBOSS_HOME=/opt/wildfly + ``` :::tip - For Maven, you may choose any valid `` value instead of `tuxcare-registry`, but the same value must be used in both `settings.xml` and `pom.xml`. + If you're using a different shell, you may need to edit `~/.bash_profile` instead. ::: - + * Reload the shell configuration: - Replace `USERNAME` and `PASSWORD` with your TuxCare credentials (see [Prerequisites](#prerequisites) above). + ```text + source ~/.bashrc + ``` -3. **Add the TuxCare repository** + * Confirm the variable is set: - Add the TuxCare Wildfly repository and plugins to your build configuration. + ```text + echo $JBOSS_HOME + ``` - +7. **Start Wildfly** - * To fully switch from the official Wildfly repository, replace it with the TuxCare repository. - * To keep both, add TuxCare after the official one. + ```text + sudo -u wildfly /opt/wildfly/bin/standalone.sh + ``` - Example Maven and Gradle projects are available on GitHub. Remember to set the required environment variables. - * [Maven](https://github.com/cloudlinux/securechain-java/tree/main/examples/maven) - * [Gradle](https://github.com/cloudlinux/securechain-java/tree/main/examples/gradle) +8. **Verify installation** -4. **Update dependencies** + * Go to [http://localhost:8080/](http://localhost:8080/). You should see the default Wildfly welcome page. - Replace Wildfly dependencies with TuxCare-maintained versions. You can find artifact versions on [Nexus](https://nexus.repo.tuxcare.com/#browse/browse:els_java) — sign in with your TuxCare credentials. + * Or check from the terminal (successful output is HTML from Wildfly): + + ```text + curl http://localhost:8080 + ``` + +9. **Stop Wildfly** + + ```text + /opt/wildfly/bin/jboss-cli.sh --connect command=:shutdown + ``` - +## Windows Installation -5. **Verify the setup** +1. **Download Wildfly** - Use your build tool to list the project's dependencies and confirm TuxCare packages are resolved correctly. + Download the .zip archive from [https://nexus.repo.tuxcare.com/repository/els_java/org/wildfly/wildfly-ee-dist/27.0.1.Final-tuxcare.1/](https://nexus.repo.tuxcare.com/repository/els_java/org/wildfly/wildfly-ee-dist/27.0.1.Final-tuxcare.1/) using your credentials, for example `wildfly-ee-dist-27.0.1.Final-tuxcare.1.zip`. - +2. **Extract the archive** -6. **Build the project** + Extract the archive to the installation directory, e.g., `C:\WildFly`. - Include any library from the repository and run a build. +3. **Open Environment Variables** - + Right-click *This PC* → *Properties* → *Advanced system settings* → *Environment Variables*. - The build tool you're using should be able to identify and resolve dependencies from the TuxCare ELS for Wildfly repository. +4. **Set `JBOSS_HOME`** + + Add a new system variable with the value `C:\WildFly` (or your installation path). + +5. **Start Wildfly** + + Run `C:\WildFly\bin\standalone.bat`. + +6. **Verify installation** + + Go to [http://localhost:8080/](http://localhost:8080/) in your browser. You should see the default Wildfly welcome page. + +7. **Stop Wildfly** + + Run `C:\WildFly\bin\jboss-cli.bat --connect command=:shutdown`. + +## Logs Location + +Check logs for detailed error information: + +* **Linux:** + + ```text + /opt/wildfly/standalone/log/server.log + ``` + +* **Windows:** + + ```text + C:\WildFly\standalone\log\server.log + ``` @@ -110,61 +181,3 @@ Our ELS for Wildfly service is designed to provide solutions for organizations t * ![](/images/wrench.webp) [Managing the ELS repository](/els-for-applications/managing-els-repository/) — Update to newer versions - - - - From b10a773133753029ec86af8b4a2f6e20e73869c6 Mon Sep 17 00:00:00 2001 From: Nadya2502 Date: Thu, 25 Jun 2026 14:45:59 +0200 Subject: [PATCH 3/3] ELSDOC-295, updated --- docs/els-for-applications/wildfly/README.md | 131 +++++++++----------- 1 file changed, 62 insertions(+), 69 deletions(-) diff --git a/docs/els-for-applications/wildfly/README.md b/docs/els-for-applications/wildfly/README.md index 268dcc409..8079a4e69 100644 --- a/docs/els-for-applications/wildfly/README.md +++ b/docs/els-for-applications/wildfly/README.md @@ -28,23 +28,7 @@ This guide outlines the steps needed for Wildfly server setup and configuration. -1. **Prepare a `wildfly` group** - - Create a `wildfly` group: - - ```text - sudo groupadd wildfly - ``` - -2. **Create a `wildfly` user** - - Create a new user as a member of the `wildfly` group, with a home directory of `/opt/wildfly` and the login shell set to `/bin/false`. - - ```text - sudo useradd -s /bin/false -g wildfly -d /opt/wildfly wildfly - ``` - -3. **Download the TuxCare build** +1. **Download the TuxCare build** Download from TuxCare using your credentials. For example, Wildfly 27.0.1.Final: @@ -54,59 +38,34 @@ This guide outlines the steps needed for Wildfly server setup and configuration. Replace `USERNAME` and `PASSWORD` with your TuxCare credentials (see [Prerequisites](#prerequisites) above). -4. **Create the installation directory and extract the archive** - - * Create the `/opt/wildfly` directory: - - ```text - sudo mkdir -p /opt/wildfly - ``` +2. **Extract the archive** - * Extract the archive into it: + Create an installation directory in your home folder and extract the archive into it: ```text - sudo tar -xvzf wildfly-ee-dist-27.0.1.Final-tuxcare.1.tar.gz -C /opt/wildfly --strip-components=1 + mkdir -p ~/wildfly + tar -xzf wildfly-ee-dist-27.0.1.Final-tuxcare.1.tar.gz -C ~/wildfly --strip-components=1 ``` -5. **Configure ownership and permissions** - - Change ownership of the installation to the `wildfly` user and group: +3. **Verify the installation** ```text - sudo chown -R wildfly:wildfly /opt/wildfly + ~/wildfly/bin/standalone.sh --version ``` -6. **Set `JBOSS_HOME` and reload the shell** + The output should display the Wildfly version and build details. - * Add the following line at the end of your `~/.bashrc` file, updating the path if needed. +4. **Start Wildfly** ```text - export JBOSS_HOME=/opt/wildfly + ~/wildfly/bin/standalone.sh ``` :::tip - If you're using a different shell, you may need to edit `~/.bash_profile` instead. + This command runs in the foreground and keeps the terminal busy. Use a second terminal to verify and stop the server. ::: - * Reload the shell configuration: - - ```text - source ~/.bashrc - ``` - - * Confirm the variable is set: - - ```text - echo $JBOSS_HOME - ``` - -7. **Start Wildfly** - - ```text - sudo -u wildfly /opt/wildfly/bin/standalone.sh - ``` - -8. **Verify installation** +5. **Verify the server is running** * Go to [http://localhost:8080/](http://localhost:8080/). You should see the default Wildfly welcome page. @@ -116,41 +75,73 @@ This guide outlines the steps needed for Wildfly server setup and configuration. curl http://localhost:8080 ``` -9. **Stop Wildfly** +6. **Stop Wildfly** ```text - /opt/wildfly/bin/jboss-cli.sh --connect command=:shutdown + ~/wildfly/bin/jboss-cli.sh --connect command=:shutdown ``` ## Windows Installation 1. **Download Wildfly** - Download the .zip archive from [https://nexus.repo.tuxcare.com/repository/els_java/org/wildfly/wildfly-ee-dist/27.0.1.Final-tuxcare.1/](https://nexus.repo.tuxcare.com/repository/els_java/org/wildfly/wildfly-ee-dist/27.0.1.Final-tuxcare.1/) using your credentials, for example `wildfly-ee-dist-27.0.1.Final-tuxcare.1.zip`. + Download the `.zip` archive from [Nexus](https://nexus.repo.tuxcare.com/repository/els_java/org/wildfly/wildfly-ee-dist/27.0.1.Final-tuxcare.1/) using your credentials, for example `wildfly-ee-dist-27.0.1.Final-tuxcare.1.zip`. 2. **Extract the archive** - Extract the archive to the installation directory, e.g., `C:\WildFly`. + Extract it to the installation directory, e.g., `C:\WildFly`. The archive contains a top-level folder, so this produces `C:\WildFly\wildfly-27.0.1.Final-tuxcare.1` — that folder is your Wildfly directory. + +3. **Start Wildfly** + + Run `C:\WildFly\wildfly-27.0.1.Final-tuxcare.1\bin\standalone.bat`. -3. **Open Environment Variables** + :::tip + This window stays open while the server runs. Use your browser (next step) to verify it, and a second window to stop it. + ::: - Right-click *This PC* → *Properties* → *Advanced system settings* → *Environment Variables*. +4. **Verify the server is running** -4. **Set `JBOSS_HOME`** + Go to [http://localhost:8080/](http://localhost:8080/) in your browser. You should see the default Wildfly welcome page. - Add a new system variable with the value `C:\WildFly` (or your installation path). +5. **Stop Wildfly** -5. **Start Wildfly** + Run `C:\WildFly\wildfly-27.0.1.Final-tuxcare.1\bin\jboss-cli.bat --connect command=:shutdown` from a second window. - Run `C:\WildFly\bin\standalone.bat`. +## Use Case: Production Setup Linux -6. **Verify installation** +1. **Create a `wildfly` group** - Go to [http://localhost:8080/](http://localhost:8080/) in your browser. You should see the default Wildfly welcome page. + ```text + sudo groupadd wildfly + ``` + +2. **Create a `wildfly` user** -7. **Stop Wildfly** + Create a new user as a member of the `wildfly` group, with a home directory of `/opt/wildfly` and the login shell set to `/bin/false`: - Run `C:\WildFly\bin\jboss-cli.bat --connect command=:shutdown`. + ```text + sudo useradd -s /bin/false -g wildfly -d /opt/wildfly wildfly + ``` + +3. **Install into `/opt/wildfly` and set ownership** + + ```text + sudo mkdir -p /opt/wildfly + sudo tar -xzf wildfly-ee-dist-27.0.1.Final-tuxcare.1.tar.gz -C /opt/wildfly --strip-components=1 + sudo chown -R wildfly:wildfly /opt/wildfly + ``` + +4. **Start Wildfly as the `wildfly` user** + + ```text + sudo -u wildfly JAVA_HOME=/path/to/your/jdk /opt/wildfly/bin/standalone.sh + ``` + + :::tip + `sudo` does not pass your environment to the target user, so set `JAVA_HOME` explicitly (or configure it for the `wildfly` user). Otherwise the server fails with `java: command not found`. + ::: + + Stop it from a second terminal with `/opt/wildfly/bin/jboss-cli.sh --connect command=:shutdown`. ## Logs Location @@ -159,13 +150,15 @@ Check logs for detailed error information: * **Linux:** ```text - /opt/wildfly/standalone/log/server.log + ~/wildfly/standalone/log/server.log ``` + (or `/opt/wildfly/standalone/log/server.log` if you installed under a dedicated user) + * **Windows:** ```text - C:\WildFly\standalone\log\server.log + C:\WildFly\wildfly-27.0.1.Final-tuxcare.1\standalone\log\server.log ```