Control Center Upgrade

Patch Readme Information

EMC® Ionix™ ControlCenter®

Version 6.1

ControlCenter 6.1 Backup and Restore Utility (Patch 4887) Readme

Revision A04

EMC Corporation

Corporate Headquarters:

Hopkinton, MA 01748-9103

1-508-435-1000

www.EMC.com

Patch Readme Information

EMC Ionix ControlCenter 6.1 Patch 4887 Readme

Modified on February 24, 2011 2

Table of Contents

Overview .................................................................................................................................... 3

Patch contents ..................................................................................................................................... 3

Patch fixes ........................................................................................................................................... 3

Patch overview ........................................................................................................................... 4

Prerequisites ....................................................................................................................................... 4

Installing the patch and backing up Ionix ControlCenter application ........................................... 5

Procedure to restore Ionix ControlCenter application .......................................................................... 6

Ionix ControlCenter migration procedure ................................................................................... 8

Prerequisites ....................................................................................................................................... 8

Distributed and single infrastructure scenarios:.......................................................................... 9

Procedure for distributed infrastructure scenarios: ............................................................................ 11

Generic Steps ................................................................................................................................................ 11

Procedure for Scenario 1: .................................................................................................................. 14

Prerequisite .................................................................................................................................................. 14

Ionix ControlCenter Repository and Server Migration procedure ................................................................... 14

EMC StorageScope Repository migration procedure ................................................................ 24

Ionix ControlCenter Store Migration Procedure:....................................................................... 33

Alternative procedure to migrate a Store ...................................................................................................... 40

Procedure for Scenario 2:................................................................................................................... 41

Ionix ControlCenter Repository and Server migration procedure ................................................................... 41

StorageScope Repository and Store migration procedure ............................................................................... 41

Procedure for Scenario 3.................................................................................................................... 49



Overview

This readme contains important information about EMC®

Ionix™

ControlCenter®

6.1 patch 4887. Review

this document before installing patch 4887.

Patch contents The downloaded CC_4887.zip file contains:

File name Description

Patch4887.exe Executable file

Patch4887_Readme_First.pd f Document to use during backup and restore

Patch fixes The following table lists the fixes in this patch:

CQ

number

Symptom Component

533605 Backup and restore scripts for Ionix ControlCenter 6.1

base or any released update bund le includ ing UB9

Backup, restore scripts



Patch Overview

This procedure guides you in creating a backup copy of the EMC Ionix ControlCenter infrastructure

before an update bund le is applied . If there is a failure during the installation of the update bund le, or

you want to rollback the installation of the update bund le, this document contains the following scenarios

to restore the application:

Recovering Ionix ControlCenter after a d isaster

Swapping hardware due to lease terminations

Upgrad ing the hardware specifications to manage a growing storage environment

Ionix ControlCenter 6.1 Backup and Restore Utility are valid for following updates of Ionix

ControlCenter 6.1 and Update Bund les:

Ionix ControlCenter 6.1

Ionix ControlCenter 6.1 Update Bund le 1







Ionix ControlCenter 6.1 has the following services, if all components are installed:

OracleECCREP_HOMETNSListener

OracleServiceRAMBDB

OracleServiceEMCSTSDB

EMC ControlCenter API Server

EMC ControlCenter Key Management Server

EMC ControlCenter Master Agent

EMC ControlCenter Repository

EMC ControlCenter Server

EMC ControlCenter Store

EMC ControlCenter Web Server

EMC StorageScope Server

EMC ControlCenter STS MSA Web Server (UB 8 and above)

EMC StorageScope Repository (Only for UB 9)

Prerequisites

Ionix ControlCenter 6.1 infrastructure should be at 6.1 base or any Update Bund le as mentioned in

Patch Overview Section.

The original and new hosts must have the same Fully Qualified Domain Network (FQDN) name.



Installing the patch and backing up Ionix ControlCenter

application

Use the following procedure to install the patch and backup Ionix ControlCenter hosts:

1. Download and unzip CC_4887.zip (Ionix ControlCenter 6.1 Backup and Restore Utility) to a

temporary d irectory on the Ionix ControlCenter server, repository, store(s), StorageScope and API

server hosts.

2. Run Patch4887.exe.

Wait for the install wizard to start and follow the installation instructions to proceed .

