Upgrading a Portal and Data Collectors (Linux) > Data Collector Upgrades
  
Version 10.2.01P10
Data Collector Upgrades
For performance reasons, APTARE recommends that you do not install Data Collectors on the same server as the APTARE IT Analytics Portal. However, if you must have both on the same server, verify that the Portal and Data Collector software do not reside in the same directory.
If you are upgrading to 10.2.00 from a version prior to 10.1.01 P5, in some situations, primarily on Windows Portals, the automatic Data Collector upgrades may not complete. Data Collectors will attempt to automatically upgrade to JRE 8. If this fails, there are two options you can select from to resolve this issue:
Uninstall the pre-10.1.01 P5 data collector and reinstall by manually running the 10.2.00 Data Collector installer
OR
Refer to the section Troubleshooting - Manual Data Collector Upgrades for additional information. This covers the manual intervention required to complete a failed Data Collector upgrade.
Mandatory Prerequisites
Do not use downloadlib.[sh|bat] to upgrade the binaries on the Data Collector. Initiate the Data Collector upgrade from the APTARE IT Analytics Portal.
Troubleshooting - Manual Data Collector Upgrades
If the Data Collector fails after completing the previous requirements and prerequisites, perform the following:
On the Collector Server:
1. Kill all running APTARE-related Java processes.
2. Start the APTARE Agent Service
If it starts and continues to run, proceed to Collector Updates from the IT Analytics Portal.
3. If the APTARE Agent Service does not continue to run, verify no APTARE-related Java processes are running. If required, kill all running APTARE-related Java processes.
Restart the Collector Server, if the Java processes cannot be killed manually. Prior to restarting the server, disable the automatic start of the APTARE Agent Service.
4. Rename <APTARE_HOME>/jre to jre.old.
5. Copy <APTARE_HOME>/upgrade/staging/snapshot/jre to <APTARE_HOME>/
6. Enable the automatic start of APTARE Agent service, if you previously disabled the service.
7. Start the APTARE Agent Service, and proceed to Collector Updates from the IT Analytics Portal.
Collector Updates from the IT Analytics Portal
1. Log in to the IT Analytics portal, and navigate to Admin>Data Collection>Collector Updates.
2. Select the Data Collector that failed to upgrade.
3. Verify if either aptare.jar or Upgrade Manager failed to upgrade.
4. Click Upgrade Both, Upgrade aptare.jar, or Update Upgrade Manager, depending on what failed to upgrade. Allow up to an hour for completion, depending on the size of your system.
5. Contact APTARE Global Support Services for additional issues.