Upgrading CA Configuration Automation Software

Upgrading CA Configuration Automation Software

This chapter describes how to upgrade the CA Configuration Automation Server, CA Configuration Automation Agent, and CCA Grid Node software.

Before you upgrade the CA Configuration Automation software, refer to the following documents:

• CA Configuration Automation Readme for release-specific information
• System Requirements section of this document for current system requirements and supported environments

Before upgrade the CA Configuration Automation software, upgrade or migrate CA EEM.

For more information about how to upgrade or migrate CA EEM, see the CA EEM documentation.

If you migrate CA EEM to a different server, update the following EEM group properties with the new CA EEM server:

• eventdeliveryhost
• host

You can update the properties in the Configuration tab under the Administrator panel.

Note: CA Configuration Automation software downgrades (installing an earlier version of CA Configuration Automation over a more recent version) are not supported. If you want to install an earlier version of the software, uninstall and reinstall the software.

This section contains the following topics:

Upgrade Overview

Upgrading CCA Server on Windows

Upgrade a CA Configuration Automation Agent on Windows

Upgrading CCA Server on Linux or UNIX

Upgrading a CA Configuration Automation Agent on Linux or UNIX

Upgrading CCA Grid Node on Windows

Upgrading CCA Grid Node on Linux or UNIX

Upgrade Overview

Software upgrades are performed using the same installation program or wizard you use to install the CA Configuration Automation software on a server for the first time.

After you specify the installation location, CA Configuration Automation checks there for existing installations of CA Configuration Automation Server and CA Configuration Automation Agent, uses the configuration settings in your existing configuration files (cca.properties and agent.conf), and upgrades the software to the current version.

It is important to know what happens to the following files during an upgrade:

cca.properties

The upgrade installer makes a copy of the cca.properties configuration file each time the server software is upgraded so you can track previous CA Configuration Automation configurations. Each copy of the file is timestamped (cca.properties.<time_stamp>).

If you used the recommended default location to install CCA Server, these configuration files are located in the following directories:

• (Linux and UNIX) /opt/CA/CCAServer/tomcat/conf
• (Windows) \Program Files\CA\CCA Server\tomcat\conf

The upgrade installer creates a new cca.properties file in which to store new configuration parameters and attempts to retain and merge the parameter values in your existing cca.properties file.

Note: It is always a good business practice to make a manual copy of a critical configuration file like this before any software upgrade, particularly if you have made extensive modifications to the file.

Finally, the upgrade installer creates an additional backup copy of the newly created configuration file, cca.properties.bk, which is located in the same directory as all of the other cca.properties files. If the upgrade installer cannot locate an existing cca.properties, it tries to find and use this backup file during upgrades. Note that this backup file is simply a static copy of the cca.properties file at the time of creation and does not contain any changes you make to the original cca.properties file after it is created.

LICENSE

The upgrade installer overwrites your existing LICENSE file. The new license allows CCA to manage an unlimited number of servers and enables remediation.

If you use the default location to install CCA Server, the license file is located in one of the following directories:

• (Linux and UNIX) /opt/CA/CCAServer
• (Windows) \Program Files\CA\CCA Server

CCA Server.lax

If you originally installed CCA Server as a Windows service, an upgrade retains only certain CCA Server.lax property file entries.

If you used the default installation directory, the CCA Server.lax file is located in \Program Files\CA\CCA Server.

To account for possible changes to location, security, heap size, and other environment properties, the upgrade retains the values for the following entries:

• java.security.auth.policy
• java.security.policy
• lax.class.path
• lax.command.line.args
• lax.dir
• lax.nl.java.option.additional
• lax.nl.java.option.java.heap.size.initial
• lax.nl.java.option.java.heap.size.max
• lax.nl.valid.vm.list
• lax.nl.win32.microsoftvm.min.version
• lax.root.install.dir
• lax.stderr.redirect
• lax.stdin.redirect
• lax.stdout.redirect
• org.apache.tomcat.apps.classpath
• tomcat.home

The upgrade adds any new properties and uses the installation defaults for the following internally used entries:

• lax.service .name
• lax.main.class
• lax.main.method
• lax.nl.current.vm
• lax.nl.java.launcher.main.class
• lax.nl.java.launcher.main.method
• lax.user.dir
• lax.version

server.xml

A new server.xml file is created during each upgrade of the CCA Server. The upgrade installer does not make or retain a copy of the file.

If you used the recommended default location to install CCA Server, the server.xml files are located in the following directories:

• (Linux and UNIX) /opt/CA/CCAServer/tomcat/conf
• (Windows) \Program Files\CA\CCA Server\tomcat\conf

If you have made any modifications to the server.xml file after installation, manually make a copy of the file before the upgrade. After the upgrade is complete, reapply the modifications to the newly installed file.

Note: If you secured access to the CCA Server user interface using HTTPS, the server.xml file was modified after installation.

agent.conf

The upgrade makes a copy of the CA Configuration Automation Agent configuration file, agent.conf, each time the agent software is upgraded. Each copy of the file is timestamped (agent.conf.<time_stamp>).

If you used the recommended default location to install the CA Configuration Automation Agent, these configuration files are located in the following directories:

• (Linux and UNIX) /opt/CA/CCAAgent
• (Windows) \Program Files\CA\CA Configuration Automation Agent

The upgrade installer creates a new agent.conf file to bring in new configuration parameters and attempts to retain and merge the parameter values in your existing agent.conf file.

