Installation Guides › Implementation Guide › Install a SOA Agent or SOA Security Gateway on a UNIX System › Run the Installer to Install a SOA Agent or SOA Security Gateway Using a GUI

Run the Installer to Install a SOA Agent or SOA Security Gateway Using a GUI

You run the respective UNIX installation executable to install a SOA Agent. The installation executables are in the SOA Security Manager kit available on the Technical Support site. They are the following:

• Solaris—ca-soasm-12.1-cr001-sol.bin
• Red Hat Linux—ca-soasm-12.1-cr001-linux.bin

To locate installation kits on the Support site

1. Click Technical Support.
2. Log into CA Support Online.
3. Click Download Center.
4. Search the Download Center for the installation kit you need.

Note: Extract all files and directories in the SOA Security Manager kit to a common location on a local drive and keep them together—the SOA Security Manager installer cannot run without the included supporting files.

If you do not have sufficient rights, add executable permission to the install file by running the following command:

chmod+x ca-soasm-12.1-cr001-os_version.bin

• os_version

  Specifies sol or linux.

Important! If you execute the SOA Security Manager installer across different subnets it can crash. To avoid this problem, install the Policy Server directly on the host system.

To run the SOA Security Manager installer to install a SOA Agent

1. Exit all applications that are running.
2. Open a command window and navigate to where the install program is located.
3. Enter the following command:

   sh./ca-soasm-12.1-cr001-os_version.bin
   

   The SOA Security Manager installation wizard starts.

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.
   • If you cut and paste path information into the wizard, also enter a character before the Next button is enabled.
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 libraries 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. Afterward, the CA SOA Security Manager Configuration screen is displayed.

6. If presented (not presented if installing only a SOA Security Gateway), select one of the following options:
   • 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.

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.

   If you installed a SOA Security Gateway, register the trusted host and configure the gateway using the SOA Security Gateway Management Console. For more information, see the SOA Security Gateway Configuration Guide.

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_r12.1_InstallLog.log
  • soa_home

    Specifies the path to where SOA Security Manager is installed.

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