3. Go to %ECC_INSTALL_ROOT% d irectory.

a. Check if a folder HF4887 is created.

b. Verify that the following scripts and files are available in the HF4887 folder:

backup.bat

LCUW_master_logtypes.emc

LCW_UI_Init.emc

regutil610.exe

regutil.pl

restore.bat

4. Go to %ECC_INSTALL_ROOT%\ tools\ utils d irectory and check that the modified date for the file

regutil.exe is same as that of %ECC_INSTALL_ROOT%\ HF4887\ regutil610.exe.

5. Backup all Ionix ControlCenter Rep ository, Store(s) and API Server hosts by executing the

backup.bat file from the %ECC_INSTALL_ROOT%\ HF4887 folder.

NOTE: Verify if the backup information has been generated by backup.bat in the d irectory

%ECC_INSTALL_ROOT%\ tools\ utils\ BackupFiles.

6. Reboot the Ionix ControlCenter hosts.

NOTE: Rebooting the hosts will shutdown all the Ionix ControlCenter and Oracle-related services

and changes the start-up type to Manual. Verify that all the Ionix ControlCenter and Oracle-related

services are stopped after rebooting.

7. Manually backup the Ionix ControlCenter Server, Repository, Store(s) and API Server host data by

copying to a shared drive.

%ECC_INSTALL_ROOT% - Record the location of where you backed up this folder. It is required

during the restore process.

%RAMBBACKUPDIR% - Ionix ControlCenter Repository backup d irectory.

8. Manually backup all of the StorageScope host data by copying to a shared d rive.

%ECC_INSTALL_ROOT% - Record the location of the backed up folder. It is required during the

restore process.

Reports and Archives folders, if a WLA Archiver Agent is installed on this host.



%EMCSTSBACKUPDIR% - Ionix ControlCenter StorageScope Repository backup d irectory.

Any custom reports that are created and imported in StorageScope. The location of this

information is user-defined and needs to be backed up separately if it is not located under

%ECC_INSTALL_ROOT%.

Once this is completed , the Ionix ControlCenter infrastructure is backed up.

9. Set all EMC ControlCenter services to be Automatic.

10. Proceed with the installation of the update bund le, start the following services:

OracleServiceRAMBDB

OracleServiceEMCSTSDB

OracleECCREP_HOMETNSListener

At this point, the system is ready for the deployment of the update bund le.

Procedure to restore Ionix ControlCenter application

NOTE: This section should be followed only if there is a failure during the installation of the Update

Bund le that requires storing the previous version of Ionix ControlCenter or during migration of Ionix

ControlCenter Hosts.

For Migration, refer to the Ionix ControlCenter migration procedure section in this document.

1. If applicable, stop all the running Ionix ControlCenter agents that are patched to this Update Bund le

level using the Ionix ControlCenter Console.

2. Uninstall any agents that are patched to this Update Bund le level.

3. Uninstall the Master Agent on each host where the Update Bund le is applied.

4. Close the Ionix ControlCenter Console on all hosts where it is running and then uninstall it.

5. Stop all EMC ControlCenter and Oracle Services.

6. Remove all Ionix ControlCenter application data from the Infrastructure host as the information will

be recovered from the backup. This includes the following folders:

%ECC_INSTALL_ROOT% - Ionix ControlCenter Application root d irectory

%RAMBBACKUPDIR% - Ionix ControlCenter Repository backup d irectory

%EMCSTSBACKUPDIR% - Ionix ControlCenter StorageScope backup d irectory

If a WLA Archiver Agent was installed on this host, include the Reports and Archives folders

7. Restore all Ionix ControlCenter application data from the manual backup step 7 of Installing the

patch and backing up Ionix ControlCenter application section of this document. This information

may include the following:

%ECC_INSTALL_ROOT% - Ionix ControlCenter Application root d irectory

%RAMBBACKUPDIR% - Ionix ControlCenter Repository backup d irectory

%EMCSTSBACKUPDIR% - Ionix ControlCenter StorageScope backup d irectory


8. From the %ECC_INSTALL_ROOT%\ HF4887 d irectory, run restore.bat. type the value for

%ECC_INSTALL_ROOT% when prompted .

%ECC_INSTALL_ROOT% = Drive letter where EMC ControlCenter is installed .



