Web Agent Guides › Web Agent Option Pack Guide › Deploy Federation Web Services for Federation › Deploy Federation Web Services as a Web Application › Set Up JBOSS or Tomcat to Work with Federation Web Services › Prerequisites to Deploy an FWS WAR File in JBoss Server › Create a module.xml File

Create a module.xml File

To deploy the war file, create a directory in the JBoss container, associate the jars files, and create a module.xml file that describes the jar files.

Follow these steps:

1. Create a directory structure as follows under the <JBOSS-_HOME>\modules location:

   com\rsa\cryptoj\main
   

2. Copy the cryptoj.jar, certj.jar, and sslj.jar files from the following location:

   <NETE_WA_ROOT>\affwebservices\WEB-INF\lib\ 
   

   to

   <JBOSS-HOME>\modules\com\rsa\cryptoj\main\
   

3. Create a module.xml file in the following location:

   <JBOSS-HOME>\modules\com\rsa\cryptoj\main
   

4. Add the following to the xml file:

   <?xml version="1.0" encoding="UTF-8"?>
   <module xmlns="urn:jboss:module:1.0" name="com.rsa.cryptoj">
   	<resources>
   		<resource-root path="cryptoj.jar"/>
   		<resource-root path="certj.jar"/>
   		<resource-root path="sslj.jar"/>
   	</resources>
   	<dependencies>
   		<module name="sun.jdk"/>
   		<module name="javax.api"/>
   	</dependencies>
   </module>
   

5. Restart the JBoss server.

You can deploy the affwebservices war file in the JBoss server.

Deploy an FWS WAR File in JBoss or Tomcat

Follow these steps:

1. Open a command window and navigate to the affwebservices directory, which is located in:

    /webagent_option_pack/affwebservices/.
   

2. Create a WAR file by entering the command:

   jar cvf affwebservices.war *
   

   For more information about deploying a Web application, see the documentation for your application server.

3. Copy the affwebservices.war file to the appropriate server location:

   JBOSS

   JBOSS_home/server/default/deploy/

   JBOSS_home is the installed location of the JBOSS application server.

   Note: For JBoss EAP 6.1, use the admin console to deploy the affwebservices.war file.

   Important! For JBOSS, deploy affwebservices in an exploded state. Refer to
   https://access.redhat.com/knowledge/solutions/34813.

   Tomcat

   Tomcat_home/webapps

   Tomcat_home is the installed location of the Tomcat application server.

4. Restart the application server.
5. After the server has restarted, access the JBOSS or Tomcat Administrative Console. All the services that affwebservices supports appear on the main Console page.
6. Test that the FWS application is working by opening a web browser and entering the following URL:

   http://fqhn:port_number/affwebservices/assertionretriever

   fqhn

   Represents the fully qualified host name and

   port_number

   Specifies the port number of the server where the Federation Web Services application is installed.

   For example:

   http://myhost.ca.com:81/affwebservices/assertionretriever

   If FWS is operating correctly, the following message is displayed:

   Assertion Retrieval Service has been successfully initialized.
   The requested servlet accepts only HTTP POST requests.
   

   This message indicates that FWS is listening for data activity. The FWS application is now deployed for the application server.

   When FWS is not operating correctly, a message states that the Assertion Retrieval Service has failed. If there is a failure, review the FWS log.

   Note: For more information about enabling trace logging for the FWS application, see Trace Logging.