Federation Security Services Guide › Federation Web Services Application Setup › Deploy Federation Web Services as a Web Application › Configure JBOSS or Tomcat to Work with Federation Web Services › Deploy an FWS WAR File in JBoss or Tomcat

Deploy an FWS WAR File in JBoss or Tomcat

To deploy the FWS application for a JBOSS or Tomcat server

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

   /webagent_option_pack/affwebservices/.

2. Create a WAR file by entering the command:

   jar cvf affwebservices.war *

   For 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.

   • Tomcat

     Tomcat_home/server/default/deploy/

   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 supported by affwebservices are displayed on the main Console page.
6. Test that the FWS application is working by opening a web browser and entering the following:

   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.

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

   Note: For instructions on enabling trace logging for the FWS application, see Federation Security Services Trace Logging.