9. Start the Ionix ControlCenter infrastructure hosts.

10. Set all Oracle services and EMC ControlCenter services to Automatic.

11. Start the following EMC ControlCenter and Oracle services that can be found on the host in the listed

order:

a. OracleECCREP_HOMETNSListener

b. OracleServiceRAMBDB

c. OracleServiceEMCSTSDB

d . EMC ControlCenter API Server

e. EMC ControlCenter Key Management Server

f. EMC ControlCenter Master Agent

g. EMC ControlCenter Repository

h. EMC ControlCenter Server

i. EMC ControlCenter Store

j. EMC ControlCenter Web Server

k. EMC StorageScope Server

l. EMC ControlCenter STS MSA Web Server (UB 8 and above)

m. EMC StorageScope Repository (Only for UB 9)



Ionix ControlCenter migration procedure

Prerequisites Following are the prerequisites for migrating or recovering Ionix ControlCenter infrastructure:

Ionix ControlCenter components to be migrated or recovered should be at version 6.1.

Ionix ControlCenter 6.1 infrastructure should be at 6.1 base or any Update Bund le as mentioned in

Patch Overview Section.

The original and new hosts must have the same Fully Qualified Domain Network (FQDN) name.

NOTE: The migration is limited for the implementations based on DNS. Implementations that are

not using DNS are not covered by this procedure.

Console and Performance Manager Migrations are not supported.

If version 5.x was installed and later upgraded to a higher version, ensure that the IP addresses on

the new host matches the old host.

A quick review of the %ECC_INSTALL_ROOT%\ data\ ecc_server.ini and the

%ECC_INSTALL_ROOT%\ Repository\ network\ ADMIN\ listener.ora reveals the hostnames (or IP

addresses) that are bound to the installation.

If you have installed an agent host by using the IP address as opposed to the hostname, ensure to

update the ctg.ini and MGA.ini files.

If you are using multi-NIC, ensure to map the primary and any add itional NIC interface to the

FQDN of the original installation.

Ionix ControlCenter cluster implementations are not supported .

The target (new hardware) host name should be set identical as the source (former) host name with

FQDN.

The Ionix ControlCenter 6.1 Planning and Installation Guide, Volume 1 P/ N 300-006-362, provides

information on the installation of the Ionix ControlCenter infrastructure.



Distributed and single infrastructure scenarios: This following table covers the d istributed and single infrastructure scenarios.

Scenario Host 1 Host 2 Host 3 Qualified

version

Distributed

Infrastructure 1

Ionix

ControlCenter

Repository

Ionix

ControlCenter

Server

EMC StorageScope

Repository

Ionix ControlCenter

Store

6.1

Distributed

Infrastructure 2

Ionix

ControlCenter

Repository

Ionix

ControlCenter

Server

Ionix ControlCenter

Store

EMC StorageScope

Repository

6.1

Single

Infrastructure

Ionix

ControlCenter

Repository

Ionix

ControlCenter

Server

EMC StorageScope

Repository

Ionix

ControlCenter

Store

6.1



Figure 1: Distributed Infrastructure Architecture

The Ionix ControlCenter 6.1 Planning and Installation Guide, Volume 1 provides more information

on d istributed infrastructure.



Procedure for distributed infrastructure scenarios:

Generic Steps

Follow this procedure before starting the installation:

1. Verify all source machine DNS settings for both A and PTR (in -addr.arpa) records for hostname and

IP address by executing the nslookup command in the DOS prompt as shown in the following

screenshot:

2. Verify the hostname and primary DNS suffix on all source machines by executing the ipconfig/all

command in the DOS prompt:

3. Verify the domain name on Windows Server 2003 platforms using the following steps:

a. Right-click on My Computer and click Properties.

b. Click the Computer Name tab.



4. Verify the DNS suffix and server addresses using the following steps:

a. Click Start > Control Panel.

b. Click Network Connections > Local Area Connection .

c. Click Properties.

d . Select Internet Protocol (TCP/IP).

e. Click Properties.

f. Click Advanced.

g. Click DNS.



NOTE: Skip this step, if you do not have access to your DNS server.

5. Verify the DNS suffix and host name using the Forward Lookup Zones.

NOTE: Skip this step, if you do not have access to your DNS server.

