Installation and Upgrade Guides › Agent for IIS Installation Guide › Upgrade a Web Agent to 12.52 › How to Prepare for a CA SiteMinder® Agent Upgrade

How to Prepare for a CA SiteMinder® Agent Upgrade

Upgrading a CA SiteMinder® agent involves several separate procedures. To prepare for an upgrade of your agent, follow these steps:

1. Create backup copies of any customized CA SiteMinder® files on your web server. Examples of files you could have customized after installing or configuring your agent include the following files:
   • LocalConfig.conf
   • WebAgent.conf
2. Record the values of the following logging parameters in the agent configuration object of the agent that you want to upgrade:
   • LogFileName
   • TraceFileName
   • TraceConfigFile
3. Gather information for the following CA SiteMinder® programs.
   • The Agent installation wizard.
   • (only If upgrading from version 12.0.2 or older) The Agent configuration wizard.
4. Do one of the following tasks:
   • If you are upgrading from version 12.0.3 or higher to 12.52, go to Step 5.
   • If you are upgrading from version 12.0.2 or older, continue with this procedure instead.
5. Run the installation wizard to upgrade your Agent for IIS.
6. Add the logging parameter values (from Step 2) to your agent configuration object.

Source the Environment Script on UNIX and Linux Operating Environments

If you are upgrading a Web Agent on a UNIX or Linux system, source the environment script that is available in the following directory:

CA SiteMinder® 6.0

web_agent_home/nete_wa_env.sh 

CA SiteMinder® 12.0 and later

web_agent_home/ca_wa_env.sh

web_agent_home

Indicates the directory where the CA SiteMinder® Agent is installed.

Default: /opt/ca/webagent

Run the Installation Wizard to Upgrade your Agent for IIS

The installation program for the CA SiteMinder® agent installs the agent on one computer at a time using the Windows operating environment. This installation program can be run in wizard or console modes. The wizard and console-based installation programs also create a .properties file for subsequent installations and configurations using the unattended or silent method with the same settings.

For example, suppose the Agents in your environment use the same web server version, installation directory, Agent Configuration Object and Policy Servers. Use the installation wizard or console-based installation program for your first installation. Afterwards, you could create your own script to run the installation program with the .properties file the wizard or console-based installation program created.

Follow these steps:

1. Copy the CA SiteMinder® Web Agent installation executable file to a temporary directory on your web server.
2. Do one of the following steps:
   • For wizard-based installations, right-click the installation executable file, and then select Run as Administrator.
   • For console-based installations, open a command line window and run the executable as shown in the following example:

     executable_file_name.exe -i console
     

3. Use the information that you gathered previously to complete the installation.

More information:

Multiple Agent for IIS Directory Structures According to Operating Environment

More information:

Set Up and Enable Error Logging

Configure Trace Logging

Add the logging parameter values to your agent configuration object

Occasionally, certain logging parameters are not copied correctly to the new version during an Agent for IIS upgrade. Complete the upgrade by adding the values of the logging parameters from the old version to the agent configuration object.

Update the values of the following parameters:

LogFileName

Specifies the full path (including the file name) of the log file.

Default: No

Example: (Windows) web_agent_home\log\WebAgent.log

Example: (UNIX/LInux) /export/iPlanet/servers/https-jsmith/logs/WebAgent.log

TraceFileName

Specifies the full path to the trace log file.

Default: No default

Limits: Specify the file name in this parameter.
Example: web_agent_home\log\trace.log

TraceConfigFile

Specifies the location of the WebAgentTrace.conf configuration file that determines which components and events to monitor.

Default: No default

Example: web_agent_home\config\WebAgentTrace.conf