Before Upgrading to APTARE StorageConsole 9.2
• Ensure that you have a valid system backup. For additional information refer to the APTARE StorageConsole System Administrator’s Guide. Prior to executing the upgrade utility, APTARE recommends:
• A cold backup of the Portal / Database server(s) file systems.
• A backup of the file systems containing the Oracle database (typically /data01-3 on Linux) is only valid if it was taken while Oracle was completely shut down.
• An export of the database.
• If you have installed any patches on your present StorageConsole version, check the APTARE StorageConsole Release Notes to verify that they are included in this release. If you are uncertain, check with the APTARE Global Support Services. In most cases, previously installed patches are included in this release.
• Verify that the libXtst.so.6 libraries are installed.
• In the Portal, verify that the Data Collectors are set for automatic updates. This setting triggers the automatic download of updated application logic to the Data Collectors in your enterprise. This download is required to ensure the Data Collectors are running with the latest compatible version. Refer to the vendor-specific Data Collector Installation Guide for additional information about Data Collectors. See
Data Collector Upgrades to ensure that the aptare.jar is upgraded successfully.
• The Portal and Database components should be installed on the same server. Although the installer includes an option to install these components on two separate servers, this option exists for legacy customers, is no longer a standard supported configuration and requires the engagement of APTARE Professional Services.
• If you are upgrading from version 8.4.x to 9.2, you will need to re-install Data Collectors by running the Upgrade Utility Installer and the Upgrade Utility. See
Re-Installing Data Collectors.
• Identify the Java Version on the Data Collector Server and ensure that a 64-bit server is used for the Data Collector Server.
• Refer to the following documentation:
• APTARE StorageConsole Certified Configurations Guide
• Data Collector Installation Guides
Portal and Database Upgrades (Linux Portal)
Due to functionality incorporated into versions 9.1 and 9.2,
additional disk space is required for the Portal upgrade. See
Task 2: Pre-Installation Configuration (Linux) for the initial minimum disk space requirements.
Current Portal Version | Upgrade Portal Version | |
9.0.00 or earlier | 9.1 | An additional 4 GB is required: • /data01 requires an additional 2.5 GB • /data03 requires and additional 1.5 GB |
9.1 or earlier | 9.2 | An additional 2 GB is required: • /data2 requires an additional 1 GB • /data03 requires and additional 1 GB |
9.0.00 or earlier | 9.2 | An additional 6 GB is required: • /data01 requires an additional 2.5 GB • /data2 requires an additional 1 GB • /data03 requires and additional 2.5 GB |
Data Collector Upgrades
IMPORTANT: The Data Collector aptare.jar may not upgrade automatically. Use the following criteria to determine if you need to manually upgrade the aptare.jar.
Step 1: Verify if a Manual Data Collector aptare.jar Upgrade is Required
Current Portal Version | Current aptare.jar | 9.2 Upgrade Requirement |
9.0.00 | any | |
9.0.01 | 9.0.1.01 | |
9.0.01 | 9.0.1.02 | |
9.0.01 | 9.0.1.03 | No manual Data Collector aptare.jar upgrade is required. The correct aptare.jar will be applied if automatic upgrades are configured. |
Releases after 9.0.01 | | No manual Data Collector aptare.jar upgrade is required. The correct aptare.jar will be applied if automatic upgrades are configured. |
* Once you’ve upgraded your Data Collector to aptare.jar version 9.0.1.03, the automatic upgrader will work as expected, provided you have configured automatic upgrades, as described in “Managing and Monitoring Data Collection” in the APTARE StorageConsole User’s Guide.
Step 2: Upgrade the Data Collector aptare.jar
Choose one of the following options to upgrade a Data Collector. Only one of these options should be executed.
Option 1: First upgrade the Data Collector to the latest aptare.jar version (9.0.1.03) and then upgrade the Portal to version 9.2. After the upgrade, the correct 9.2 aptare.jar will be applied if automatic upgrades are configured. Refer to “Managing and Monitoring Data Collection” in APTARE StorageConsole User’s Guide.
Option 2: After the Portal has been upgraded to 9.2, any version of the 9.x Data Collector can be upgraded manually using the <HOME>/mbs/bin/downloadlib.sh or <HOME>\mbs\bin\downloadlib.bat script.
Manual Download of the aptare.jar File
Use the following procedure to manually update your Data Collector if:
• Automatic updates have not been enabled via the Upgrade Manager.
• For some reason, the automatic update failed.
• You simply want to manually update Data Collectors.
1. Use the downloadlib utility to manually download the aptare.jar file. Note that this utility must be run with administrative privileges.
Windows: <Home>\mbs\bin\downloadlib.bat
Linux: <Home>/mbs/bin/downloadlib.sh
2. If you run the downloadlib utility and you get the following message, it indicates that the restore failed or is in progress: Restore has been running for more than 10 minutes, unable to proceed with collector upgrade.
To proceed, delete the restore.txt file and re-run downloadlib.
Windows: <Home>\upgrade\restore.txt
Linux: <Home>/upgrade/restore.txt
Note: When the Data Collector is upgraded via the automatic update, if you run downloadlib within 3 minutes of the automatic update completion time, it will take 3 minutes before downloadlib starts the update.
Upgrading Data Collectors
When upgrading within 9.x release versions, for example from 9.0 to 9.2 refer to
Step 1: Verify if a Manual Data Collector aptare.jar Upgrade is Required. When upgrading from version 8.4.x, there are special considerations. The following table outlines those considerations.
Re-Installing Data Collectors
APTARE StorageConsole 9.2 binaries are only compatible with JRE 1.7. This requires a re-install of all Data Collectors for systems on versions prior to 9.0. The re-install process uses the data collector installer to detect the necessary upgrades. This smart process recognizes your existing configuration and will use the same URL, Data Collector Name, and Passcode. Policies are retained when Data Collectors are re-installed.
To re-install a Data Collector run the script sc_datacollector_linux_9200_<MMDDYYYY>.bin.
Refer to the Data Collector installation guide specific to the backup or storage system vendor we are collecting from for details. See also
About Symantec NetBackup. Please note that when re-installing Data Collectors, only the currently supported operating systems are compatible. If your current Data Collectors are installed on operating systems other than Windows or Linux, you may need to re-evaluate your data collection strategy.
For performance reasons, APTARE recommends that you do not install Data Collectors on the same server as the StorageConsole 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.
About Symantec NetBackup
In an effort to improve data collection configuration, scalability, and monitoring, APTARE’s agent-less data collector for Symantec NetBackup environments now support a centralized data collection architecture with remote NetBackup data collection. A single Data Collector can be used to gather data from many NetBackup Master servers. You no longer have to install the APTARE Collector on the NetBackup Master server. This also allows for remote data collection from the Symantec NetBackup appliances.
Centralized Data Collection (Recommended)
To adopt a centralized collection approach, install the Data Collector software on a Data Collector server and create one NetBackup Data Collector policy in the Portal. With this policy, you can configure all the master servers from which you collect data. See the APTARE StorageConsole Data Collector Installation Guide for Backup Manager for complete instructions.
Distributed Data Collection
When upgrading from 8.4.02 to 9.x, to maintain a distributed NetBackup data collection environment, where a Data Collector is installed on each NetBackup Master Server, a tool is available to help with the migration. This is a run once migration tool. Contact the APTARE Global Support Services for details and support.