6. Verify the IP address and host name with DNS suffix using the Reverse Lookup Zones.



Procedure for Scenario 1:

Prerequisite

Complete the generic steps starting on page 11 before proceed ing.

Ionix ControlCenter Repository and Server Migration procedure

1. Download and unzip CC_4887.zip to a temporary d irectory on the Ionix ControlCenter Server host.

2. Run Patch4887.exe





backup.bat


LCW_UI_Init.emc

regutil610.exe

regutil.pl

restore.bat

4. Go to %ECC_INSTALL_ROOT%\ tools\ utils d irectory and check that the modified date for the file

regutil.exe is same as that of %ECC_INSTALL_ROOT%\ HF4887\ regutil610.exe.

5. Perform a normal Ionix ControlCenter backup using the following procedure:

a. Review and record the local users and groups for reference.

b. Login to the Ionix ControlCenter Console to verify the Ionix ControlCenter Local Users.

c. Click Administration > Security Management > ECC Users.

NOTE: After migrating or recovering, the local users should be recreated on target host to log in to Ionix

ControlCenter console.



6. Verify that Performance Manager or Console is not installed on the Repository source host that

requires recovery or migration.

NOTE: If the Performance Manager or Console is installed , uninstall these programs from the source

host prior to migration. You can reinstall these programs on the target host after completing the

migration or on a separate host altogether.


on uninstallation.

7. Execute the backup.bat batch file from the %ECC_INSTALL_ROOT%\ HF4887 folder. The

following screen appears:





The following screenshot is an example of the Backup.log output file located at

%ECC_INSTALL_ROOT%\tools\utils directory:



8. Verify the backup information located at %ECC_INSTALL_ROOT%\ tools\ utils\ BackupFiles

d irectory. The following is a sample screenshot:

9. Reboot the Ionix ControlCenter host.

NOTE: Rebooting the hosts will shutdown all the Ionix ControlCenter and Oracle -related services



10. Backup all the Repository or Server host data to a shared d rive, which includes:



Reports and Archives folders, if a WLA Archiver Agent was installed on this host.


11. Shutdown the Source Repository or Server host.

12. Start the Source Repository or Server host.

13. Verify the hostname, DNS names, and network connections are same as on the source host.

The network names and the DNS entries are bound to the host. If the IP address has changed , then

the DNS must be refreshed within the enterprise and the router tables need to be updated .

NOTE: If you have changed the IP address, restart the agents on Solaris host which does the name

caching.

14. Restore all the data from the shared dr ive on the target host, which includes:

%ECC_INSTALL_ROOT% - The value of %ECC_INSTALL_ROOT% on the new host should be

set identical as the original host.





15. From the %ECC_INSTALL_ROOT%\ HF4887 d irectory, run restore.bat. Type the value for


The following screenshots are an example of the

%ECC_INSTALL_ROOT%\ tools\ utils\ Restore.log:







16. Restart the Repository or Server target host.

17. Set Ionix ControlCenter and Oracle-related services to Automatic on the target host.

18. Start the following list of Ionix ControlCenter and Oracle-related services in the given order:


b. OracleServiceRAMBDB

c. EMC ControlCenter API Server

d . EMC ControlCenter Key Management Server

e. EMC ControlCenter Master Agent

f. EMC ControlCenter Repository

g. EMC ControlCenter Server

h. EMC ControlCenter Store

i. EMC ControlCenter Web Server



19. Go to Windows registry and verify that the key "HLKM\ Software\ Apache Software Foundation"

exists.

20. Repeat the step 8 to test the Cluster save/ load process.

21. Reinstall the programs that were uninstalled during step 3, if required .

22. Create the identical local user accounts on the target host as on the source host. The password can be

changed for each user account on the target host.

23. Delete the HBA Managed Object (MO), if the Ionix ControlCenter Master Agent and Ionix

ControlCenter Host Agent were installed on the Repository or Server source host with Host Bus

Adapters (HBAs) attached .

24. Rediscover the new instance of the host for the correct HBAs to be d iscovered.



EMC StorageScope Repository migration procedure 1. Download and unzip CC_4887.zip to a temporary d irectory on the Ionix ControlCenter StorageScope

Repository host.




c. Check if a folder HF4887 is created.

