Grass Valley iControl Upgrade User Manual

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...