iControl
Upgrade Guide
Part Number: M446-2002-337 28 July 2011
0
Copyright Notice
Copyright © 2011 Miranda Technologies Inc. All rights reserved.
ATTENTION: Please read the following terms and conditions carefully. By using iControl documentation,
you agree to the following terms and conditions:
Miranda Technologies Inc. hereby grants permission and license to owners of iControl to use their product
manuals for their own internal business use. Manuals for Miranda Technologies Inc. products may not be
reproduced or transmitted in any form or by any means, electronic or mechanical, including photocopying
and recording, for any purpose unless specifically authorized in writing by Miranda Technologies Inc.
A Miranda Technologies Inc. manual may have been revised to reflect changes made to the product during
its manufacturing life. Thus, different versions of a manual may exist for any given product. Care should be
taken to ensure that one obtains the proper manual version for a specific product serial number.
Information in this document is subject to change without notice and does not represent a commitment
on the part of Miranda Technologies Inc.
Warranty Policies
Warranty information is available in the Support section of the Miranda Web site (www.miranda.com).
Title iControl Upgrade Guide
Part Number M446-2002-337
Revision 28 July 2011 4:11 pm
ii
Table of Contents
iControl Upgrade Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Notes About Upgrading and Rolling Back . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Upgrading and Application Server Redundancy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Rolling Back . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Upgrading from iControl Version 1.xx . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Upgrading from iControl Version 2.xx . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Before you install iControl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3
Installing iControl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7
After the Upgrade . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Upgrading from iControl Version 3.xx . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Contact Us! . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
0
iv
iControl Upgrade Guide
This document provides instructions for performing an upgrade of an existing iControl
system (version 2.xx or later) to the latest version.
Summary
Notes About Upgrading and Rolling Back
Upgrading from iControl Version 1.xx
Upgrading from iControl Version 2.xx
Upgrading from iControl Version 3.xx
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Notes About Upgrading and Rolling Back
Upgrading and Application Server Redundancy
In order for Application Server redundancy to be fully functional, ONE of the following conditions must be
true:
• ALL the Application Servers within a Redundancy Group have iControl version 4.10 or later installed.
• ALL the Application Servers within the Redundancy Group have versions of software earlier (and not
including) iControl version 4.10 installed.
iControl Upgrade Guide
Rolling Back
Note: One implication of this is that when upgrading an Application Server to version 4.10 or
higher, you must similarly upgrade ALL Application Servers within the Redundancy Group in
order to ensure redundancy is fully functional.
Rolling Back
A rollback operation is the reversal from one version of software to a previously installed version.
Rolling back from any version of iControl above and including version 3.00 to any version below
version 3.00 is not supported. For example, a rollback from iControl version 4.00 to version 2.30 is not
supported. By contrast, a rollback from iControl version 4.03 to version 3.60 is supported.
Upgrading from iControl Version 1.xx
Previous versions (1.xx) of iControl are not compatible with release version 2.00 (and later). An upgrade
from version 1.xx involves a platform change which requires re-imaging the Application Server hard drive.
Configuration files cannot be reused. User-configured items such as iControl Navigator aliases, error log
settings and proc amps must be regenerated (we recommend you record all values before proceeding with
an upgrade). Old iControl Web sites will be converted, but the links will need to be reassigned.
Please contact
support@miranda.com for assistance.
Upgrading from iControl Version 2.xx
To get you started with your upgrade, the Miranda Technical Support team will have provided you with the
upgrade package of the latest version of iControl, which includes the following:
File Name Description
446-27G01-xxx.sh Application Server platform upgrade script
446-29G01-xxx.sh iControl upgrade preparation script
446-20G01-xxx.zip iControl upgrade installer
iControl_vxxx_ReleaseNotes.pdf iControl Release Notes
iControl_vxxx_UpgradeGuide.pdf iControl Upgrade Guide (this document)
2
iControl
Upgrade Guide
Note: It may be necessary to increase the memory on the iControl Application Server being
upgraded. A minimum of 2×512 MB RAM (Miranda order code: IC-MEMORY-UPGRADE-1) is
required per Application Server.
Before continuing, we strongly recommend that you read the iControl Release Notes in order to ensure
that:
• your existing system (including any client workstations) meets the hardware and software
requirements for the upgrade,
• you are aware of any compatibility issues that might affect your system,
• you are aware of, and have mitigated, any potential server replication data loss,
• you are aware of the configuration guidelines and have accounted for their impact, if any, on your
configuration (current and future).
Note: The iControl Maintenance Form of the Application Server’s Web administration tool
(Webmin) cannot be used to update from 2.xx to the latest version. The update has to be
performed through an SSH command line interface.
Before you install iControl
There are two preparation scripts that you must run before installing the iControl software. To run these
scripts you need an SSH client such as PuTTY.
Using PuTTY
PuTTY is available from your Application Server’s Useful Downloads page.
Installing PuTTY
To install PuTTY on your client PC:
1. On the iControl Startup page, click Useful Downloads.
2. On the Useful Downloads page, click PuTTY to download the PuTTY executable file (
3. When prompted, save the file to your desktop, or some other location on your client PC.
putty.exe).
3
iControl Upgrade Guide
Click Open
Click SSH
Type the server’s host
name or IP address
Using PuTTY
Establishing a Superuser SSH Connection with the iControl Application Server
To establish an SSH connection with the iControl Application Server:
1. Browse to the PuTTY executable file on your client PC, and open it.
Note: If Windows prompt you about the application’s signature, click Yes .
The PuTTY Configuration window appears:
2. In the Session panel, specify your Application Server’s IP address or host name, make sure that SSH is
the selected connection type, and then click Open.
Note: If the PuTTY Security Alert window appears, click Yes to close it.
A command line window appears, prompting you for a user name.
3. Type
4. When prompted for a password, type
4
miranda, and then press <Enter>.
Note: Application Servers are configured by default with the user name
password
icontrol, but these may have been changed by your system administrator.
icontrol, and then press <Enter>.
miranda and the
You are now connected to the Application Server.
iControl
Upgrade Guide
5. Type
su, and then press <Enter>.
6. When prompted for a password, type
You are now connected as
root, in superuser mode:
Ending the PuTTY Session
To end the SSH session:
1. Type
2. Type
exit, and then press <Enter> to end the superuser session.
exit again, then press <Enter> to close the PuTTY command line window.
Script #1: Platform Upgrade
icontrol, and then press <Enter>.
Before installing the iControl upgrade package, it is important that you perform a platform upgrade. This
ensures that your Application Server’s operating system contains all the components and libraries that are
needed by iControl.
To perform a platform upgrade:
1. Download or copy the iControl Upgrade Package to a client PC on the same network as the iControl
Application Server to be upgraded.
2. On the Start menu, point to All Programs, then to Accessories, and click Command Prompt.
A DOS command line window appears.
3. In the DOS command line window, open an FTP session on the Application Server by typing the
following command:
ftp AAA.BB.CC.DD
where AAA.BBB.CC.DD is the Application Server’s IPaddress (e.g. 10.0.3.6).
4. When prompted, type the user name and password.
Note: Application Servers are configured by default with the user name
password
icontrol, but these may have been changed by your system administrator.
miranda and the
5
iControl Upgrade Guide
Script #2: Upgrade Preparation
5. Activate binary transfer mode by typing the following command:
bin
6. Transfer the platform upgrade file to the Application Server by typing the following command:
put [full path to]\446-27G01-xxx.sh
Note: The bac kslash (
\) is used here because you are transferring from the Windows file system.
7. Type quit, then press <Enter >to close the FTP session.
8. Type
9. Using the same login credentials (user name:
exit, then press <Enter> to close the DOS command line window.
miranda, password: icontrol), open PuTTY to
establish a superuser SSH connection with the iControl Application Server (see "Using PuTTY", on
page 3).
10.Execute the platform upgrade file in the directory
/home/miranda on the Application Server by
typing the following command:
sh 446-27G01-xxx.sh
11.Type exit, then press <Enter> to end the superuser session.
12.Type
exit again, then press <Enter> to close the PuTTY command line window.
Script #2: Upgrade Preparation
If you are planning to upgrade an existing iControl version 2.xx system, we recommend that you perform
the following procedure in order to make it easier to revert back (downgrade) to version 2.xx should the
need arise:
To run the upgrade preparation script:
1. On the Start menu, point to All Programs, then to Accessories, and click Command Prompt.
A DOS command line window appears.
2. Open an FTP session on the Application Server by typing the following command:
ftp AAA.BB.CC.DD
where AAA.BBB.CC.DD is the Application Server’s IPaddress (e.g. 10.0.3.6).
3. When prompted, type the user name and the password.
Note: Application Servers are configured by default with the user name
password
icontrol, but these may have been changed by your system administrator.
miranda and the
4. Activate binary transfer mode by typing the following command:
bin
5. Transfer the upgrade preparation file to the Application Server by typing the following command:
6
put [full path to]\446-29G01-xxx.sh
iControl
Upgrade Guide
Note: The bac kslash (
\) is used here because you are transferring from the Windows file system.
6. Type quit, then press <Enter> to close the FTP session.
7. Type
8. Using the same login credentials (user name:
exit, then press <Enter> to close the DOS command line window.
miranda, password: icontrol), open PuTTY to
establish a superuser SSH connection with the iControl Application Server (see "Using PuTTY", on
page 3).
9. Execute the upgrade preparation file in the directory
/home/miranda on the Application Server by
typing the following command:
sh 446-29G01-xxx.sh
10.Type exit, then press <Enter> to end the superuser session.
11.Type
exit again, then press <Enter> to close the PuTTY command line window.
You are now ready to install iControl.
Installing iControl
To perform the upgrade, make sure that the client PC from which you will be performing the upgrade is on
the same network as the iControl Application Server to be upgraded, and then proceed as described below.
Note: You cannot use iControl’s Webmin management tool (the Web interface) to perform the
upgrade.
To run the upgrade preparation script:
1. On the Start menu, point to All Programs, then to Accessories, and click Command Prompt.
A DOS command line window appears.
2. Open an FTP session on the Application Server by typing the following command:
ftp AAA.BB.CC.DD
where AAA.BBB.CC.DD is the Application Server’s IPaddress (e.g. 10.0.3.6).
3. When prompted, type the user name and the password.
Note: Application Servers are configured by default with the user name
password
icontrol, but these may have been changed by your system administrator.
miranda and the
4. Activate binary transfer mode by typing the following command:
bin
5. Transfer the upgrade installer file to the Application Server by typing the following command:
7
iControl Upgrade Guide
After the Upgrade
put [full path to]\446-20G01-xxx.zip
Note: The bac kslash (
\) is used here because you are transferring from the Windows file system.
6. Type quit, and then press <Enter> to close the FTP session.
7. Type
8. Using the same login credentials (user name:
exit, and then press <Enter> to close the DOS command line window.
miranda, password: icontrol), open PuTTY to
establish a superuser SSH connection with the iControl Application Server (see "Using PuTTY", on
page 3).
9. Unzip the upgrade installer file in the directory
/home/miranda on the Application Server by
typing the following command:
unzip 446-20G01-xxx.zip
10.If prompted to overwrite icontrol.sh, type y (yes), then press <Enter>.
11.Run the installer on the Application Server by typing the following command:
sh icontrol.sh
12.Type reboot, and then press <Enter> to reboot your iControl Application Server.
13.Type
14.Type
exit, and then press <Enter> to end the superuser session.
exit again, and then press <Enter> to close the PuTTY command line window.
Congratulations! You have successfully installed iControl.
After the Upgrade
1. If you get error message dialogs when trying to open a site or display a page in iC Web runtime, then
the Web sites created in previous versions MUST be re-saved using iC Creator. Some XML format
incompatibilities could have been introduced in older sites. Re-saving them will fix the file format.
2. If you upgraded from iControl version 2.7x, recreate the log database schema by using the Clear
database option from the Log Viewer window. The log database will be cleared and the database
schema recreated.
See also:
For more information, see the Events & Incident Logs chapter of the iControl User’s Guide,
available from the iControl Startup page via the Documentation link.
Upgrading from iControl Version 3.xx
Upgrading to the current version from an earlier 3.xx version of iControl can be performed by using
iControl’s Webmin management tool (a Web user interface).
8
To upgrade from iControl version 3.xx:
iControl
Upgrade Guide
1. Download the
446-20G01-xxx.zip file to your PC.
2. On the iControl Startup page, click System Tools.
The System Tools page appears.
3. On the System Tools page, click Administration.
The Login to Webmin window appears.
4. Type the applicable user name and password (the default user name is
as the password), and then click Login.
The Webmin main page appears.
miranda, with icontrol
9
iControl Upgrade Guide
Upgrading from iControl Version 3.xx
10
5. Click Miranda iControl Management Tool.
The Miranda Setup page appears.
iControl
Upgrade Guide
6. Click the iControl Maintenance Form icon.
The iControl Maintenance Form page appears.
7. Locate the iControl Upgrade Form section.
8. Click Browse next to the From an Uploaded File text field, to locate the ZIP file on your PC.
The Choose file window appears.
9. In the Choose file window, browse for the ZIP file.
10.Click Go.
11
iControl Upgrade Guide
Upgrading from iControl Version 3.xx
The successful upgrade message window appears.
11.Click Reboot Now to restart the iControl system.
Congratulations! You have successfully installed iControl.
12
Contact Us!
Miranda Technical Support
For technical assistance, please contact the Miranda Technical Support center nearest you:
Americas Asia
Office hours: 9:00 a.m. - 9:00 p.m. (EST) Office hours: 9:00 a.m. - 5:00 p.m. (GMT+8)
Telephone: 1-800-224-7882 Telephone: + 852-2539-6987
Fax: 1-514-335-1614 Fax: + 852-2539-0804
E-mail: support@miranda.com E-mail: asiatech@miranda.com
Europe, Middle-East, Africa, UK China
Office hours: 9:00 a.m. - 6:00 p.m. (GMT) Telephone: + 86-10-5873-1814
Telephone: + 44 (0) 1491 820222 E-mail: asiatech@miranda.com
Fax: + 44 (0) 1491 820002
E-mail: eurotech@miranda.com
France EMERGENCY After Hours (Global)
Office hours: 9:00 a.m. - 5:00 p.m. (GMT + 1) Toll Free: 1-800-224-7882 (US and Canada)
Telephone: + 33 1 55 86 87 88 Telephone: +1-514-333-1772
Fax: + 33 1 55 86 00 29
E-mail:
eurotech@miranda.com
Corporate Head Office
Miranda Technologies Inc.
3499 Douglas-B.-Floreani, St-Laurent, Quebec, Canada H4S 2C6
Telephone: 514-333-1772
Fax: 514-333-9828
Web :
http://www.miranda.com
Loading...