d . Verify that the following scripts and files are available in the HF4887 folder:

backup.bat


LCW_UI_Init.emc

regutil610.exe

regutil.pl

4. Verify that Performance Manager or Console is not installed on the StorageScope Repository source

host that requires recovery or migration.





on uninstallation.

5. Navigate to the %ECC_INSTALL_ROOT%\ HF4887 directory on the Ionix ControlCenter

StorageScope Repository host for the extracted backup.bat and restore.bat scripts.



6. Execute backup.bat from the %ECC_INSTALL_ROOT%\ HF4887 folder. The following are sample

screens that may appear while executing backup.bat:



The following screenshot is an example of the backup.log output file located at

%ECC_INSTALL_ROOT%\ tools\ utils d irectory:











9. Backup all of the StorageScope host data to a shared drive. This includes:

%ECC_INSTALL_ROOT% - Record the location of the backup folder. It is required during the

restore process.


%EMCSTSBACKUPDIR%- Ionix ControlCenter StorageScope Repository backup d irectory.

10. Any custom reports that are created and imported in StorageScope. The location of this information is

user-defined and needs to be backed up separately if it is not located under

%ECC_INSTALL_ROOT%.

11. Shutdown the StorageScope Repository source host.

12. Start the StorageScope Repository target host.

13. Verify the hostname, DNS names, and network connections that are identical as on the source host.

14. Refresh the DNS within the enterprise and update the router tables, if IP address has changed and the

network names and the DNS entries are bound to the host.

NOTE: If you have changed the IP address, restart the agents on Solaris host that does the name

caching.

15. Restore all of the data from the shared d rive on the StorageScope Repository target host, which

includes:

%ECC_INSTALL_ROOT% - The value of %ECC_INSTALL_ROOT% on the new host must be

identical as on the original host.

Restore the Reports and Archives folders, if a WLA Archiver was installed on this host.

%EMCSTSBACKUPDIR% - StorageScope Repository backup d irectory.



16. Execute restore.bat from the %ECC_INSTALL_ROOT%\ HF4887 d irectory. Type the value for



%ECC_INSTALL_ROOT%\ tools\ utils\ Restore.log.





17. Restart the StorageScope Repository target host.




b. OracleServiceEMCSTSDB


d . EMC ControlCenter Master Agent

e. EMC ControlCenter Web Server

f. EMC StorageScope Server

g. EMC ControlCenter STS MSA Web Server (UB 8 and above)

h. EMC StorageScope Repository (Only for UB 9)



20. Open a Console and delete the HBA Managed Object (MO), if the Ionix ControlCenter Master Agent

and Ionix ControlCenter Host Agent were installed on the Repository or Server source host with Host

Bus Adapters (HBAs) attached




Ionix ControlCenter Store Migration Procedure: 1. Download and unzip CC_4887.zip to a temporary d irectory on the Ionix ControlCenter Store host.






regutil.plbackup.bat


LCW_UI_Init.emc

regutil610.exe

regutil.pl

restore.bat

4. Verify that Performance Manager or Console is not installed on the source host that requires recovery

or migration.



migration or on a separate host.


on uninstallation.

5. Navigate to the %ECC_INSTALL_ROOT%\ HF4887 directory on the Ionix ControlCenter

StorageScope Repository host for the extracted backup.bat and restore.bat scripts.




screens seen while executing backup.bat:



The following screenshots are an example of the backup.log output file located at










9. Backup all of the Ionix ControlCenter Store host data to a shared d rive, which includes:





10. Shutdown the Ionix ControlCenter Store source host.

11. Start the Ionix ControlCenter Store target host.




13. Refresh the DNS within the enterprise and update the router tables, if IP ad dress has changed and the



caching.


includes:





Any custom reports that are created and imported into StorageScope. The location of this

information is user-defined and needs to be restored separately if it is not located under

%ECC_INSTALL_ROOT%.



The following screenshots are an exam ple of the %ECC_INSTALL_ROOT%\tools\utils\Restore.log:







16. Restart the Store target host.

17. Set Ionix ControlCenter services to Automatic on the target host.

18. Start the following list of Ionix ControlCenter services in the specified order:

a. Ionix ControlCenter API Server

b. Ionix ControlCenter Master Agent

c. Ionix ControlCenter Store