Note: It is always a good business practice to make a manual copy of any critical configuration file before any software upgrade, particularly if you have made extensive modifications to the file.

Finally, the upgrade installer creates an additional backup copy of the newly created configuration file, agent.conf.bk, which is located in the same directory as all of the other agent.conf files. If the upgrade installer cannot locate an existing agent.conf, it tries to find and use this backup file during upgrades. This backup file is a static copy of the agent.conf file at the time of creation and does not contain any changes made to the original agent.conf file after it is created.

Upgrading CCA Server on Windows

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

Upgrade Using the Wizard

To upgrade CA Configuration Automation Server on Windows using the wizard

1. Log in as administrator or any user with administrative privileges.
2. Double-click installCCAServer.exe in the \server\windows folder.

   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 installation has completed successfully or is canceled, the temporary storage is released.

   The wizard starts and displays the Introduction.

3. 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 CCA Database updates can cause unpredictable results. Proceed only if you intend to complete the upgrade.

   The License Agreement screen appears.

4. 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.

5. Read the copyright and software use information and click Next.

   The Select Installation Location screen appears.

6. Enter the path to the location in which your original CCA Server software resides, press Enter to use the default, or click Choose to select the location. The recommended default location for the initial installation was \Program Files\CA\CCA\Server.

   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 CCA Server installation, CA Configuration Automation does not detect the existing software and creates a new, separate installation instead of upgrading.

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

7. Click Continue to proceed with the upgrade.

   The Java Virtual Machine screen appears.

8. Do one of the following:
   • Select Use CA Java VM and click Next to install the customized Java VM.
   • Select Select my own Java VM, specify the location of the Java VM to use, and click Next.

   Note: The installation program recommends that you install the supplied Java VM version because it uses domestic encryption, which is the more powerful encryption available for data stored in the CCA Database. If you want to use an existing installed Java VM, ensure that the version is 1.5.0_03 or later.

   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.

   You are prompted to register the CCA Server as a Windows service. The advantages to setting up CCA Server as a Window service include the following:

   • CCA Server starts automatically whenever Windows is restarted
   • You can control CCA Server start and stop operations through Administrative Tools, Services

   Note: If you install multiple CCA Servers in different directories on a Windows server, only one of the server installations can run as a Windows service. For more information, see Single CCA Server Service per Windows Server.

   If you do not install CCA Server as a Windows service, a console window starts and must remain open while CCA Server is running. You can minimize this window, but you cannot close it.

10. Click Yes or No to specify whether to set up CCA Server as a service.

    Note: Ensure that the Windows Services Administrative Tool is not open, or the CCA Server will not register as a Windows service.

    The wizard displays the installation progress as it copies the required files to the target server and informs you when it is finished.

11. Click Next.

    The CCA Server Configuration Information screen appears with the configuration settings specified in the original installation.

12. Review the CCA Server configuration settings and click Next.

    Note: You cannot edit the existing CCA Server settings if you use the installation wizard to upgrade the software. If you want to change any of the configuration fields, you must uninstall and reinstall the software.

    CCA Server configuration settings follow:

    CCA Server Name

    Specifies the CCA Server name, which is by default the name of the server on which you are installing the software.

    Administrator email Address

    Specifies the CA Configuration Automation administrator's email address.

    CCA Port Number

    Specifies the CCA Server listening port number.

    AJP Port Number

    Specifies the Apache Jakarta Project (AJP) connector port number.

    Mail Server Name

    Specifies the name of your mail server.

    The Database Configuration screen appears after you click Next.

13. Read the database configuration notes about upgrading the software, and click Next.

    The Database Type screen appears with the database type selected in the original installation.

14. Review the database type selection and click Next.

    The CCA Database Instance Configuration screen appears.

15. Review the CCA Database configuration settings specified in the original installation, and click Done.

    Note: You cannot edit the existing CCA Database settings if you use the installation wizard to upgrade the software. If you want to change any of the configuration fields, you must uninstall and reinstall the software.

    CCA Database configuration settings follow:

    CCA User

    Specifies the user name authorized to create or load the CCA Database.

    CCA User Password

    Specifies the hidden password for the CCA Database user specified in the previous field.

    Oracle SID

    (Oracle only) Specifies the Oracle database System Identifier (instance name) if you are using Oracle for the CCA Database.

    CCA Database Instance Name

    (Microsoft SQL Server only) Specifies the database instance name.

    Server Name

    Specifies the name of the server where the CCA Database resides.

    Port Number

    Specifies the database listening port number.

    The wizard completes the software updates and creates a new CCA Server configuration file cca.properties. (For more information, see CCA Server Configuration File.)

    The wizard prompts you to start the CCA Server.

16. Click Yes to start the CCA Server.

    The wizard confirms that the CCA Server upgrade was successful.

17. Click Done to close the CCA Server installation wizard.

    Note: Although earlier releases of agent software are compatible with the CCA Server software, we recommend that you upgrade the CA Configuration Automation Agent on the CCA Server host system as described in Upgrading a CA Configuration Automation Agent on Windows.

18. Clear the browser cache to ensure that the CA Configuration Automation user interface appears correctly:
    1. Launch your browser.
    2. Select Internet Options on the Tools icon menu.

       The Internet Options dialog opens.

    3. Click Delete Files within the Temporary Internet files options on the General tab.

       The Delete Files dialog opens.

    4. Select the Delete all offline content check box, and click OK.

       The browser cache clears.