User guide

Installation and Network Requirements
Upgrade Compatibility Issues
6
Upgrade Compatibility Issues
• Clients using ASI services must migrate to CDMP services when upgrading to iControl
version 3.11 or later. This requires some manual configuration, due to the nature of the ASI
setup.
Please contact
[e-mail] for more information.
• In situations where you are running iControl version 3.40 (or earlier) and are upgrading to
iControl version 4.40, replication data will not survive the upgrade.
After an upgrade to iControl version 4.40, you must re-enter replication data including the
addition of Application Servers in the Redundancy Group(s), the desired replication
frequencies, and the desired extra IP address.
• Upgrading from iControl version 2.XX to version 3.XX deletes all Webmin users except root
and miranda.
• When upgrading from iControl version 3.20 (and later) to a newer version, the existing
WidgetLibrary is renamed WidgetLibraryOld, and a new, upgraded WidgetLibrary is
installed. Custom widgets that had been saved in the old
WidgetLibrary become
unavailable in iC Creator.
Workaround: Import custom widgets from WidgetLibraryOld, and save them in a
location other than the new
WidgetLibrary.
•The iControl Maintenance Form of the Application Server web administration tool
(Webmin) cannot be used to update from 2.xx to 4.40. The update has to be performed
through an SSH command line interface.
• After upgrading from iControl version 3.2x (or earlier) to version 3.30 or later, it will not be
possible to view the existing log database content by using the Log Viewer. If you wish to
be able to access these past records, use the Log Viewer’s export feature to export the data
to a CSV file before upgrading your system.
• iControl version 3.30 (and later) offers a more robust GSM configuration database.
However, if the database became corrupted in version 3.2x or earlier, upgrading to
version 3.41 could result in the loss of some configuration data. Make sure to perform a
backup of your iControl system configuration (by using Webmin’s iControl Maintenance
Form) before upgrading.
• The iC Navigator Error/Warning configuration will be lost during the upgrade procedure.
These settings configure the overall status of each item in the iC Navigator list. The settings
have to be noted prior to the upgrade, and then re-applied using the Alarm Configuration
feature of iControl version 3.00 and later.
IMPORTANT: Previous replication configuration data does not survive upgrade
For upgrades from an iControl version prior to 3.41 to version 4.40, you will need
to reconfigure and enable replication after performing the upgrade. Do this on
the Redundancy Configuration Form using the Manual Takeover mode.
This applies to any upgrade from a version prior to iControl version 3.41 to either
version 3.41 or later. It does not apply to an upgrade from iControl version 3.41
to a later version.