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

CA Adapter UNIX Installation Guide › Deploying the Sample Application WAR Files

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. To set the $AFM_HOME environment variable on the system, run the afmenv.sh script. This script is located in the adapter-install-location directory.
  3. 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. Bear in mind that you must set the $AFM_HOME environment variable before you restart the application server.

  1. (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. To set the $AFM_HOME environment variable on the system, run the afmenv.sh script from the adapter-install-location directory.
    4. Restart the application server for the changes to take effect.
  2. (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.
  3. (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. To set the $AFM_HOME environment variable on the system, run the afmenv.sh script from the adapter-install-location directory.
    8. Restart IBM WebSphere.
  4. (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. To set the $AFM_HOME environment variable on the system, run the afmenv.sh script from the adapter-install-location directory.
    8. Restart IBM WebSphere.
  5. (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. To set the $AFM_HOME environment variable on the system, run the afmenv.sh script from the adapter-install-location directory.
    6. Start the WebLogic server.
  6. (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.
    1. Copy the JAR files available in the endorsed directory of the Adapter package to the following location:

      JBOSS_HOME/lib/endorsed

    2. To set the $AFM_HOME environment variable on the system, run the afmenv.sh script from the adapter-install-location directory.
    3. Start the JBoss application server.