Upgrade the Data Collector Installation

Upgrading › How to Upgrade CA Performance Management Data Aggregator - Command Line › Upgrade the Data Collector Installation - Command Line

Upgrade the Data Collector Installation - Command Line

You can upgrade your Data Collector installation. The installation upgrade is installed without uninstalling the existing software.

Important! Be sure that Data Aggregator is up and running before you upgrade the Data Collector installation. Access the following address, http://hostname:port/rest, where hostname:port specifies the Data Aggregator host name and the port number. If this page displays successfully, Data Aggregator is up and running.

Follow these steps:

Log in to the computer where you plan to install Data Collector either as the root user or the sudo user.
Access the Data Collector installation package by doing one of the following actions:
- If you have HTTP access to where Data Aggregator is installed and you are running an X Window System, open a web browser on the computer where you want to install Data Collector. Navigate to the following address and download the installation package:
```
http://data_aggregator:port/dcm/install.htm
```
  data_aggregator:port
  
  Specifies the Data Aggregator host name and the required port number.
  
  Default: 8581, unless you specified a nondefault value during the Data Aggregator installation.
  
  Save the installation package to the /tmp directory.
- If you have HTTP access to where Data Aggregator is installed and you are not running an X Window System, open a command prompt from the computer where you want to install Data Collector. Type the following command to download the installation package to the /tmp directory:
```
wget /tmp -nv http://data_aggregator:port/dcm/InstData/Linux/VM/install.bin
```
  data_aggregator:port
  
  Specifies the Data Aggregator host name and the required port number.
  
  Default: 8581, unless you specified a nondefault value during the Data Aggregator installation.
- If you do not have HTTP access to where Data Aggregator is installed, open a command prompt on a computer that does have HTTP access. Type the following command to download the installation package to your Desktop directory:
```
wget -P ~/Desktop -nv http://data_aggregator:port/dcm/InstData/Linux/VM/install.bin
```
  data_aggregator:port
  
  Specifies the Data Aggregator host name and the required port number.
  
  Default: 8581, unless you specified a nondefault value during the Data Aggregator installation.
Transfer the install.bin file to a local directory on the computer where you want to install Data Collector. For the sake of installation instructions, we assume that the installer is placed in the /tmp directory, however, this location is not required.
Note: Alternatively, use the wget command when you have HTTP access to the computer where Data Aggregator is installed and want to install Data Collector in noninteractive mode.
Type the following command to change to the /tmp directory:
```
cd /tmp
```
Change the permissions for the installation file by typing the following command:
```
chmod a+x install.bin
```
To run the console installation, do one of the following steps:
- To run the installation as the root user, type the following command:
```
./install.bin -i console
```
- To run the installation as the sudo user, type the following command
```
sudo ./install.bin -i console
```
The License Agreement opens.
Read the license agreement, accept the agreement, and click Next.
When the installer prompts you, enter a user. This user will both own the installation and will be the user that Data Collector will run as. The default user is the root user. Hit Enter to select the root user.
Enter an installation directory when prompted.
The installer automatically calculates your maximum memory usage allocation for the Data Collector process, basing it on 80 percent of your server memory. You can modify this value during or after the installation.
When the installer prompts you for the Data Aggregator host information, enter either the IP address or the hostname for Data Aggregator that will be associated with Data Collector.
Important! Specify the Data Aggregator host information correctly. If you specify the Data Aggregator host information incorrectly, Data Collector shuts down after installation. An error message is logged in the Data Collector installation directory/apache-karaf-2.3.0/shutdown.log file. Uninstall and reinstall Data Collector.
Enter either 'y' or 'n' when you are asked whether to associate this Data Collector with the Default Tenant.
Enter ‘n’ if you represent a service provider who is planning to deploy multi-tenancy. You can then associate each Data Collector installation with a tenant. If you are not deploying multi-tenancy, enter 'y'. For more information about multi-tenant deployments, see the CA Performance Center online help.

Data Collector is installed, started, and connects to Data Aggregator.

Note: If you restart the computer where Data Collector is installed, Data Collector automatically restarts and connects to Data Aggregator.
Review the /opt/IMDataCollector/Logs/CA_Infrastructure_Management_Data_Collector_install_timestamp.log file on the computer where Data Collector is installed. If the installation is successful, the log shows 0 Warnings, 0 NonFatalErrors, and 0 FatalErrors.
Verify that the Data Collector connection is successful after the installation by doing the following actions:
1. Log in to CA Performance Center as the global administrator.
2. Navigate to the Data Aggregator administration view and expand the System Status view.
3. Select Data Collectors from the menu.
4. Verify that Data Collector appears in the list. Its Tenant and IP Domain are blank if you selected 'n' when you were asked whether to associate this Data Collector with the Default Tenant.
  Note: The list can take several minutes to refresh and show the new Data Collector installation.
Assign a tenant and IP domain to each Data Collector if the Tenant and IP Domain are blank:
1. Select the Data Collector instance and click Assign.
2. Select another tenant and an IP domain for this Data Collector in the Assign Data Collector dialog and click Save.
Data Collector is installed. Data Collector is running as the installation owner.
Type the following command to verify that Data Collector is running:
service dcmd status

When Data Collector is reinstalled, Data Collector picks up devices and components from Data Aggregator and resumes polling the devices and components that were being polled previously.

More information:

How to Upgrade CA Performance Management Data Aggregator - Command Line