Previous Topic: Installation Prerequisites for the Federation Agent for WindowsNext Topic: Configure the Federation Agent for Windows Authentication


Install the Federation Agent for Windows Authentication

Installation Requirements

Consider the following installation requirements:

Important! If you upgrade CA SiteMinder® Federation Standalone to the current version, upgrade the Agent to the same version. Otherwise, the Agent fails to work properly.

Installation Executables

The following table identifies the installation executables for the Federation Agent.

Note: The installation executable and folder names include the string iwa, which references support for Integrated Windows Authentication technology.

Platform

Installation Executable

Solaris

ca-fedmgr-iwa-version-sol.bin

Linux

ca-fedmgr-iwa-version-rhel30.bin

Windows

ca-fedmgr-iwa-version-win32.exe

For more information about supported operating systems, see the product Platform Support Matrix on the Technical Support site.

Install the Federation Agent (Windows)

Run the installer.

To locate installation kits

  1. Go to the Technical Support site.
  2. Log on to the site.
  3. Click Download Center.
  4. Search the Download Center for the installation kit, and download it to your local system.

To install the Agent on Windows

  1. Exit all applications that are running.
  2. Navigate to where the installation executable is located.
  3. Run the installation executable for your operating platform.

    View a list of executables here.

    The installation wizard starts.

  4. Follow the prompts in the installation wizard.

    The Windows Agent is installed your system.

  5. After the installation is complete, run the configuration wizard.

Install the Federation Agent (UNIX)

Run the installer.

To locate installation kits

  1. Go to the Technical Support site.
  2. Log on to the site.
  3. Click Download Center.
  4. Search the Download Center for the installation kit, and download it to your local system.

To install the Agent on a UNIX system

  1. Exit all applications that are running.
  2. Navigate to where the installation executable is located.
  3. Run the installation executable for your operating platform.

    View a list of executables here.

    The installation wizard starts.

  4. Follow the prompts in the installation wizard.

    The Windows Agent is installed on your system.

  5. After the installation is complete, run the configuration wizard.

Unattended Installation of the Federation Agent

After the Federation Agent has been manually installed, you can install it on the same system, or a different system, using the unattended installation mode. An unattended installation does not require any user intervention. It relies on an installation properties file that can be modified to suit your requirements.

The unattended installation process is the same on any platform. Only the executable file names differ.

Follow these steps:

  1. Navigate to the directory where the installation executable is located.
  2. Enter the following command at a command prompt:
    installation_executable -i silent -f ca-fedmanager-iwa-installer.properties
    
    -f

    Specifies the name of the Windows Agent installer properties file. If the properties file is not in the same directory as the installation executable file, specify the relative path to the properties file.

    -i

    Specifies the installation mode.

    The installation executes and writes the settings in the properties file.

The unattended installation is complete.

Uninstall the Federation Agent (Windows)

Remove the Federation Agent from your Windows system when you no longer require it.

Follow these steps:

  1. Select Start, All Programs, CA, Federation Standalone, Uninstall CA SiteMinder® Federation Standalone Windows Authentication Agent.

    The wizard starts up.

  2. Follow the instructions in the wizard.
  3. Navigate to the Program Files\CA\Federation Standalone\connector directory and delete any IWA folders and subfolders, if necessary.
  4. Reboot the system.

The Federation Agent for Windows Authentication is removed from your system.

Uninstall the Federation Agent (UNIX)

Remove the Windows Agent from your UNIX system when you no longer require it.

Follow these steps:

  1. Open a command window.
  2. Navigate to the Federation Agent for Windows Authentication home directory.
  3. Enter the following command:

    ./ca-federation-iwa-uninstall.sh

  4. Delete any remaining folders and all subfolders, as required.

The Federation Agent is removed from the system.

Upgrade the Federation Agent to 12.52 SP1

The installation program can also upgrade your version of the Federation Agent for Windows Authentication. Remember to install the Federation Agent on a system where CA SiteMinder® Federation Standalone is already installed.

Important! The Federation Agent must be the same version as CA SiteMinder® Federation Standalone. If you upgrade the federation system, upgrade the Agent. Otherwise, the Agent fails to work properly.

Follow these steps:

  1. Confirm that the main federation system is the same version as that of the Agent you plan to upgrade. If not, first upgrade CA SiteMinder® Federation Standalone.
  2. Run the Windows Agent installation executable for your operating platform.

    No further configuration required.

  3. Run the configuration wizard.