Previous Topic: Deploying State ManagerNext Topic: Next Steps

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

Deploying and Configuring Authentication Flow Manager

This chapter lists the tasks that you must perform to deploy and configure Authentication Flow Manager (AFM). It covers the following topics:

Important! Before deploying and configuring AFM, ensure that AuthMinder is installed, configured, and running.

Deploy 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 7.0, 8.0 or 8.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.