Previous Topic: Deploying and Configuring Authentication Flow ManagerNext Topic: Next Steps

CA Adapter UNIX Installation Guide › Deploying and Configuring Authentication Flow Manager › Deploying Authentication Flow Manager

Deploying Authentication Flow Manager

You need the arcotafm.war file to deploy AFM. This file is available at the following location:

afm_installation_dir/adapterAFM/

To deploy the AFM application, install the arcotafm.war file on your application server. 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.

For example, on Apache Tomcat, the location to install the WAR file is:

application_server_home/webapps

Apache Tomcat extracts the WAR file and creates a folder named arcotafm 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.

Depending on the application server that you are using, perform the additional steps described in one of the following sections:

Applicable Only for JDK 1.5 on Apache Tomcat

Important! The additional configurations given in this section are required only when you are integrating Adapter with SAML-based web portal.

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.

Applicable Only for IBM WebSphere 6.1

Perform the following steps to deploy the WAR file on WebSphere 6.1:

  1. Log in to the IBM WebSphere administration console.
  2. Navigate to Applications > Install New Application.
  3. Based on the location of the WAR file, select either Local file system or Remote file system.
  4. In the Full path field, enter the absolute path of the WAR file or click Browse to select the WAR file location.
  5. Specify arcotsm as the context root.
  6. In the How do you want to install the application section, select the Show me all installation options and parameters option.
  7. Click Next.
  8. Click Next on the Preparing for the application installation screen.
  9. Click Continue on the Application Security Warnings screen.
  10. In the Step 1: Select install options screen, select the Precompile JavaServer Pages files option.
  11. Click Next.
  12. Click Next on the Step 2: Map modules to servers screen.
  13. In the Step 3: Provide options to compile JSPs screen, enter the value 15 in JDK Source level column.
  14. Follow the onscreen instructions and complete the deployment.

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. Use the admin console of the application server to start AFM and then State Manager.

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 > Application Types > 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. Use the admin console of the application server to start AFM and then State Manager.

Applicable Only for Oracle WebLogic

Important! The additional configurations given in this section are required only when you are integrating Adapter with SAML-based web portal.

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

Applicable Only for JBoss 5.1

Important! The additional configurations given in this section are required only when you are integrating Adapter with SAML-based web portal.

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.
  4. Copy the JAR files available in the endorsed directory of the Adapter package to the following location:

    JBOSS_HOME/lib/endorsed

  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 JBoss application server.