Migrate Performance Center
If you upgrade the Linux OS release, you can use the following procedure to migrate npc to a new host with a new IP address and hostname.
capm360
If you upgrade the Linux OS release, you can use the following procedure to migrate
CA Performance Center
to a new host with a new IP address and hostname. You must upgrade the existing system to the product version you are migrating to before migrating. This migration procedure copies over
CA Performance Center
and does not require you to install CA Performance Center
on the new host.Prepare for the Migration
Follow these steps:
- Verify that the new host meets the system requirements. For more information, see Review Installation Requirements and Considerations and theCA Performance ManagementSizing Tool
- Prepare the new host. For more information, see Prepare to Install CA Performance Management.
- If you installedCA Performance Centeron the original system assudo user,add the command alias on the new system:
- Locate the following file on theCA Performance Centerhost:/etc/sudoers
- Add a command alias with the following permissions to the file:
- /tmp/CAPerfCenterSetup.bin
- /etc/init.d/caperfcenter_console(for RHEL 6.x)
- /etc/init.d/caperfcenter_devicemanager(for RHEL 6.x)
- /etc/init.d/caperfcenter_eventmanager(for RHEL 6.x)
- /etc/init.d/caperfcenter_sso(for RHEL 6.x)
- /etc/init.d/mysql
- /opt/CA/PerformanceCenter/PC/bin/caperfcenter_console(for RHEL 7.x, SLES, or OL)
- /opt/CA/PerformanceCenter/DM/bin/caperfcenter_devicemanager(for RHEL 7.x, SLES, or OL)
- /opt/CA/PerformanceCenter/EM/bin/caperfcenter_eventmanager(for RHEL 7.x, SLES, or OL)
- /opt/CA/PerformanceCenter/sso/bin/caperfcenter_sso(for RHEL 7.x, SLES, or OL)
- /opt/CA/PerformanceCenter/Tools/bin/npcshell.sh
- /opt/CA/PerformanceCenter/SsoConfig
- /opt/CA/PerformanceCenter/Uninstall_MySql
- /opt/CA/PerformanceCenter/Uninstall_PerformanceCenter
- /opt/CA/PerformanceCenter/Uninstall_SSO
- /sbin/service
- /opt/CA/MySql/bin/mysql
- /opt/CA/MySql/bin/mysqldump
- /opt/CA/PerformanceCenter/sso
- /opt/CA/PerformanceCenter/PC
- /opt/CA/PerformanceCenter/PC/webapps/pc/apps
- /opt/CA/PerformanceCenter/PC/webapps/pc/css/CA-Blue/images
- /opt/CA/PerformanceCenter/PC/webapps/pc/css/CA-Gray/images
- /usr/bin/vim
- /opt/CA/jre/bin/keytool
- /opt/CA/PerformanceCenter/DM/repository
- /opt/CA/PerformanceCenter/NotificationScripts
Separate the permissions with commas and place all permissions on a single line.Example:Cmnd_Alias CAPERFCENTER = /tmp/CAPerfCenterSetup.bin,/opt/CA/PerformanceCenter/PC/bin/caperfcenter_console,/opt/CA/PerformanceCenter/DM/bin/caperfcenter_devicemanager,/opt/CA/PerformanceCenter/EM/bin/caperfcenter_eventmanager,/opt/CA/PerformanceCenter/sso/bin/caperfcenter_sso,/etc/init.d/mysql,/opt/CA/PerformanceCenter/Tools/bin/npcshell.sh,/opt/CA/PerformanceCenter/SsoConfig,/opt/CA/PerformanceCenter/Uninstall_MySql,/opt/CA/PerformanceCenter/Uninstall_PerformanceCenter,/opt/CA/PerformanceCenter/Uninstall_SSO,/sbin/service,/opt/CA/MySql/bin/mysql,/opt/CA/MySql/bin/mysqldump,/opt/CA/PerformanceCenter/sso,/opt/CA/PerformanceCenter/PC,/opt/CA/PerformanceCenter/PC/webapps/pc/apps,/opt/CA/PerformanceCenter/PC/webapps/pc/css/CA-Blue/images,/opt/CA/PerformanceCenter/PC/webapps/pc/css/CA-Gray/images,/usr/bin/vim, /opt/CA/jre/bin/keytool, /opt/CA/PerformanceCenter/DM/repository, /opt/CA/PerformanceCenter/NotificationScriptscaadmin ALL = CAPERFCENTER
- Verify that the new host has network access from the original host.
Copy the Files from the Existing System
Follow these steps:
- Log in to the originalCA Performance Centerhost.
- Stop theCA Performance Centerservices on the original system:service caperfcenter_console stopservice caperfcenter_devicemanager stopservice caperfcenter_eventmanager stopservice caperfcenter_sso stop
- Create a dump of the MySQLnetqosportaldatabase from the original system:/opt/CA/MySql/bin/mysqldump --routines netqosportal -unetqos -ppassword> $backupDir/netqosportal.sql
- Create a dump of MySQL Event Manager data from the original system:/opt/CA/MySql/bin/mysqldump em -unetqos -ppassword> $backupDir/em.sql
- Copy the database backups:scp $backupDir/netqosportal.sql <new_PC_host>:/tmp/netqosportal.sqlscp $backupDir/em.sql <new_PC_host>:/tmp/em.sql
- Stop the mysql service on the original system:service mysql stop
- Package the files in the installation directory:cd /opttar czf PC.tgz ./CAThe following path is the default installation directory:/opt/CA
- Copy the files to the newCA Performance Centerhost:scp /opt/PC.tgz <new_PC_host>:/opt
- Copy the registry file that stores the installation and version information:scp /var/.com.zerog.registry.xml <new_PC_host>:/var
- If you are migrating to a RHEL 6.x system, copy theCA Performance Centerservice startup scripts:scp /etc/init.d/caperfcenter_console <new_PC_host>:/etc/init.d/caperfcenter_consolescp /etc/init.d/caperfcenter_devicemanager <new_PC_host>:/etc/init.d/caperfcenter_devicemanagerscp /etc/init.d/caperfcenter_eventmanager <new_PC_host>:/etc/init.d/caperfcenter_eventmanagerscp /etc/init.d/caperfcenter_sso <new_PC_host>:/etc/init.d/caperfcenter_sso
- Copy the MySQL startup script:scp /etc/init.d/mysql <new_PC_host>:/etc/init.d/mysql
- Copy the MySQL configuration file:scp /etc/my.cnf <new_PC_host>:/etc/
Configure the New System
If SSL is configured on the source system, reconfigure it on the new system after setup.
Follow these steps:
- Log in to the newCA Performance Centerhost.
- Change the directory:cd /opt
- Extract PC.tgz file:tar -xvf PC.tgz
- Verify that the paths in/etc/profile
to the root wherepoint /opt/CACA Performance Centeris installed. Verify the following PATHs:PATH="${PATH}:/opt/CA/jre/bin"export PATHPATH="${PATH}:/opt/CA/MySql/bin"export PATHPATH="${PATH}:/opt/CA/PerformanceCenter/Tools/bin"export PATH - Do one of the following steps:
- If you are migrating to a RHEL 6.x system, add the following services to add runlevel information for theCA Performance Centersystem services:chkconfig --add mysqlchkconfig --add caperfcenter_consolechkconfig --add caperfcenter_devicemanagerchkconfig --add caperfcenter_eventmanagerchkconfig --add caperfcenter_sso
- If you are migrating to a RHEL 7.x, SLES, or OL system, add the following services to add runlevel information for theCA Performance Centersystem services:chkconfig --add mysql/opt/CA/PerformanceCenter/PC/bin/caperfcenter_console install/opt/CA/PerformanceCenter/DM/bin/caperfcenter_devicemanager install/opt/CA/PerformanceCenter/EM/bin/caperfcenter_eventmanager install/opt/CA/PerformanceCenter/sso/bin/caperfcenter_sso install
- Configure MySQL in the/etc/groupand/etc/passwdfiles:
- Add the following command to /etc/group:mysql:x:27:
- Add the following command to/etc/passwdfile:mysql:x:27:27:MySQL Server:/var/lib/mysql:/bin/bash
- To ensure that the edits take effect, log out from the newCA Performance Centerhost, and log in again.
- Start the mysql service on the new system:service mysql start
- Restore the databases:cd /opt/CA/MySql/binmysql netqosportal -unetqos -ppassword-e 'source /tmp/netqosportal.sql'mysql em -unetqos -ppassword-e 'source /tmp/em.sql'
- Start theCA Performance Centerservices on the new system as follows:
- Start the SSO service:service caperfcenter_sso start
- Wait one minute, then start the Event Manager and Device Manager:service caperfcenter_eventmanager startservice caperfcenter_devicemanager start
- Wait one minute, then start the console service:service caperfcenter_console start
Update the Event Manager Data Source
If the new
CA Performance Center
hostname is different from the original CA Performance Center
host, update the Event Manager data source. You must run a full Event Manager data source sync after you update the host name in the CA Performance Center
UI.Follow these steps:
- Log in to theCA Performance CenterUI as the Administrator user. Use the new host name:http://new_PC_host:8181If you cannot log in, run the following commands to check for database errors:mysqlcheck mysql -unetqos -ppasswordmysqlcheck em -unetqos -ppasswordmysqlcheck netqosportal -unetqos -ppasswordIf you see missing functions or corrupt table issues, see the following procedure for repairing the database.
- Hover overAdministration, and clickData Sources: Data Sources.
- Select the Event Manager data source, and clickEdit.
- Edit the Host Name and Display Name fields:If SSL is configured, specify HTTPS for the communication protocol.
- To validate communication, clickTest.
- ClickSave.
- Select the Event Manager data source, and clickResync.
- SelectPerform a Full Resynchronization, and clickResync.CA Performance Centerresynchronizes with the Event Manager data source.
- After the Event Manager has completed a full resynchronization, re-register the Event Manager with the data sources:
- Run the following command to log in to MySQL:/opt/CA/MySql/bin/mysql em -unetqos -ppassword
- Run the following command:UPDATE em.data_sources SET LastEvent = 0, ConsumerID = 0;
The new Event Manager IP address is pushed to the data sources.
Repair the Database
If you cannot log in to to the
CA Performance Center
UI, check for database errors. If there are errors, stop the CA Performance Center
services. Repair the database with the appropriate command. Then restart the CA Performance Center
services.Follow this procedure:
- Stop theCA Performance Centerservices:service caperfcenter_console stopservice caperfcenter_devicemanager stopservice caperfcenter_eventmanager stopservice caperfcenter_sso stop
- Repair the database with the appropriate command:mysqlcheck -r mysql -unetqos -ppasswordmysqlcheck -r em -unetqos -ppasswordmysqlcheck -r netqosportal -unetqos -ppassword
- tart theCA Performance Centerservices on the new system as follows:
- Start the SSO service:service caperfcenter_sso start
- Wait one minute, then start the event manager and Device Manager:service caperfcenter_eventmanager startservice caperfcenter_devicemanager start
- Wait one minute, then start the console service:service caperfcenter_console start
Configure the Data Source Connector for a Report
If you have the
Unified Dashboards and Reporting for Infrastructure Management
solution set up, and the new CA Performance Center
hostname has changed, reconfigure the data source connector for the reports.Follow these steps:
- Ensure that the CA Business Intelligence data source is installed.
- Open the CA Business Intelligence JasperReports login page in a browser. Log in to the CA Business Intelligence JasperReports Server as a user with an Administration role for thePublicorganization.
- SelectView,Repository.
- In the Folders panel on left, expandPublic,ca,Performance Management,datasources.
- Select theCA Performance Centerdata source and clickEdit.
- Update the data source parameters and clickSave:
- SchemaSpecify HTTP or HTTPS.
- HostSpecify theCA Performance Centerhost name. Do not specify the Data Aggregator host name.
- PortSpecify theCA Performance Centerport (default: 8181).
- CA Performance CenterGUIDTheCA Performance CenterGUID (unique) is used when the password for the CA Business Intelligence web user is not available. This information passes to the Data Aggregator to ensure that the request is going to the correctCA Performance Centerinstance. A web service call onCA Performance Centerretrieves this information.GUID Endpoint URL:http://hostname:8181/pc/center/webservice/datasources/performanceCenterGUID
- ClickSaveto apply the changes.
Verify the Migration
You must run Resync All to update the IP addresses for the
CA Performance Center
netqosportal
tables.Follow these steps:
- Log in to theCA Performance CenterUI as the Administrator user. Use the new host name:http://new_PC_host:8181
- Hover overAdministration, and clickData Sources: Data Sources.
- ClickResync All.CA Performance Centersynchronizes with all registered data sources and updates the required contact information.
- To verify that theCA Performance Centerhost name is correct on the Data Aggregator, use the following REST call:http://<DA_host>:8581/rest/dataaggregatorThe value forNpcHostNameis the IP address of the newCA Performance Centerhost.
Configure Authentication
CA Performance Center
supports external authentication schemes, such as LDAP, SAML 2.0, SSL.- For LDAP, no additional configuration is required with aCA Performance Centermigration.
- For SAML 2.0, reconfigure SAML 2.0 on the new system. For more information, see Set Up SAML 2.0 Support.
- For SSL, set up new SSL certificates with the new hostname and alias. For more information, see Set Up SSL Certificates for Performance Center.
If you have overridden the NPC hostname that Data Aggregator contacts, update Web Service Host in SSO Config. For more information, see Update Performance Center Website Settings.