Moogsoft Docs

Configuring JBoss(Wildfly)

JBoss (WildFly) Configuration

Configuring JBoss (WildFly) to function with the JMS LAM has 4 steps:

  1. Adding the jboss-client jar to Moogsoft AIOps
  2. Creating a user for WildFly application (optional).
  3. Creating a JMS Queue.
  4. Creating a JMS Topic.
  5. SSL Configuration for WildFly (optional).

Adding the JBoss Jar to Moogsoft AIOps

The jboss-client.jar has to be added to Moogsoft AIOps to establish a connection with JBoss. Copy the jboss-client.jar to the $MOOGSOFT_HOME/lib/cots/nonDist directory in Moogsoft AIOps

Note

The jboss-client.jar for Linux can be found in the directory $JBOSS_HOME/wildfly10/bin/client

Note

The jboss-client.jar for Windows can be found in the directory C:\wildfly10\bin\client

Creating a user for WildFly (Optional)

Note

If a user is already created and its user credentials are available, then do not add a user for WildFly. The user is required to log into the Administration Console

WildFly is distributed with security enabled for the management interfaces. For adding a queue or topic, a user has to be added for accessing WildFly. To create a user, proceed as follows:

  1. Open a Linux CLI.
  2. Navigate to the bin directory of the extracted WildFly application using the cd command.
  3. Enter the command add-user.sh and press the enter key.

    Note

    For Windows, navigate to the bin directory of the extracted WildFly application using the cd command in command prompt, then enter the command add-user.bat


    The following question is displayed:

    What type of user do you wish to add?
    a) Management User (mgmt-users.properties)
    b) Application User (application-users.properties)

  4. Type a and press the enter key.

  5. Enter the username, password and retype the password when prompted and then press the enter key.
  6. Press the enter key when the question What groups do you want this user to belong to? (please enter a comma separated list, or leave blank for none) [ ]: is displayed.

  7. Press the enter key when the question About to add user username for the realm ManagementRealm Is this correct yes/no? is displayed.

    Note

    It is important to leave the name of the realm as ManagementRealm for management user, as it is required for matching the user name in the server configuration

  8. Enter yes when the question Is this correct yes/no? is displayed and press the enter key.
  9. Enter yes when the question Is this new user going to be used for one AS process to connect to another AS process? is displayed and press the enter key.

    Note

    The user will be written to the properties files used for authentication and a confirmation message will be displayed

The user for WildFly is added and can be used to log into the Administration Console.

Creating a JMS Queue for WildFly using Linux CLI

The queue can be created using a Linux CLI or by accessing the Administration Console from a browser in Windows or Linux.

To create a queue using Linux CLI:

  1. Navigate to the bin directory of WildFly using the cd command.
  2. Stop the WildFly Server using the following command:

    jboss-cli.sh -c --command=:shutdown
  3. Navigate to the configuration folder by entering the following commands :

    cd ..
    cd standalone/configuration
  4. Open the standalone-full.xml file by using either the vi or the vim editor.

    Note

    For Windows, navigate to the configuration directory where WildFly is extracted, and open the standalone-full.xml file in a notepad or a wordpad

    Note

    Take a backup of the standalone-full.xml file before making any changes

  5. Find the messaging subsystem section in the standalone-full.xml file:

    <subsystem xmlns="urn:jboss:domain:messaging:2.0">
  6. Scroll to the end of the messaging subsystem section and add the following XML after the </jms-connection-factories> end tag but before the </hornetq-server> element:

    <jms-destinations>
            <jms-queue name="testQueue">
            <entry name="java:jboss/exported/jms/queue/test"/>
            </jms-queue>
        </jms-destinations>
    • The queue name is entered in <jms-queue name>
    • The JNDI is entered in <entry name>
  7. Save the changes and close the file using the command :wq! .
  8. Navigate back to the bin directory.
  9. Start the server by executing the following command:

    ./standalone.sh -c standalone-full.xml -b=0.0.0.0 -bmanagement=0.0.0.0

    Note

    For Windows, to start the WildFly server execute the following command in the command prompt:

    standalone.bat -c standalone-full-ssl.xml -b=0.0.0.0 -bmanagement=0.0.0.0

    Note

    After making the changes to the standalone-full.xml file, copy it to the bin folder and then run the above command

The JMS queue is created in WildFly.

Creating a JMS Queue for WildFly using Administration Console


  1. Open the welcome screen by entering the URL http://localhost:8080 in a browser, then click on Administration Console .

    Alternatively, the Administration Console can also be accessed by entering the URL http://localhost:9990 in a browser.
  2. Enter the username and password of the user defined for WildFly .
  3. Click on Start, adjacent to Create a JMS Queue .

  4. Select Subsystems in the Configuration section, then select Messaging-ActiveMQ in the Subsystem section.

  5. Click on default. The Queues/Topic field is displayed.

  6. Click on Queues/Topics . The Messaging Destinations view opens. Click the Add button in the Queues tab of the JMS Endpoints: Provider default view.

  7. Enter the name of the JMS queue in the Name field e.g. Test_Queue.

  8. Specify the JNDI Name as java:/jboss/exported/jms/queue/<name of queue> E.g. java:/jboss/exported/jms/queue/Test_Queue .

    Note

    A queue which needs to be accessed by a remote client should have an entry in the "java:jboss/exported" namespace

  9. Select the Durable checkbox.

    Note

    Durable subscription in JMS means that if subscriber is disconnected and then connected again to a JMS destination, then the destination will receive all messages that have been sent to it and have not expired

  10. Leave the Selector field blank and click on Save.
    The queue is added and can be viewed in the Queues tab.

