Previous Topic: Upgrade a CA Configuration Automation Agent on WindowsNext Topic: Upgrade Using Console Mode


Upgrading CCA Server on Linux or UNIX

You can upgrade the CCA Server software on Linux or UNIX in the following ways:

Upgrade Using the Console Mode

To upgrade CCA Server on Solaris or Linux using the console

  1. Log in as a user authorized to install software with write permissions to the target installation directory on the target server.
  2. Navigate to the CA Configuration Automation component and operating system directory containing the installation program:
    $ cd server/<operating_system>
    
    <operating_system>

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

    Note: The examples and prompts used in the remainder of this section are based on a CCA Server installation on a Solaris server. Server installation procedures and prompts are similar for Linux.

  3. Run the installation program by entering the following:
    $ ./installCCAServer.bin -i console
    

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

    If you do not have adequate /tmp space available, the installation program tries to use available space in the user’s home directory. For example, if you log in as root, the installation program will check and use / for the temporary work space. After the installation has completed successfully, the temporary storage is released.

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

  4. Press Enter to continue upgrading CCA Server.

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

  5. Read the License Agreement, enter y at the prompt, 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 installation directory:

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

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

    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 CCA Server 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:

    You already have an installation of CCA Server at this location.
    Select Continue: To UPGRADE the CCA Server and Database.
    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) to proceed with the upgrade.

    You are prompted to install the Java Virtual Machine (VM) included with CA Configuration Automation or use another Java VM:

    --> 1- Use CA Java VM
        2- Select my own Java VM
    ENTER THE NUMBER FOR YOUR CHOICE, OR PRESS <ENTER> TO ACCEPT THE CURRENT SELECTION:
    
  9. Enter the number associated with the Java VM to use for Server, or press Enter to install the supplied Java VM.

    If you specify to select your own Java VM, the installation program prompts you for the location of the Java VM to use.

    Note: The installation program recommends that you install the supplied Java VM version because this version uses domestic encryption, which is the more powerful encryption available for data stored in the Database. If you opt instead 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 summary of the required and available disk space.

  10. Review the pre installation 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.

  11. Press Enter to display the CCA Server configuration specified in the original installation, for example:
    CCA Server Name: sunu5-0
    Administrator email Address: patti.smith@birdland.com
    CCA Port Number: 8080
    AJP Port Number: 8007
    Mail Server Name: pop3mail
    

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

    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.

  12. Press Enter to display the database configuration notes about upgrading the software.
  13. Press Enter to review the database type selection, for example:
    Database Type: Oracle
    PRESS <ENTER> TO CONTINUE:
    
  14. Press Enter to review the CCA Database configuration specified in the original installation, for example:
    CCA User: CCA
    CCA User Password: co99hesion
    Oracle SID: or1
    Server Name: sunu5-5
    Port Number: 1521
    

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

    Clear your screen after upgrading because the password appears in clear text.

    CCA Database Instance Creation and Connection settings follow:

    CCA User

    Specifies the user name authorized to connect to and update 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) 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.

  15. Press Enter.

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

    You are prompted to start the CCA Server:

    Would you like to start the CCA Server at this time?
    -->  1- Yes
    	 2- No
    ENTER THE NUMBER OF THE DESIRED CHOICE, OR PRESS <ENTER> TO ACCEPT THE DEFAULT:
    
  16. Press Enter (Yes) to start the CCA Server.

    The installation programs confirms that the CCA Server upgrade was successful.

  17. Press Enter to exit the installation program.

    Note: Although earlier releases of agent software are compatible with the CCA Server software, we recommend that you now upgrade the CA Configuration Automation Agent on the CCA Server server. Follow the detailed instructions in Upgrading CA Configuration Automation Agent on Linux or UNIX.

  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.

Upgrade Using the Wizard

To upgrade CCA Server on Solaris or Linux using the installation wizard

  1. Log in as a user authorized to install software with write permissions to the target installation directory on the target server.
  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:
    $ cd server/<operating_system>
    
    <operating_system>

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

  4. Run the installation wizard by entering the following:
    $ ./installCCAServer.bin
    

    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 user’s home directory. For example, if you log in as root, the installation program will check and use / for the temporary work space. After the installation has completed successfully, the temporary storage is released.

    The installation wizard starts and displays the Introduction.

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

  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 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 /opt/CA/CCAServer.

    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 does create a new, separate installation instead of upgrading.

    Only alphanumeric, underscore (  _  ), and forward slash ( / ) characters are allowed for pathnames 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.

  9. Click Continue.

    The Java Virtual Machine screen appears.

  10. Click Next to install the customized Java VM for CCA Server.

    If you specify to select another Java VM, the wizard prompts you to specify the location of the Java VM to use.

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

    The Pre-Installation Summary appears after you select the Java VM.

  11. Review the preinstallation summary, and click Install.

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

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

  12. Click Next to review the CCA Server configuration information specified in the original installation.

    The CCA Server Configuration Information screen appears.

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

    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.

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

    The Database Type screen appears, displaying the database type in the original installation.

  15. Review the database type selection and click Next.

    The CCA Database Instance Configuration screen appears.

  16. Review the CCA Database configuration specified in the original installation and click Done.

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

    CCA Database Instance Creation and Connection settings follow:

    CCA User

    Specifies the user name authorized to connect to and update 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 the CCA Server configuration file cca.properties. (For more information, see CCA Server Configuration File.)

    The wizard prompts you to start the CCA Server.

  17. Click Yes to start the server.

    The wizard confirms that the CCA Server upgrade was successful.

  18. 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. Follow the detailed instructions in Upgrading an CA Configuration Automation Agent on Linux or UNIX.

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

Upgrading a CA Configuration Automation Agent on Linux or UNIX

You can upgrade the CA Configuration Automation Agent software on Linux or UNIX in either of the following ways: