Red Hat Summit Red Hat SummitSupportConsoleDevelopersStart a trialContact

Red Hat Ansible Certified Content Collection for Red Hat JBoss Web Server Release Notes

Red Hat JBoss Web Server 6.1

For Use with the Red Hat JBoss Web Server 6.1

Red Hat Customer Content Services

Abstract

These release notes contain important information related to the Red Hat Ansible Certified Content Collection for Red Hat JBoss Web Server.

Preface
Copy link

The Red Hat Ansible Certified Content Collection for Red Hat JBoss Web Server is a prepackaged Ansible content collection that Red Hat provides. You can use the Red Hat Ansible Certified Content Collection to automate the installation and configuration of the Red Hat JBoss Web Server product. You can also add customized tasks to your playbook to automate the deployment of JBoss Web Server applications either at the same time as the automated product installation or later.

For general information about the Red Hat Ansible Certified Content Collection, see the Ansible Collection - redhat.jws page in Ansible automation hub. The Ansible Collection - redhat.jws page includes information about the roles that the collection contains. You can click the name of a role to view details about the purpose of this role, any requirements or dependencies, and the list of variables and default settings that the role uses to complete automation tasks.

For more information about Ansible concepts or the benefits of using Ansible, see Ansible concepts and benefits.

The Red Hat Ansible Certified Content Collection for Red Hat JBoss Web Server is released with Production Support. If you have any issues or questions related to this collection, please contact support at Red Hat Customer Experience & Engagement.

Note

The rest of this document refers to the Red Hat Ansible Certified Content Collection for Red Hat JBoss Web Server as the JBoss Web Server collection.

To report an error or to improve our documentation, log in to your Red Hat Jira account and submit an issue. If you do not have a Red Hat Jira account, then you will be prompted to create an account.

Procedure

  1. Click the following link to create a ticket.
  2. Enter a brief description of the issue in the Summary.
  3. Provide a detailed description of the issue or enhancement in the Description. Include a URL to where the issue occurs in the documentation.
  4. Clicking Create creates and routes the issue to the appropriate documentation team.

Making open source more inclusive
Copy link

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. We are beginning with these four terms: master, slave, blacklist, and whitelist. Because of the enormity of this endeavor, these changes will be implemented gradually over several upcoming releases. For more details, see our CTO Chris Wright’s message.

As a first step toward automating deployments of Red Hat JBoss Web Server by using Ansible, you must download and install the JBoss Web Server collection from Ansible automation hub. The JBoss Web Server collection is named redhat.jws in Ansible automation hub. Before you install the JBoss Web Server collection, you must ensure that your system complies with certain prerequisites. You must install the JBoss Web Server collection on an Ansible control node in your system.

For more information about any prerequisites and installing the collection, see Installing the JBoss Web Server collection.

This release of the JBoss Web Server collection includes the following features.

2.1. New or changed features in the latest release
Copy link

The latest release of the JBoss Web Server collection provides the following new or changed features.

The 2.1 release of the JBoss Web Server collection requires that you have installed the ansible-core package version 2.16 or later on a control node in your system. You can install the ansible-core package by installing Red Hat Ansible Automation Platform 2.x. For more information, see the Red Hat Ansible Automation Platform Installation Guide.

From the 2.1 release onward, the JBoss Web Server collection is also configured to install the native archive file for the specified product version by default. The jws_native variable is now set to True by default.

This supersedes the behavior in earlier releases where the jws_native variable was set to False by default. In this situation, unless you explicitly changed the jws_native variable setting to True, the JBoss Web Server collection did not install the native archive file.

Note

If you set the jws_native variable to False, the JBoss Web Server collection cannot install the native archive, which causes issues for features such as SELinux policies that require the installation of a native archive file.

From the 2.1 release onward, the redhat.jws.jws role is already preconfigured with become: true directives, which activate user privilege escalation for performing any automated tasks that require root privileges on your target hosts.

From the 2.1 release onward, because the redhat.jws.jws role is preconfigured with become: true directives, you no longer need to specify a become: true directive in your playbook.

This supersedes the behavior in earlier releases where the JBoss Web Server collection required that you specify a become: true directive in your playbook to activate user privilege escalation at the play level.

2.2. New or changed features in earlier releases
Copy link

