Configuration Guides › SOA Agent for Web Servers Guide › Install the SOA Agent for Web Servers on a Windows System › Run the Installer to Install a SOA Agent

Run the Installer to Install a SOA Agent

Install the SOA Agent using the SOA Security Manager installation media on the Technical Support site.

Note: For a list of installation media names for each operating system, see the installation and upgrade considerations in the Release Notes.

To install a SOA Agent on Windows

1. Exit all applications that are running.
2. Navigate to the installation material.
3. Double-click installation_media.

   installation_media

   Specifies the name of the SOA Security Manager installation executable.

   The SOA Security Manager installation wizard starts.

   Important! If you are running this wizard on Windows Server 2008, run the executable file with Administrator permissions, even if you are logged into the system as an Administrator. For more information, see the Release Notes.

4. Use gathered system and component information to install the SOA Agent. Consider the following when running the installer:
   • When prompted to select features to install, select CA SOA Security Manager Agents and then specify the Agent type or types you require.
   • When prompted to select the Java version, the installer lists all Java executables present on the system. Select a supported 32-bit Java Runtime Environment (refer to the Platform Support Matrix on the Technical Support site).
   • If you enter path information in the wizard by cutting and pasting, enter (and delete, if necessary) at least one character to enable the Next button.
5. Review the information presented on the Pre-Installation Summary page, then click Install.

   Note: If the installation program detects that newer versions of certain system DLLs are installed on your system it asks if you want to overwrite these newer files with older files. Select No To All if you see this message.

   The SOA Agent files are copied to the specified location.

6. On the SOA Security Manager Configuration screen, click one of the following options and click Next:
   • Yes. I would like to configure SOA Security Manager Agents now.
   • No. I will configure SOA Security Manager Agents later.

   If the installation program detects that there are locked Agent files, it prompts you to restart your system instead of reconfiguring it. Select whether to restart the system automatically or later on your own.

   Important! For SOA Agents for Web Servers installed on IIS servers, reboot your system after installation; it is not sufficient to restart the IIS service. Also, do not configure the Agent immediately after installation; there are some tasks you must do before configuring the Agent.

7. Click Done.

   If you selected the option to configure SOA Agents now, the installation program prepares the CA SOA Security Manager Configuration Wizard and begins the trusted host registration and configuration process.

   If you installed a SOA Agent or Agents and did not select the option to configure SOA Agents now or if you are required to reboot the system after installation you must start the configuration wizard manually later.

Installation Notes:

• After installation, you can review the installation log file in SOA_HOME\install_config_info. The file name is: CA_SOA_Security_Manager_version_InstallLog.log

  soa_home

  Specifies the path to where SOA Security Manager is installed.

  Default: C:\Program Files\CA\SOA Security Manager

• The Agent cannot communicate properly with the Policy Server until the trusted host is registered.

More information:

How to Configure Agents and Register a System as a Trusted Host

Copy cryptojFIPS.jar to the WebSphere JRE