Upgrade an r12.1 SOA Agent Using a UNIX Console

The SOA Security Manager installer can upgrade existing SOA Agents to r12.1 SP3.

Consider the following:

If you have upgraded the web server associated with a SOA Agent for Web Servers since you last installed the SOA Agent, the Agent upgrade may not work. The upgrade is ensured only if the web server version has remained the same since the last SOA Agent installation. However, you can upgrade if you have applied a hotfix.
If the installation program detects any locked Agent files, it prompts you to restart your system instead of reconfiguring it. Select whether to restart the system immediately or later.
If you are upgrading an Agent on an Sun Java System web server, you may see an error message stating that the httpd.exe service is unable to locate the smconapi.dll. If this message appears, reboot your system before launching the SOA Agent Configuration Wizard.

To upgrade the SOA Agent

Exit all applications that are running.
Open a shell and navigate to the installation executable.
Enter the following command:
```
sh ./installation_media -i
```
installation_media

Specifies the SOA Security Manager installation executable.

The SOA Security Manager installation wizard starts.

Note: For a list of installation media names for each operating system, see the installation and upgrade considerations in the Release Notes.
Proceed through the wizard to upgrade 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 SOA Agent types you want to upgrade.
- When the wizard prompts you to confirm the upgrade, select one of the following options:
  - Continue with the upgrade—upgrades the SOA Agent to r12.1 SP3.
  - Abort the upgrade—exits the upgrade procedure without upgrading the SOA Agent.
- If the installation program detect that newer versions of certain system .dlls are installed on your system and prompts you to overwrite these newer files with older files, select the No To All option.
The new SOA Agent files are copied to the specified location.
Choose whether to restart your system immediately or later.
Re-configure the upgraded SOA agent with the SOA Security Manager Configuration Wizard.
Note: You do not need to re-register your trusted host.

More information: