Previous Topic: Deploying and Configuring SAML Sample ApplicationsNext Topic: Verifying the Sample Application Deployment


Deploying the Sample Application WAR Files

The Adapter installation package includes the following SAML sample applications:

Using these modules, you can test the authentication workflows available in the SAML integration. To deploy sample application:

  1. Navigate to the following location:
    saml_sample_app_installation_dir\sampleApplications
    
  2. Copy the samlsampleapp.war, bankapp.war, and insuranceapp.war files to your application server. For example on Apache Tomcat, the location to copy the WAR file is:
    application_server_home\webapps
    

    Apache Tomcat automatically deploys the WAR files and creates the following folders under the webapps folder:

    Note: Refer to the vendor documentation for deployment instructions on other supported application servers.

  3. (Applicable Only for JDK 1.5 on Apache Tomcat) Perform the following steps to deploy the JAR files on an Apache Tomcat installation that is using JDK 1.5:
    1. Browse to the location where the Adapter installer file is unzipped.
    2. Copy the JAR files from the endorsed folder to the location configured for the -Djava.endorsed.dirs system property.
    3. Restart the application server for the changes to take effect.
  4. (Applicable Only for IBM WebSphere 6.1) Perform the following steps to deploy WAR file on WebSphere 6.1:
    1. Log in to the IBM WebSphere administration console.
    2. Navigate to Applications -> Install New Application.
    3. In the How do you want to install the application section, select the Show me all installation options and parameters option.
    4. Click Next.
    5. Click Next on the Preparing for the application installation screen.
    6. Click Continue on the Application Security Warnings screen.
    7. In the Step 1: Select install options screen, select the Precompile JavaServer Pages files option.
    8. Click Next.
    9. Click Next on the Step 2: Map modules to servers screen.
    10. In the Step 3: Provide options to compile JSPs screen, enter the value 15 in JDK Source level column.
    11. Follow the on-screen instructions and complete the deployment.
  5. (Applicable Only for IBM WebSphere 6.1) Perform the following steps after you deploy the WAR file:
    1. Log in to the IBM WebSphere administration console.
    2. Navigate to Applications -> Enterprise Applications -> WebSphere enterprise applications.
    3. Click the WAR file link.
    4. Click the Class loading and update detection link.
    5. In the Class loader order section, select the Classes loaded with local class loader first option.
    6. In the WAR class loader policy section, select the Single class loader for application option.
    7. Restart IBM WebSphere.
  6. (Applicable Only for IBM WebSphere 7.0) Perform the following steps after you deploy the WAR file:
    1. Log in to the IBM WebSphere administration console.
    2. Navigate to Applications -> Enterprise Applications -> WebSphere enterprise applications.
    3. Click the WAR file link.
    4. Click the Class loading and update detection link.
    5. In the Class loader order section, select the Classes loaded with local class loader first (parent last) option.
    6. In the WAR class loader policy section, select the Single class loader for application option.
    7. Restart IBM WebSphere.
  7. (Applicable only for Oracle WebLogic) Perform the following steps:
    1. Stop the WebLogic Server.
    2. Create a directory named endorsed, if it does not already exist, in the <JAVA_HOME>\jre\lib directory.
    3. If there is an existing <JAVA_HOME>\jre\lib\endorsed directory, take a backup of the following JAR files and then delete them from the <JAVA_HOME>\jre\lib\endorsed directory:
      • resolver
      • serializer
      • xalan
      • xercesImpl
      • xml-apis
    4. Copy the JAR files that are available in the endorsed directory of the Adapter package to the <JAVA_HOME>\jre\lib\endorsed directory.
    5. Start the WebLogic server.
  8. (Applicable Only for JBoss 5.1) Perform the following steps:
    1. Stop the JBoss application server.
    2. Navigate to the following location:
      <JBOSS_Install_Home>\lib \endorsed
      
    3. If the following files are present in the <JBOSS_HOME>\lib \endorsed directory, take a backup of the files and then delete them from <JBOSS_HOME>\lib \endorsed.
      • resolver
      • serializer
      • xalan
      • xercesImpl
      • xml-apis
    4. Copy the JAR files available in the endorsed directory of the Adapter package to the following location:
      <JBOSS_HOME>\lib\endorsed
      
    5. Start the JBoss application server.