Upgrade Performance Center

After you upgrade the Data Repository component, upgrade the npc component.
capm350
After you upgrade the Data Repository component, upgrade the 
Performance Center
 component.
If you enabled FIPS-compliant encryption, and you upgrade
Performance Center
before the Data Aggregator, temporary FIPS compatibility synchronization errors occur. These errors occur until the Data Aggregator is upgraded. To avoid this temporary condition, upgrade the Data Aggregator before upgrading
Performance Center
.
Before you upgrade, verify the zip and unzip packages are installed. If these packages are not installed, use the following command to install them:
yum -y install zip unzip
As a step toward enhanced security, the MySQL utilities require a MySQL password. If you are running the utilities as the root user, the password has a default.  We strongly recommend you change the default password with the 
mysqladmin
 utility. However, before you upgrade 
Performance Center
, you must temporarily set the password back to the default. After the upgrade, set the password back to the custom password.
Example:
To change the default ‘root’ password from the default (‘
default
’ in the following example) to your custom password (‘
newpassword
’ in the following example), use the following command:
mysqladmin -uroot -p
default
 password 
newpassword
To change the password back before a 
Performance Center
 upgrade, use the following command:
mysqladmin -uroot -p
newpassword
 password 
default
To upgrade 
Performance Center
, complete the following procedures:
Verify the ulimit Value
Verify that the user account that is installing CA 
Performance Center
 has a value of at least 65536 on the number of open files. Set this value permanently.
Follow these steps:
  1. As the root user or a sudo user, log in to 
    Performance Center
     host.
  2. Open a command prompt and type the following command to verify the ulimit value:
    ulimit -n
  3. If the value is not at lease 65536, change the value:
    1. Type the following command:
      ulimit -n 65536
    2. Open the /etc/security/limits.conf file, and add the following lines:
      # Added by Performance Center
      * soft nofile 65536
      # Added by Performance Center
      * hard nofile 65536
Upgrade CA 
Performance Center
The CA 
Performance Center
 installer includes features to support product upgrades. To perform an upgrade of the software, run the installation file for the new version that you received from CA.
To determine which version you have installed, access the .history file in the /opt/CA/PerformanceCenter/InstallLogs directory.
Follow these steps:
  1. Save the installation file to /tmp on the CA 
    Performance Center
     server.
    Verify that your /tmp location has at least 2 GB of space available.
  2. Run the following command:
    cd /tmp
  3. Change the directory permissions:
    chmod +x CAPerfCenterSetup.bin 
  4. Run the following command:
    ./CAPerfCenterSetup.bin -i console
    The installation begins in Console mode.
  5. Follow the instructions in the console.
  6. (Optional) When prompted, specify the following parameters for fault tolerance. For more information, see High Availability.
    • Configure with Fault Tolerant Data Aggregator
      If fault tolerance was configured for the Data Aggregators, specify 2 for Yes.
      Default:
       1
    • Data Aggregator Proxy Host
      Specify the host name/IP address of the proxy server.
    The upgrade operation installs the software. The progress indicator may pause.
    When the upgrade is complete, the console displays a confirmation message.
Reapply Custom MySQL Settings
For upgrades from releases before 
CA Performance Management
 3.0, this upgrade includes updates to MySQL. These updates require replacing my.cnf. The upgrade backs up the existing my.cnf files as my.cnf.bak. If my.cnf.bak already exists, the backup adds a number to the end of the file name. To retain custom MySQL settings, reapply the settings in the my.cnf files.
Follow these steps:
  1. Locate my.cnf and my.cnf.bak in the following directories:
    • /etc/my.cnf
    • /opt/CA/MySql/my.cnf
      This path reflects the default.
  2. Copy the relevant setting values from my.cnf.bak to my.cnf.
  3. Restart MySQL:
    service mysql restart
Clear Browser Cache
Instruct 
CA Performance Management
 users to clear their browser cache before accessing the upgraded version.
(Optional) Review Log Files
Review the log files in the following directory to track any issues with the upgrade:
Installation Errors and Configuration Events
/opt/CA/PerformanceCenter/InstallLogs
Verify that the directory contains each log with the install date and time:
  • MySql_*
  • SSO_*
  • Device_Manager_*
  • Event_Manager_*
  • Console_*
  • Install_*
If any logs are missing, the installation is incomplete. Review each log for any fatal errors. Verify that the 
.history
 file is updated to the latest version.
Change the Default MySQL Password
We strongly recommend you change the default password with the 
mysqladmin
 utility.
To change the default ‘root’ password from the default (‘
default
’ in the following example) to your custom password (‘
newpassword
’ in the following example), use the following command:
mysqladmin -uroot -p
default
 password 
newpassword