How to Prepare for Upgrade
Contents
apmdevops97
Contents
Before you begin an upgrade, perform the following required tasks:
- Ensure that the computer on which your existing installations of Introscope and CA CEM meet the system requirements for the current release.
- Ensure that an Enterprise Manager is installed.
- Review the upgrade sizing and deployment information in the Product Compatibility Matrix.
Plan an Upgrade
To plan an installation or upgrade, evaluate your existing environment and determine where to deploy components. Consider what you want to monitor and the metrics you want to collect. Your requirements can differ depending on whether you deploy CA APM in a test lab or a high-volume production environment.
Follow these steps:
- Identify the characteristics of the environment that you plan to monitor.
- Decide on the type of database that you want to use (PostgreSQL or Oracle).Upgrading from an existing APM database on Oracle to a new APM database on PostgreSQL is not supported.
- Identify the system requirements and supported environments for the type of database you want to install.
- Review the supported upgrade paths listed in the Product Compatibility Matrix.
The following table lists the possible current and target installations.
Current installation | Target installation |
Introscope only | Introscope only (CA APM without TIMs) |
Introscope only | CA APM |
CA APM, Introscope, CA CEM (integrated) | CA APM |
CA APM, Introscope, CA CEM (non-integrated) | CA APM |
CA CEM only | CA APM (without agents) |
Prepare Hardware and Virtual Machines
Prepare the hardware and virtual machines for upgrade.
Follow these steps:
- Disable the TIMs.
- Stop the TIMs.
- If the following SNMP plug-in JAR files exist in the <EM_Home>/ext directory, remove them:SNMPAlertActionEM.jar SNMPAlertActionWS.jar
- Verify that no extra accounts are created for the APM database. For example, if there is a "guest" user, the upgrade fails.
- Determine the size of the existing APM database. The size of the database affects how long the upgrade process takes. Run the following command on a UNIX computer to determine the database size:[root@tess ~]# PGUSER=admin PGPASSWORD="password" psql -t -d cemdb -c 'SELECT relname, reltuples, relpages * 8 / 1024 AS "MB" FROM pg_class ORDER BY relpages DESC;' | egrep "ts_defects | ts_defect_meta_values "The command output looks similar to this example:ts_defect_meta_values | 1.90366e+07 | 2693 ts_defects | 386284 | 87
- Verify that you are logged in as a user with full read, write, and execute permissions on the Introscope directory, preferably as the root user.
- Shut down your Enterprise Manager and all other Introscope components.
- Ensure that all folders and text files are closed. Also, no running process is accessing any file in your Introscope installation.
- Ensure that all computers, virtual machines, and other components meet or exceed the recommended requirements.
- Set up and configure any new computers.Hardware and virtual machines are prepared for upgrade.
Back Up Existing Data
Back up all data from your current installation (CA APM, Introscope, CA CEM). CA CEM data must be restored after the upgrade.
This step is required to avoid losing data.
Follow these steps:
- Back up the APM database.For more information, see your database documentation (Oracle or PostgreSQL).
- Back up TIM configuration data.Note:TIM Configuration data folder can be found at following default location: /opt/CA/APM/tim/config folder.
- Copy all CA CEM customizations to a backup location. Customizations include:
- tess-customer.properties file
- Defect evidence files
- CA Service Desk settings
- Evidence collection scripts
- Plug-ins
- Introscope Transaction Trace settings (if the defaults have been customized).For more information, see theCA APM Configuration and Administration Guide.
- Make an extra backup copy of the initial version of the TriageMapConfigurationsManagementModule.jar file. Put this backup copy in a location other than the <EM_Home>/modules or <EM_Home>/modules-backup directory.
- If you are upgrading from Introscope 8.x to 9.x, back up the \traces directory of your 8.x installation before you perform the upgrade.Warning!Back up the \traces directory to avoid losing data.
- Perform a full backup of the Enterprise Manager, or create an image of the system on which the Enterprise Manager is running.For information about backing up SmartStor and other databases, see theCA APM Configuration and Administration Guide.The installer backs up extensions, .JAR files, and docs from your existing Introscope instance, then removes them from the old installation directory. If you want to delete those files, do so manually.
Back Up TIM Configuration Data
To uninstall the previous version of TIM,
follow these steps:
- Go to the default uninstall folder at the following location /opt/CA/APM/tim/uninstall/
- Run the following script to unistall existing TIM ./timUninsall.sh
Back up all TIM configurations before performing a fresh install of TIM.
Follow these steps:
- Log in to the TIM as root using a console orssh.
- Save the TIM configuration to a file/tmp/timconfig.tarby running the following command:cd / ; tar cf /tmp/timconfig.tar <TIM_Installation_Directory>/CA/APM/tim/config
- Save the/tmp/timconfig.tarfile to another computer over the network. If you have a Linux or UNIX computer on your network, you can usescpto copy the file to the remote computer:scp /tmp/timconfig.tar remote-user@remote-host:timconfig.tar
- remote-hostSpecifies the computer on which the file must be saved
- remote-userSpecifies the user name on that computer
Also, note the TIM Network Settings because it is required for TIM upgrade.
Download CA APM Software
As part of your preparation process, download the CA APM software packages that you need for your particular deployment.
Follow these steps:
- Download the CA APM software packages from the CA APM software download area on support.
- Note the locations of the following files:
- The external components package archive and its accompanying End User License Agreement file,eula.txt. If you are upgrading from a previous version of Introscope, you must obtain the current external components package archive.
- The CA End User License Agreement file,ca-eula.txt. Theca-eula.txtfile is not the same as theeula.txtfile.
Uninstall the Workstation
Follow these steps:
- Locate the uninstaller for your platform.
- Windows:<Workstation_Home>\UninstallerData\ws\Uninstall_Introscope_Workstation.exe
- UNIX: <Workstation_Home>/UninstallerData/ws/Uninstall_Introscope_Workstation
- Shut down the Introscope Workstation.
- Run the uninstaller, using the appropriate command for your platform.
- For .EXE or .BIN files -- run the .exe or ./<bin file>
If Introscope was installed in GUI mode, the uninstaller starts in GUI mode.Removing Introscope in Console mode prompts for the information described in the steps that follow. Silent mode removes all components, without prompting you for input. - In the first screen, click Next to continue.
- In the Confirm Uninstallation screen, click Continue to perform the uninstallation.The uninstaller removes files and folders as specified.
- Click Done to close the uninstaller.
- Manually delete any extra files that exist in the Introscope directory.
Uninstall the EPAgent
Follow these steps:
- Locate the uninstaller for your platform.
- Windows:<InstallationDir>\UninstallerData\Uninstall_Introscope_Standalone_Agent_PP.exe
- UNIX:<EM_Home>/UninstallerData/Uninstall_Introscope_Standalone_Agent_PP
- Run the uninstaller, using the appropriate command for your platform.
- For .EXE or .BIN files -- run the .exe or./<bin file>
If Introscope was installed in GUI mode, the uninstaller starts in GUI mode.Removing Introscope in Console mode prompts for the information described in the steps that follow. Silent mode removes all components, without prompting you for input. - In the first screen, click Next to continue.
- If you had installed Standalone Agent files in addition to the EPAgent on the computer on which you are running the uninstaller, click Uninstall Specific Features.Otherwise, click Complete Uninstall. Go to Step 6.Click Next to continue.
- If you chose to uninstall specific features, select the features to uninstall and click Next to continue.
- In the Confirm Uninstallation screen, click Continue to perform the uninstallation.
- In the Confirm Uninstallation message window, click OK to continue.The uninstaller removes files and folders as specified.
- Click Done to close the uninstaller.
- Manually delete any extra files that exist in the Introscope directory.