Previous Topic: Upgrading CCA Server on Linux or UNIXNext Topic: Upgrading CCA Grid Node on Windows


Upgrade Using Console Mode

To upgrade a CA Configuration Automation Agent on UNIX or Linux from the command line

  1. Log in as root.

    You must be root to install the CA Configuration Automation Agent software.

  2. Change to the CA Configuration Automation component and operating system directory containing the installation program, for example:

    # cd agent/<operating_system>

    <operating_system>

    Specifies the operating system, which can be AIX, HPUX, Linux, or Solaris.

  3. Select and run one of the CA Configuration Automation Agent installation programs by entering 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 a Java VM (agentvm.bin), and one does not install a Java VM (agent.bin) 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 agent.bin installation fails, use agentvm.bin 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.

    If you do not have adequate /tmp space available, the installation program tries to use available space in /, the root user’s home directory. After the installation has completed successfully, the temporary storage is released.

    The installation program starts and provides some basic installation navigation and cancellation instructions, including the following key points:

  4. Press Enter to continue upgrading the CA Configuration Automation Agent.

    Note: We recommend that you do not cancel an upgrade once 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.

  5. Read the License Agreement, enter y, and press Enter.

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

  6. Read the copyright and software use information and press Enter.

    You are prompted for the location to install the CA Configuration Automation Agent:

    Where would you like to install CA Configuration Automation Agent?
    	Default Install Folder: /opt/CA/CCAAgent
    ENTER AN ABSOLUTE PATH, OR PRESS <ENTER> TO ACCEPT THE DEFAULT:
    
  7. Enter the path name to the location in which your original CA Configuration Automation Agent software resides, or press Enter to use the default.

    The recommended default location for the initial installation was /opt/CA/CCAAgent.

    Only alphanumeric, underscore (  _  ), and forward slash ( / ) characters are allowed for path names on UNIX-based systems (no embedded blanks or other special characters). If the directory you specify does not exist, the installation program creates it for you.

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

    CA Configuration Automation detects the previous version of the software installed in the specified location:

    You already have an installation of CA Configuration Automation Agent at this location.
    Select Continue : To UPGRADE the CA Configuration Automation Agent files.
    Select Back : To choose a different installation directory.
    Select Exit : To terminate the installation process.
    --> 1- Continue
    	2- Back
    	3- Exit
    ENTER THE NUMBER OF THE DESIRED CHOICE, OR PRESS <ENTER> TO ACCEPT THE DEFAULT:
    
  8. Press Enter (Continue).

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

  9. Review the preinstallation summary and press Enter.

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

    The installation program displays the original agent configuration settings required to set up communications with the CCA Server and to create the agent configuration file agent.conf. (For more information, see CA Configuration Automation Agent Configuration File.)

    Note: Unlike the CCA Server upgrade, you can edit existing CA Configuration Automation Agent configuration settings during the upgrade. The installer displays the answers you provided in the original installation 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. Accept the default or enter a different, unique port number.

    CA Configuration Automation Agent Port Number (DEFAULT: 8063):
    
    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. The default is Yes.

    Do you want to enable Agent Logging?
    ->  1- Yes
        2- No
    ENTER THE NUMBER OF THE DESIRED CHOICE, OR PRESS <ENTER> TO ACCEPT THE DEFAULT:
    
    Enable Server Ping

    Specifies whether to enable server ping. You may not want to enable server ping if:

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

    Do you want to enable Server Ping?
    ->  1- Yes
        2- No
    ENTER THE NUMBER OF THE DESIRED CHOICE, OR PRESS <ENTER> TO ACCEPT THE DEFAULT:
    
    CCA Server Name

    Specifies the server name of the CCA Server.

    CCA Server Name (DEFAULT: ):

    CCA Server Port Number

    Specifies the CCA Server listening port number.

    CCA Server Port Number (DEFAULT: ):

    The installation program confirms that the upgrade was successful.

  11. Press Enter (Done) to exit the installation program.

Upgrade Using the Wizard

Unlike the CCA Server installation, the console mode is the default UNIX CA Configuration Automation Agent installation method. You must specify the -i gui argument with the executable to install using the installation wizard.

To upgrade a CA Configuration Automation Agent on UNIX or Linux using the installation wizard

  1. Log in as root.

    You must be root to install the CA Configuration Automation Agent software.

  2. Ensure that your DISPLAY variable is set properly:
    # echo $DISPLAY
    

    If the DISPLAY variable is not set, set it before continuing, for example:

    # DISPLAY=<server_name/IP>:0.0
    # export DISPLAY
    
  3. Change to the CA Configuration Automation component and operating system directory containing the installation program, for example:

    # cd agent/<operating_system>

    <operating_system>

    Specifies the operating system, which can be AIX, HPUX, Linux, or Solaris.

  4. Select and run one of the following CA Configuration Automation Agent installation programs by entering 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 a Java VM (agentvm.bin), and one does not install a Java VM (agent.bin) 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 agent.bin installation fails, use agentvm.bin 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.

    If you do not have adequate /tmp space available, the installation program tries to use available space in /, the root user’s home directory. After the installation has completed successfully, the temporary storage is released.

    The installation wizard displays the Introduction.

  5. Read the Introduction and click Next.

    Note: We recommend that you do not cancel an upgrade once 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.

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

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

    The Select Installation Location screen appears.

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

    The recommended default location for the initial installation was /opt/CA/CCAAgent.

    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 does not detect the existing software and does create a new, separate installation instead of upgrading.

    Only alphanumeric, underscore (  _  ), and forward slash ( / ) characters are allowed for path names on UNIX-based systems (no embedded blanks or other 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.

    The Pre-Installation Summary screen appears after you select the location.

  9. Review the preinstallation summary provided and click Install.

    The wizard displays the progress as it copies the required files to the target server. When it is finished copying the files, it displays the original agent configuration settings required to set up communications with the CCA Server and to create the agent configuration file agent.conf. (For more information, see CCA_Agent Configuration File.)

    Note: Unlike the CCA Server upgrade, you can edit the existing CA Configuration Automation Agent configuration settings during the upgrade. The settings you provided in the original installation are displayed 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. Accept the default or enter a different, unique 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 server name of the CCA Server.

    CCA Server Port Number

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