Previous Topic: Upgrading CA Configuration Automation SoftwareNext Topic: Upgrading CCA Server on Linux or UNIX

Upgrading CA Configuration Automation Software › Upgrade a CA Configuration Automation Agent on Windows

Upgrade a CA Configuration Automation Agent on Windows

You can only upgrade the CA Configuration Automation Agent software on Microsoft Windows operating systems using the installation wizard.

Upgrade Using the Wizard

To upgrade a CA Configuration Automation Agent on Windows

  1. Log in as administrator or any user with administrative privileges.
  2. Insert the CA Configuration Automation Agent CD-ROM into the drive.
  3. Run the CA Configuration Automation Agent installation program by double-clicking one of the following:

    The CA Configuration Automation Agent installation requires a Java VM. The Java VM does not run during agent operation. Because you may already have a version of a Java VM installed on the target server for the CA Configuration Automation Agent, two different agent installation programs are provided—one installs the Java VM (AgentWindowsVM.exe), and one does not install the Java VM (AgentWindows.exe) and attempts to find and use an existing Java VM.

    Note: The installation program may not be able to locate an existing Java VM if it was not installed in a commonly known location. If the AgentWindows.exe installation fails, use AgentWindowsVM.exe to install the CA Configuration Automation Agent.

    The installation program prepares for installation by unpacking and extracting the necessary files into a temporary work space. This can take several minutes.

    After the install has completed successfully or is canceled, the temporary storage is released.

    The installation wizard displays the Introduction.

  4. Read the Introduction screen and click Next.

    Note: We recommend that you do not cancel an upgrade after you begin because the files already installed to that point are not removed automatically, and partial updates can cause unpredictable results. Proceed only if you intend to complete the upgrade.

    The License Agreement screen appears.

  5. Read the License Agreement, select I accept the terms of the License Agreement, and click Next.

    To upgrade the CA Configuration Automation software, you must accept the license agreement.

    The Important Information screen appears.

  6. Read the copyright and software use information, and click Next.

    The Select Installation Location screen appears.

  7. Enter the path to the location in which your original CA Configuration Automation Agent software resides, press Enter to accept the default, or click Choose to select the location.

    The recommended default location for the initial installation was \Program Files\CA\CCA\Agent.

    Note: You must specify the same location as the original installation to upgrade the software using the installation wizard. If you specify a path different from the existing CA Configuration Automation Agent installation, CA Configuration Automation will not detect the existing software and will create a new, separate installation instead of upgrading.

    Only alphanumeric, underscore (  _  ), blank, and back slash ( \ ) characters are allowed for path names on Windows-based systems (no other embedded special characters). If the directory you specify does not exist, the installation wizard creates it for you.

    CA Configuration Automation detects the previous version of the software installed in the specified location and displays the Installation already present dialog.

  8. Click Continue.

    The installation program checks for adequate installation disk space and displays a preinstallation summary of required and available disk space.

  9. Review the preinstallation summary and click Install.

    The wizard displays the progress as it copies the required files to the target server, then displays the original agent configuration settings required to set up communications with the CCA Server and to create the agent configuration file agent.conf.

    Note: Unlike the CCA Server upgrade, you can edit the existing CA Configuration Automation Agent configuration settings during the upgrade. The installer displays the original settings as defaults.

  10. Edit the following CA Configuration Automation Agent configuration settings as appropriate:
    CA Configuration Automation Agent Port Number

    Specifies the CA Configuration Automation Agent listening port number.

    Agent Bind IP Address

    Specifies the IP address of the machine that the CCA agent binds to after the agent installation is complete.

    The option lists the available IP addresses, and excludes the following IP addresses:

    • IPv4 loopback address. For example, 127.0.0.1
    • IPv6 loopback address. For example, ::1 or 0:0:0:0:0:0:0:1
    • IPv6 link local address. For example, starting with fe80::

    Note: If a valid IP address is not found, a warning message is displayed and the CCA agent binds to the loopback IP address.

    Enable Agent Logging

    Specifies whether to enable agent logging. You may not want to enable logging if your environment discourages writing log files to machines for space conservation and security reasons.

    You can also enable or disable agent logging at any time in the agent configuration file, agent.conf.

    Enable Server Ping

    Specifies whether to enable server ping. You may not want to enable server ping if any of the following apply:

    • You encounter IP address and name resolution conflicts.
    • The server has multiple Network Interface Cards (NICs) (ensures identification with the intended NIC).
    • Agents are installed on servers that have a firewall between those servers and the CCA Server (reduces unnecessary network traffic caused by the agents trying to ping an unreachable address).

    You can also enable or disable server ping at any time in the agent configuration file, agent.conf.

    CCA Server Name

    Specifies the default server name, or you can provide the server name of the CCA Server.

    CCA Server Port Number

    Specifies the default port number, or you can enter the CCA Server listening port number.

    The wizard confirms that the CA Configuration Automation Agent upgrade was successful.

  11. Click Done to close the CA Configuration Automation Agent installation wizard.