Configuration Guides › Federation Security Services Guide › Federation Web Services Application Setup › Deploy Federation Web Services as a Web Application › Configure WebSphere to Work with Federation Web Services › Deploy a Federation Web Services WAR File in WebSphere

Deploy a Federation Web Services WAR File in WebSphere

To deploy the FWS WAR file on System 2 and System 5

1. Create a WAR file of the Federation Web Services application. The application is installed in:

   \webagent_option_pack\affwebservices\

   For more information about creating a WAR file, see WebSphere documentation.

2. Deploy the WAR file using WebSphere Administrator Console.

   For more information, see WebSphere documentation.

   Important! If you make subsequent changes to any of the properties files in the affwebservices directory, recreate a WAR file and redeploy this file in the application server.

3. From the WebSphere Administrator Console, go to Applications, Enterprise Applications.
4. Select the name of the web services WAR file, such as affwebservices_war.
5. On the Configuration tab:
   1. Set the Classloader Mode to PARENT_FIRST.
   2. Set WAR Classloader Policy to Application.
   3. Save the settings.
6. Test that the Federation Web Services application is working by opening a web browser and entering:

   http://fqhn:port_number/affwebservices/assertionretriever

   where,

   fqhn

   Defines the fully qualified host name.

   port_number

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

   For example:

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

   If Federation Web Services is operating correctly, the following message appears:

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

   This message indicates that Federation Web Services is listening for data activity. If Federation Web Services is not operating correctly, you get a message that the Assertion Retrieval Service has failed. If the Assertion Retrieval Service fails, verify the Federation Web Services log.

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