Installation Guides › Upgrade Guide › Upgrading from r12 › How to Migrate from r12.0 › Upgrade r12.0 SOA Agents and SOA Security Gateways › Upgrade a SOA Security Gateway to r12.1 on UNIX › Run the Installer to Install the r12.1 SOA Security Gateway on UNIX

Run the Installer to Install the r12.1 SOA Security Gateway on UNIX

You run the respective UNIX installation executable to install the r12.1 SOA Security Gateway software. 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 Security Gateway

1. Stop all r12.0 SOA Security Gateway components and any other applications that are running.
2. Open a command window and navigate to where the install program is located.
3. Enter one of the following commands:

   GUI mode: sh./ca-soasm-12.1-cr001-os_version.bin

   Console mode: sh./ca-soasm-12.1-cr001-os_version.bin -i

   The SOA Security Manager installation wizard starts.

4. Use gathered system and component information to install the SOA Security Gateway.Consider the following when running the installer:
   • When prompted to select features to install, select CA SOA Security Manager Agents and then specify the SOA Security Gateway as the agent type you require.
   • (GUI mode) If you cut and paste path information into the wizard, you must also enter a character before the Next button is enabled.
5. Review the information on the Pre-Installation Summary page, then proceed.

   Note: The installation program may detect 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 Security Gateway r12.1 files are copied to the installed location of the r12.0 SOA Security Gateway. The original directories for each installed component are renamed with a ".backup" extension such that the installation directories for the three r12 SOA Security Gateway become SOASecurityGateway.backup, SOASecurityGatewayCM.backup, and SOASecurityGatewayMMC.backup, respectively.

6. Re-configure the upgraded SOA Security Gateway with the SOA Security Manager Configuration Wizard.

   Note: You do not need to re-register your trusted host.

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.