Configure Wildfly as a Web Application Server
Updated: Feb 27
Teamcenter and Active Workspace require a Web Application Server for communication from the client to the Server Manager. Wildfly is one option of many (Tomcat, Weblogic, JBoss, etc.) that can be used to perform this function.
In the example below, we demonstrate how to configure Wildfly (JBoss) to connect to the Teamcenter and Active Workspace environment to enable communication pass through.
The configuration of the tc.war is a prerequisite for this process. This process provides an interaction with the Web Application Manager (WAM) to build the tc.war file. In addition, if not done already, if you are running Active Workspace 4.3+ you will need to ensure the Microservices are integrated into the Web Application Server.
For information regarding compatible versions of Wildfly and other supported Web Application Servers, see the Teamcenter Certifications and Information section of the Hardware and Software Certifications page on the Siemens Solution Center.
The image (above) shows the various versions of the available Teamcenter Certifications documents on the Siemens Support Center webpage.
Try it out
Learn how to install and configure Wildfly to support a Development or Training Teamcenter and Active Workspace Environment.
Version compatibility
The process is validated in Teamcenter 11 through the latest release (14.*). The process is also validated in Active Workspace 3.4 through the latest release of (6.*). Versions of Wildfly vary depending on the supported version of Teamcenter.
Process to configure Wildfly
Download and extract the supported (compatible) version of Wildfly
Tip. Be sure to reference the Hardware and Software Certifications for the version you are installing to ensure you use the correct and supported version of Wildfly.
Tip. Ensure the directory where Wildfly executes is the directory you intend to run it from prior to proceeding to the configuration.
Example. we placed the wildfly-26.1.1.Final (supported version for Teamcenter 14) in our C:\Apps directory.
Modify the standalone.xml configuration file in the Wildfly installation.
Locate the standalone.xml file in the Wildfly directory. This directory is under the main Wildfly program directory at the following location:
<WILDFLY>\standalone\configuration\standalone.xmlOpen the standalone.xml file in a text editor (we prefer Visual Studio Code).
The image (above) shows an example in Wildfly26 where the standalone.xml file resides.
Tip. In addition to Visual Studio Code, Notepad, Notepad++, and other text editors will do the job just fine.
In the standalone.xml file, perform a search for the following string.
EE:
The image (above) shows the line to look for in the standalone.xml file and the search term.
Caution. The ee:6.0 may reference other numbers, such as 4.0, in different versions of Wildfly. The search ee: will be the key identifier for the line.
Directly beneath the <subsystem xmlns="urn:jboss:domain:ee6.0"> line, add the following element.
<global-modules>
<module name="org.jboss.as.jmx" slot="main"/>
</global-modules>The resulting file will resemble the following screenshot.
The image (above) shows the resulting xml definition in the standalone.xml file.
In the standalone.xml file, perform a search for public.
Locate the interfaces section of the file.
Update the inet-address IP addresses to reflect a range available to your server.
In this example, we used 0.0.0.0 which is wide open. This is only acceptable for our purposes due to other security measures blocking access to the server. Read more information regarding IP addresses and subnets.
Save and close the standalone.xml file.
Add the JMX dependency to Wildfly
Due to adding the org.jboss.as.jmx module to the standalone.xml, you must next add the dependency for the module in order to use it.
In the Wildfly directory, navigate to the following sub-directory.
<WILDFLY>\modules\system\layers\base\org\jboss\as\connector\main
The image (above) shows the module.xml file in the subdirectory in the Wildfly installation. Note that the base folder may vary based on Wildfly version used.
Open the module.xml file in a text editor.
Near the bottom of the file, add the following element.
<module name="org.jboss.as.jmx"/>
The image (above) shows the resulting file with the added element.
Save and close the module.xml file.
Install Wildfly as a service
In order to create an automated service to run Wildfly at startup of the Windows Operating System, you must first copy the service scripts to the <WILDFLY> bin directory and execute the service with a provided script.
In the <WILDFLY> home directory, navigate to:
C:\Apps\wildfly-26.1.1.Final\docs\contrib\scriptsCopy the service folder.
In the <WILDFLY> home directory, navigate to:
C:\Apps\wildfly-26.1.1.Final\binPaste the copied service folder.
The resulting directory will resemble the image (below).