Troubleshoot Data Collector upgrade manager upgrade failure and collector bundle download failure on Windows
IT Analytics Data Collector software includes two components - Upgrade Manager and Data Collector.
When IT Analytics Portal is upgraded successfully to a newer version, the subsequent Data Collector upgrade may fail with errors like "Collector bundle download failed for 11.8 Premature EOF" or "Upgrade Manager upgrade failed. Exception is : Premature EOF". These errors indicate that upgrade bundle could not be downloaded successfully on to the Data Collector server due to slow network/low bandwidth.
You must have access to:
Data Collector server and Portal server.
Permissions to copy files from and to Data Collector server and Portal server.
Table: Notations used in the code snippets
Notation | Description |
|---|---|
<PORTAL_APTARE_HOME> | Path of Portal installation. Default value for Windows Portal: |
<DC_APTARE_HOME> | Path of Data Collector installation. Default value for Windows Portal: |
<version> | Version of the IT Analytics Portal. |
You can troubleshoot upgrade manager upgrade failure and collector bundle download failure individually or together as discussed below.
To resolve the issue with the upgrade manager component:
- Log on to the Portal server.
- Go to
<PORTAL_APTARE_HOME>/updateslocation and copy<PORTAL_APTARE_HOME>\updates\aptare_dc_upgrader-windows.zipto a temporary location on any other server or Data Collector server directly. - Log on to Data Collector server and copy
aptare_dc_upgrader-windows.zipfrom temporary location to<DC_APTARE_HOME>\upgrade\bundles. - Remove all
*.propertiesfiles from the<DC_APTARE_HOME>\upgradedirectory - Remove
restore.txtfile from<DC_APTARE_HOME>\upgradedirectory - Upgrade either from the Portal (recommended) or from the Data Collector server as described in the procedures below.
To upgrade from IT Analytics Portal:
- Login to the Portal.
- Go to Admin > Data Collection > Collector Administration and verify whether the Data Collector appears online.
- Go to Admin > Data Collection > Collector Updates and select the Data Collector for which the Upgrade Manager component needs to be upgraded.
- Click Update Upgrade Manager.
The upgrade takes up to 15 minutes to complete.
To upgrade from the Data Collector server:
- Log on to the Data Collector server.
- Open command prompt as an administrator and run:
<DC_APTARE_HOME>\mbs\bin\downloadlib.bat
The upgrade takes up to 15 minutes to complete.
To resolve the failure of Data Collector component upgrade:
- Log on to the Portal server and go to
<PORTAL_APTARE_HOME>\dc_upgraders\windows. - Copy
aptare.jarto a temporary location on any other server or Data Collector server directly. - Log on to the Data Collector server.
- Copy
aptare.jarfrom the temporary location to<DC_APTARE_HOME>\upgrade\bundles. - Rename
aptare.jartodc_upgrader.<version>.zip.For example, if <version> is 11.3.1.02, then file name will be
dc_upgrader.11.3.1.02.zip - Remove all
*.propertiesfiles from the<DC_APTARE_HOME>\upgradedirectory - Remove
restore.txtfile from<DC_APTARE_HOME>\upgradedirectory - Upgrade the Data Collector component either from the Portal (recommended) or from the Data Collector server as described in the procedures below.
To upgrade from IT Analytics Portal:
- Login to the Portal.
- Go to Admin > Data Collection > Collector Administration and verify whether the Data Collector appears online.
- Go to Admin > Data Collection > Collector Updates and select the Data Collector for which the component needs to be upgraded.
- Select Upgrade aptare.jar.
The upgrade takes up to 15 minutes to complete.
To upgrade from the Data Collector server:
- Log on to the Data Collector server.
- Open command prompt as an administrator and run:
<DC_APTARE_HOME>\mbs\bin\downloadlib.bat
The upgrade takes up to 15 minutes to complete.
To upgrade both Upgrade Manager and Data Collector components together:
- Log on to the Portal server.
- Go to
<PORTAL_APTARE_HOME>\updateslocation and copy<PORTAL_APTARE_HOME>\updates\aptare_dc_upgrader-windows.zipto a temporary location on any other server or Data Collector server directly. - Copy
<PORTAL_APTARE_HOME>\dc_upgraders\windows\aptare.jarto a temporary location on any other server or Data Collector server directly. - Log on to Data Collector server and copy
aptare_dc_upgrader-windows.zipandaptare.jarfrom the temporary location to<DC_APTARE_HOME>\upgrade\bundles. - Rename
aptare.jartodc_upgrader.<version>.zip.For example, if <version> is 11.3.1.02, then file name will be
dc_upgrader.11.3.1.02.zip - Remove all
*.propertiesfiles from the<DC_APTARE_HOME>\upgradedirectory - Remove
restore.txtfile from<DC_APTARE_HOME>\upgradedirectory - Upgrade the Data Collector component either from the Portal (recommended) or from the Data Collector server as described in the procedures below.
To upgrade from IT Analytics Portal:
- Login to the Portal.
- Go to Admin > Data Collection > Collector Administration and verify whether the Data Collector appears online.
- Go to Admin > Data Collection > Collector Updates and select the Data Collector for which the component needs to be upgraded.
- Select Upgrade Both.
The upgrade takes up to 15 minutes to complete.
To upgrade from the Data Collector server:
- Log on to the Data Collector server.
- Open command prompt as an administrator and run:
<DC_APTARE_HOME>\mbs\bin\downloadlib.bat
The upgrade takes up to 15 minutes to complete.
Logs:
Upgrade Manager upgrade logs:
<DC_APTARE_HOME>\mbs\logs\watchdog.log
Data Collector upgrade logs:
"Download of DC upgrade bundle and verification related"
<DC_APTARE_HOME>\mbs\logs\watchdog.log <DC_APTARE_HOME>\upgrade\logs
Database views
apt_v_system_upgrade: High level upgrade status
"Component_Name" column indicates the Data Collector server
"Message From" column indicates if it is a "Data Collector" component or "Upgrade Manager" component upgrade
If "Message From" is "Super_Upgrader" - The status is related to "Upgrade Manager" component upgrade
If "Message From" is "Upgrade_Manager" - The status is related to "Data Collector" component upgrade
apt_v_system_upgrade_detail: Detailed upgrade messages for a particular upgrade session.