d . Ionix ControlCenter Web Server




Alternative procedure to migrate a Store

Follow this procedure to migrate a Store:


2. Uninstall all the instances of Ionix ControlCenter Store that is installed .

3. Open a Console, right-click on the Store host and select Delete to remove it from the Ionix

ControlCenter Repository.

4. Shutdown the Ionix ControlCenter Store source host.

5. Install the Ionix ControlCenter Store on the target host.

Note: If a java patch was previously installed on the Ionix ControlCenter Store, then reapply the patch

after installation.



Procedure for Scenario 2: Com plete the generic steps starting on page 11 before proceed ing.

Ionix ControlCenter Repository and Server migration procedure

Follow the instructions for Ionix ControlCenter Repository and Server migration provided on page 11.

StorageScope Repository and Store migration procedure

1. Download and unzip CC_4887.zip to a temporary d irectory on the StorageScope Repository or Store

m achine.






backup.bat


LCW_UI_Init.emc

regutil610.exe

regutil.pl

restore.bat



Note: If the Performance Manager or Console is installed , uninstall these programs from the source




on uninstallation.



5. On the Ionix ControlCenter Store host, explore the %ECC_INSTALL_ROOT%\ HF4887 d irectory on

the Ionix ControlCenter StorageScope Repository host for the extracted backup.bat and restore.bat

scripts.


screens seen while executing backup.bat.










NOTE: Rebooting the hosts will shutdown all the Ionix ControlCenter and Oracle-related services




%ECC_INSTALL_ROOT% - Record the location of where you backed up this folder. It is needed



%EMCSTSBACKUPDIR% - StorageScope Repository backup d irectory



%ECC_INSTALL_ROOT%.

10. Shutdown the StorageScope Repository source host.

11. Start the StorageScope Repository target host.


13. Refresh the DNS within the enterprise and update the router tables, if IP address has changed and the





caching.


includes:






information is user-defined and will need to be restored separately if it is not located under

%ECC_INSTALL_ROOT%









16. Restart the StorageScope Repository or Store target host.



















Procedure for Scenario 3 1. Com plete the generic steps starting on page 11.

2. Review and record the local users and groups for reference.

3. Log in to the Ionix ControlCenter Console to verify the Ionix ControlCenter Local Users.

4. Click Administration > Security Management > ECC Users.

NOTE: After migrating or recovering, the local users should be recreated on the target host to log in to

Ionix ControlCenter Console.







on uninstallation.

6. On the Ionix ControlCenter Store host, explore the %ECC_INSTALL_ROOT%\ HF4887 d irectory on

the Ionix ControlCenter StorageScope Repository host for the extracted backup.bat and restore.bat

scripts




screens seen while executing backup.bat.














%ECC_INSTALL_ROOT% - Record the location of where you backed up this folder. It is needed



%EMCSTSBACKUPDIR% - StorageScope Repository backup d irectory



%ECC_INSTALL_ROOT%.

11. Shutdown the source host.

12. Start the target host.




14. Refresh the DNS within the enterpr ise and update the router tables, if IP address has changed and the



caching.

15. Restore all of the data from the shared drive on the StorageScope Repository target host, which

includes:






information is user-defined and will need to be restored separately if it is not located under

%ECC_INSTALL_ROOT%









17. Restart the target host.











20. Open a Console and delete the H BA Managed Object (MO), if the Ionix ControlCenter Master Agent


Bus Adapters (HBAs) attached .




Copyright © 2010 EMC Corporation. All rights reserved.

Published November, 2010

EMC believes the information in this publication is accurate as of its publication date. The information is

subject to change without notice.

THE INFORMATION IN THIS PUBLICATION IS PROVIDED “AS IS.” EMC CORPORATION MAKES

NO REPRESENTATIONS OR WARRANTIES OF ANY KIND WITH RESPECT TO THE INFORMATION

IN THIS PUBLICATION, AND SPECIFICALLY DISCLAIMS IMPLIED WARRANTIES OF

MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.

Use, copying, and distribution of any EMC software described in this publication requires an applicable

software license.

For the most up-to-date listing of EMC product names, see EMC Corporation Trademarks on EMC.com.

All other trademarks used herein are the property of their respective owners.

Documents

Control Center Upgrade