The JBoss Web Server collection includes the following features that were introduced in earlier releases.

2.2.1. Full Red Hat support
Copy link

From the 2.0 release onward, the JBoss Web Server collection is a fully supported feature from Red Hat. Before the 2.0 release, the JBoss Web Server collection was a Technology Preview feature only.

The JBoss Web Server collection supports the automated installation of Red Hat JBoss Web Server on target hosts that are running on Red Hat Enterprise Linux (RHEL) version 8 or 9.

The JBoss Web Server collection provides a comprehensive set of predefined variables and default values that you can manually update to match your setup requirements. These variable settings provide all the information that the JBoss Web Server collection requires to complete an automated and customized installation of Red Hat JBoss Web Server on your target hosts.

For a full list of variables that the JBoss Web Server collection provides, see the redhat.jws.jws role in Ansible automation hub. The information page for the redhat.jws.jws role lists the names, descriptions, and default values for all the variables that you can define.

By default, the JBoss Web Server collection supports the automated installation of Red Hat JBoss Web Server from product archive files. You can enable the JBoss Web Server collection to install the base release of a specified JBoss Web Server version from archive files. A base release is the initial release of a specific product version (for example, 6.1.0 is the base release of version 6.1).

The JBoss Web Server collection requires that local copies of the appropriate archive files are available on your Ansible control node. If copies of the archive files are not already on your system, you can set variables to permit automatic file downloads from the Red Hat Customer Portal. For more information, see Support for automatic download of archive files. Alternatively, you can download the archive files manually.

This feature also includes variables to support the following automation setup tasks:

  • You can specify the base release of the product version that you want to install.
  • If you have changed the names of the archive files on your Ansible control node, you can specify the appropriate file names.

After you set the appropriate variables, the JBoss Web Server collection automatically extracts the archive files and installs the product on your target hosts when you subsequently run the playbook.

For more information, see Enabling the automated installation of a JBoss Web Server base release.

If product patch updates are available for the JBoss Web Server version that is being installed, you can also enable the JBoss Web Server collection to install these patch updates from archive files. This feature is disabled by default. You can use the same steps to enable the automated installation of patch updates regardless of whether you want to install these updates at the same time as the base release or later.

The JBoss Web Server collection requires that local copies of the appropriate archive files are available on your Ansible control node. If copies of the archive files are not already on your system, you can set variables to permit automatic file downloads from the Red Hat Customer Portal. For more information, see Support for automatic download of archive files. Alternatively, you can download the archive files manually.

This feature also includes variables to support the following automation setup tasks:

  • You can enable the automated installation of patch updates.
  • If you want to install a specified patch release rather than the latest available patch update, you can specify the appropriate patch release.
  • If you want to prevent the JBoss Web Server collection from contacting the Red Hat Customer Portal for file downloads, you can enable a fully offline installation. For more information, see Support for fully offline installations from archive files.

After you set the appropriate variables, the JBoss Web Server collection automatically extracts the archive files and installs the patch updates on your target hosts when you subsequently run the playbook.

For more information, see Enabling the automated installation of JBoss Web Server patch updates.

The JBoss Web Server collection is configured to support the automatic download of archive files by default. However, this feature also requires that you set variables to specify the client identifier (ID) and secret that are associated with your Red Hat service account.

Note

Service accounts enable you to securely and automatically connect and authenticate services or applications without requiring end-user credentials or direct interaction. To create a service account, you can log in to the Service Accounts page in the Red Hat Hybrid Cloud Console, and click Create service account.

For more information, see Enabling the automated installation of a JBoss Web Server base release and Enabling the automated installation of JBoss Web Server patch updates.

By default, the JBoss Web Server collection is configured to contact the Red Hat Customer Portal to check if new patch updates are available. However, you can optionally set a variable to enforce a fully offline installation and prevent the collection from contacting the Red Hat Customer Portal, This feature is useful if your Ansible control node does not have internet access and you want the collection to avoid contacting the Red Hat Customer Portal for file downloads.

Note

If you enable this feature, you must also set a variable to specify the patch release that you want to install. You must also ensure that copies of the appropriate archive files already exist on your Ansible control node.

For more information, see Enabling the automated installation of JBoss Web Server patch updates.

You can enable the JBoss Web Server collection to install Red Hat JBoss Web Server from RPM packages. This feature is disabled by default.