Note

For WildFly 8, in the Administration Console, navigate to messaging > Destinations , then click on view . Now add the queue as described above

Creating a JMS Topic for WildFly using Linux CLI

The topic can be created using a Linux CLI or by accessing the Administration Console from a browser in Windows or Linux.

To create a topic using Linux CLI, proceed as follows:

  1. Navigate to the bin directory of WildFly using the cd command.
  2. Stop the WildFly Server using the following command:

    jboss-cli.sh -c --command=:shutdown
  3. Navigate to the configuration folder by entering the following commands :

    cd ..
    cd standalone/configuration
  4. Open the standalone-full.xml file by using either the vi or the vim editor.

    Note

    For Windows, navigate to the directory where wildfly is extracted, and open the s tandalone-full.xml file in a notepad or a wordpad

    Note

    Take a backup of the standalone-full.xml file before making any changes

  5. Find the messaging subsystem section in the standalone-full.xml file:

    <subsystem xmlns="urn:jboss:domain:messaging:2.0">
  6. Scroll to the end of the messaging subsystem section and add the following XML after the </jms-connection-factories> end tag but before the </hornetq-server> element:

    <jms-destinations>
            <jms-topic name="testtopic">
            <entry name="java:jboss/exported/jms/topic/test"/>
            </jms-topic>
        </jms-destinations>
    • The queue name is entered in <name>
    • The JNDI is entered in <entry name>
  7. Save the changes and close the file using the command :wq! .
  8. Navigate back to the bin directory.
  9. Start the server by executing the following command:

    standalone.sh -c standalone-full.xml

    Note

    For Windows, to start the WildFly server execute the following command in the command prompt:

    standalone.bat -c standalone-full.xml

The JMS topic is created in WildFly.

Creating a JMS Topic for WildFly using Administration Console

To create a topic by accessing the Administration Console from a browser, proceed as follows:

  1. Open the welcome screen by entering the URL http://localhost:8080 in a browser, and click on Administration Console .


    Alternatively, the Administration Console can also be accessed by entering the URL http://localhost:9990 in a browser.
  2. Enter the username and password of the user defined for WildFly .
  3. Click on Start, adjacent to Create a JMS Queue .

  4. Select Subsystems in the Configuration section, and select Messaging-ActiveMQ in the Subsystem section.

  5. Click on default. The Queues/Topic field is displayed.

  6. Click on Queues/Topic . The Messaging Destinations view opens. Click on the Add button in the Topics tab of the JMS Endpoints: Provider default view.
  7. Enter the name of the JMS queue in the Name field e.g. Test_topic.
  8. Specify the JNDI Name as java:/jboss/exported/jms/topic/<name of the topic>, E.g. java:/jboss/exported/jms/topic/Test_topic .

    Note

    A topic which needs to be accessed by a remote client should have an entry in the "java:jboss/exported" namespace

  9. Click on Save. The topic is added and can be viewed in the Topics tab.

Note

For WildFly 8, in the Administration Console, navigate to messaging > Destinations , then click on view . Now add the queue as described above

SSL Configuration for WildFly (Optional)

To configure SSL in JBoss proceed as follows:

Note

If the SSL configuration is already implemented for JBoss, then this configuration can be skipped

Note

For JBoss SSL communication the WildFly 8.2.1 version is supported

Note

The following procedure is same for both Windows and Linux

  1. Open a Linux CLI and create a folder using the command mkdir SSL
  2. Navigate to SSL directory using the command cd SSL .
  3. Execute the following commands one by one.

    keytool -genkeypair -alias serverkey -keyalg RSA -keysize 2048 -validity 7360 -keystore server.keystore  
    keytool -genkeypair -alias clientkey -keyalg RSA -keysize 2048 -validity 7360 -keystore client.keystore  
    keytool -export -alias serverkey -keystore server.keystore -rfc -file server.crt  
    keytool -export -alias clientkey -keystore client.keystore -rfc -file client.crt  
    keytool -import -file server.crt -keystore client.truststore  
    keytool -import -file client.crt -keystore server.truststore  
  4. The following files are generated:
    • client
    • client.keystore
    • client.truststore
    • server
    • server.keystore
    • server.truststore
  5. Copy the server.keystore and server.truststore generated in the SSL directory to the configuration directory in JBoss. E.g. wildfly8.2\standalone\configuration.
  6. Go to the configuration folder and find the standalone-full.xml file. Navigate to the <security-realm name="ApplicationRealm"> , then enter the below given configuration with the server.keystore and server.truststore password in the Keystore-password field as shown below:

    <server-identities>
                        <ssl>
                            <keystore path="server.keystore" relative-to="jboss.server.config.dir" keystore-password="India@123" alias="serverkey" key-password="India@123"/>
                        </ssl>
                    </server-identities>
                    <authentication>
                        <truststore path="server.truststore" relative-to="jboss.server.config.dir" keystore-password="India@123"/>
    					.....
                    </authentication> 

    The section should look something like the screenshot given below:

  7. In the <subsystem xmlns="urn:jboss:domain:remoting:2.0"> section add or edit the following configuration er the following example:

     <http-connector name="https-remoting-connector" connector-ref="default-https" security-realm="ApplicationRealm"/>

    The section should look something like the screenshot given below:

  8. In the <subsystem xmlns="urn:jboss:domain:undertow:1.2"> section add the following configuration:

    <https-listener name="default-https" socket-binding="https" security-realm="ApplicationRealm" verify-client="REQUIRED"/>

    The section should look something like the screenshot given below:

  9. Restart the WildFly service.

The SSL configuration is completed for JBoss server.