When you enable the RPM installation method, the JBoss Web Server collection installs the latest RPM packages for a specified major version of the product, including any minor version and patch updates. The collection obtains the RPM packages directly from Red Hat.

This feature includes variables to support the following automation setup tasks:

  • You can specify the product version that you want to install.
  • You can enable the RPM installation method.

After you set the appropriate variables, the JBoss Web Server collection automatically obtains the latest RPM packages and installs these packages on your target hosts when you subsequently run the playbook.

For more information, see Enabling the automated installation of JBoss Web Server from RPM packages.

By default, the JBoss Web Server collection does not install a JDK automatically on your target hosts, based on the assumption that you have already installed a supported JDK on these hosts. However, for the sake of convenience, you can optionally set a variable to enable the automated installation of a supported version of Red Hat build of OpenJDK. In this situation, the JBoss Web Server collection automatically installs the specified OpenJDK version on each target host when you subsequently run the playbook.

Note

The JBoss Web Server collection supports the automated installation of Red Hat build of OpenJDK only. If you want to use a supported version of IBM JDK or Oracle JDK, you must install the JDK manually on each target host or you can automate this process by using your playbook. For more information about manually installing a version of IBM JDK or Oracle JDK, see the Red Hat JBoss Web Server Installation Guide.

For more information, see Ensuring that a JDK is installed on the target hosts.

By default, the JBoss Web Server collection creates a tomcat user account and a tomcat group automatically on each target host. However, if you want the JBoss Web Server collection to create a different user account and group, you can set variables to modify the behavior of the JBoss Web Server collection to match your setup requirements. In this situation, the JBoss Web Server collection automatically creates the specified user account and group name on each target host when you subsequently run the playbook.

For more information, see Ensuring that a product user and group are created on the target hosts.

By default, the JBoss Web Server collection is not configured to set up Red Hat JBoss Web Server as a service that a system daemon can manage. However, if you want the JBoss Web Server collection to integrate Red Hat JBoss Web Server with a system daemon, you can set a variable to modify the behavior of the JBoss Web Server collection to match your setup requirements.

If you enable this feature, the JBoss Web Server collection sets up Red Hat JBoss Web Server as a jws6‑tomcat service automatically on each target host. However, if you want to use a different service name, you can also set a variable to instruct the JBoss Web Server collection to create a different service name.

Note

The JBoss Web Server service is managed by systemd.

If you have not enabled an automated installation of Red Hat build of OpenJDK, you must also set a variable to specify the location of the JDK that is installed on your target hosts. This step is required to ensure successful integration with systemd.

For more information, see Enabling the automated integration of JBoss Web Server with systemd.

The JBoss Web Server collection provides a comprehensive set of variables to enable the automated configuration of a Red Hat JBoss Web Server installation. By default, the JBoss Web Server collection configures Red Hat JBoss Web Server to listen for nonsecure HTTP connections on port 8080.

Other product features such as the following are disabled by default:

  • Support for secure HTTPS connections
  • Mod_cluster support for load-balancing HTTP server requests to the JBoss Web Server back end
  • The password vault for storing sensitive data in an encrypted Java keystore
  • Support for Apache JServ Protocol (AJP) traffic between JBoss Web Server and the Apache HTTP Server

To enable a wider set of product features, you can set variables to modify the behavior of the JBoss Web Server collection to match your setup requirements.

For more information, see Enablement of automated JBoss Web Server configuration tasks.

You can also automate the deployment of web applications on your target hosts by adding customized tasks to the playbook. If you want to deploy a new or updated application when Red Hat JBoss Web Server is already running, the JBoss Web Server collection provides a handler to restart the web server when the application is deployed.

For more information, see Enabling the automated deployment of JBoss Web Server applications on your target hosts.

Chapter 3. Resolved issues
Copy link

The following issues are resolved in the latest release of the JBoss Web Server collection:

Expand
IssueDescription

AMW-203

Typo in jws_conf_loggging variable

AMW-200

jws_selinux_enabled requires jws_native

Chapter 4. Known issues
Copy link

There are no known issues for the latest release of the JBoss Web Server collection.

Legal Notice
Copy link

Copyright © 2025 Red Hat, Inc.
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.
Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2025 Red Hat