EMC Corporationconfidential and PROPRIETARY

Celerra upgrd-ck script User Guide

Revision11-01

Nov 2, 2012

Confidential and Proprietary

Revision History

What’s New In upgrd-ck script

What’s New in the PUHC ( check_nas_upgrade )

Disclaimers

Comments

Supported Code and Platforms

Task List

Acquire the latest version of the script and it User Guide

Installing the script on the Control Station

Using WINSCP:

Using Mcopy with a floppy:

Using Untar and Unzip:

autolog collection scripts

Run the script before the upgrade

Analyze the pre-upgrade log data

Failure Counts

What to file with your CCA request

Run the script post upgrade

Analyze the post upgrade log data

File Clean up

Using cpgInput.rpt as the Configuration Source for NAS Code Upgrades

Error Messages

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.

Revision History

Date / Revision / Change Description
9/14/2012 / 10.99 / Listed in what’s new
10/19/2012 / 11.00 / Listed in what’s new ( re-called)
11/02/2012 / 11.01 / Listed in what’s new

What’s New In upgrd-ck script

Fix backup of cron jobs for NAS > 5.6
Add check for user event.cfg files ( need a Primus )
Add check for 720 MB / free space when 5.6 to 6.0 upgrade
Add check W000217 for ETA emc277607
Add check E000218 for running tasks
Add check E000219 for LUN 5 size
Add check E000220 for Invalid DM netmask
Change logging for external usermapper check.

What’s New in the PUHC ( check_nas_upgrade )

Disclaimers

This script is intended for use by EMC Support Personnel and Authorized EMC Partners.

Comments

Any comments, problems, issues or concerns should be submitted via email to the feedback email link

Please include the /home/nasadmin/lists-tar-<hostname>-<date stamp>-<run level>.tar.gz file produced by the upgrd-ck script along with any screen captures and other supporting information and a detailed description of the problem encountered.

Supported Code and Platforms

The script has been tested with NAS code version 5.1or higher on all supported Celerra Hardware.

Task List

Acquire the latest version of the script and it User Guide
Read and understand this Users Documentation
Install the script to the Control Station
Run the script before the upgrade
Analyze the pre-upgrade log data
Collect log for transfer with CCA request or transfer to Celerra Support for Assistance
Run the script post upgrade
Analyze the post upgrade log data
File clean up

Acquire the latest version of the script and it User Guide

Always check that the latest version of the script is what you will be testing with.

The upgrd-ck Script and support document are bundled with the Celerra Procedure Generator.

1.Click here to visit the Celerra Procedure Generator Web Site.

2.Download and install the latest Celerra Procedure Generator with default settings.

3.Retrieve the latest upgrd-ck script along with the support documentation from the following location on your local computer:

C:\Program Files\EMC\Celerra Procedure Generator\Modules\SCRIPTS

Note:If you do not install the Celerra Procedure Generator in the default directory, you will have to navigate to the SCRIPTS directory to find the upgrd-ck script. It will be in the following location: [Install Location]\Modules\SCRIPTS.

Available for EMC Partners on EMC Services Partner Web via Powerlink web site at

Note:Use the “bin” option when using ftp to download the file.

Installing the script on the Control Station

1.[]Once you have the latest version of the script on your PC

2.[]Copy the file to a floppy

copy c:\upgrd-ckvX.tar.gz a:\

3.[]Mount the floppy on the Control Station

mount /dev/fd0 /mnt

4.[]Copy the script from the mounted floppy to the /home/nasadmin directory on the Control Station

cp /mnt/upgrd-ckvX.tar.gz /home/nasadmin

Note: You could also ftp the file to the Control Station, but this will require that you first copy the upgrd-ck script file to a ftp server, then logon to the Control Station and from the /home/nasadmin directory, ftp the upgrd-ckvX.tar.gz file in binary mode from the source ftp server, to the Control Station.

5.[]Untar and gzip the file:

tar xvfz upgrd-ckv10-5.tar.gz

upgrd-ckv10-5.bin

check_nas_upgrade_5.4.27.2.tar.gz

check_nas_upgrade_5.5.25.2.tar.gz

logcoltrans.tar.gz

connectivity2212007.tar.gz

6.[]When you run the script as you normally would it will extract, install and run the appropriate check_nas_upgrade package, based on user response about which version you are upgrading to. The scripts will be installed in the /tmp directory. The NAS Code upgrade will do the installation to the proper location.

7.[]If you selection option 3 when prompted the installation to the /tmp directory will not be performed. The check_nas_upgrade script will only be installed if you are currently running NAS code 5.2 or higher. If the current version of the installed version of this script is higher then the one included with the upgrd-ck script, it will not be installed, and the current /nas/tools/check_nas_upgrade script will be run instead.

Using WINSCP:

8.[]To start WinSCP3, Double click on WinSCP3.exe in the Program Files directory or double click on the WinSCP3 Icon.

9.[]Click on the NEW tab in the WinSCP Login window.

Figure1WinSCP Login Window

10.[]Enter the Control Station IP as the host name, root as the user name and the root password.

Figure2WinSCP Login Session Window

11.[]Click on Login tab.

12.[]The Connecting to Host and the Authentication and Reading Remote Directory messages will display.

13.[] The WinSCP Dual Screen display opens.

14.[]In the right window navigate to the directory containing the upgrade check script.
The default location is C:\Program Files\EMC\Celerra Procedure Generator \Modules\Scripts.

15.[]In the left window navigator to the Celerra /home/nasadmin directory.

Figure3WinSCP WinSCP Dual Screen display Window

16.[]Drag the upgrd-ck script to the /home/nasadmin directory window.

Figure4WinSCP Copy display

17.[]Click on copy.

18.[]The WinSCP Copy Status screen displays.

Figure5WinSCP Copy Status

19.[]When the copy has completed verify that both files are the same size.

20.[]Click on the F10 Quit tab to close WinSCP.

21.[]Click on OK to Terminate the Session and close the WinSCP application.

22.[]Open an SSH, secure shell connection or serial connection, with the Control Station.
A connection may be made over the Customer’s network using SSH, PuTTY or another SSH utility.

23.[]Use the following procedure to establish serial communication with an NS-series Control Station.

Connect the NULL modem cable to the front of the Control Station and to the service laptop.
Open a HyperTerminal session as follows:
From the Start Menu, select ProgramsAccessoriesCommunicationsHyperTerminal.
Enter a session name and click OK.
Select the COM port the cable connects to in the Connect Using box and click OK.
Enter the following port settings;then click OK.

Bits per second: 19200

Flow Control: None

Data bits: 8

Emulation: Auto Detect

Parity: None

Telnet terminal ID: ANSI

Stop bits: 1

Open the Properties window and click the Settings Tab. Select Auto Detect in the Emulation box and ANSI in the Telnet terminal ID box.

24.[]Log onto the Control Station as nasadmin.

25.[] Become the root user.

$su
Password:

Using Mcopy with a floppy:

26.[]On the service lap top navigate to the directory containing the upgrade check script.
The default location is C:\Program Files\EMC\Celerra Procedure Generator\Modules\Scripts.

27.[]Copy the upgrd-ck script to a floppy.

28.[]Place the floppy in the Celerra Control Station.

29.[]Open an SSH, secure shell connection or serial connection, with the Control Station.
A connection may be made over the Customer’s network using SSH, PuTTY or another SSH utility.

30.[]Use the following procedure to establish communication with an NS-series Control Station.

Connect the NULL modem cable to the front of the Control Station and to the service laptop.
Open a HyperTerminal session as follows:
From the Start Menu, select ProgramsAccessoriesCommunicationsHyperTerminal.
Enter a session name and click OK.
Select the COM port the cable connects to in the Connect Using box and click OK.
Enter the following port settings; then click OK.

Bits per second: 19200

Flow Control: None

Data bits: 8

Emulation: Auto Detect

Parity: None

Telnet terminal ID: ANSI

Stop bits: 1

Open the Properties window and click the Settings Tab. Select Auto Detect in the Emulation box and ANSI in the Telnet terminal ID box.
Emulation box and ANSI in the Telnet terminal ID box.

31.[]Log onto the Control Station as nasadmin.

32.[]Become the root user.

$su
Password:

33.[]Enter the command below to copy the upgrd-ck script from the floppy to the Celerra.

# mcopy a:upgrd-ckv10-19p.tar.gz upgrd-ckv10-19p.tar.gz

File "upgrd-ckv10-19p.tar.gz" exists, overwrite (y/n) ? y

34.[]Wait for the # prompt to return.

35.[]Enter ls –l and verify that the copied files is the correct size.

# ls -l up*

-rwxr-xr-x 1 root bin 1434304 Jan 7 15:54 upgrd-ckv10-19p.bin

-rw-r--r-- 1 root root 1171837 Feb 4 13:06 upgrd-ckv10-9p.tar.gz

Using Untar and Unzip:

36.[]To untar and unzip the file upgrd-ckvxx-xxx.tar.gz enter the command shown below.

# tar xvfz upgrd-ckv10-19p.tar.gz
upgrd-ckv10-19p.bin
check_nas_upgrade_5.4.31.2.tar.gz
check_nas_upgrade_5.5.31.6.tar.gz
connectivity2212007.tar.gz
logcoltrans.tar.gz

autolog collection scripts

37.[]The autolog collection scripts will also be installed on all Celerras running NAS code 5.1 or higher with this version of the upgrd-ck script. The installation will be skipped if the tool is already installed and running on the Control Station.

38.[]There is a separate user’s document (Celerra Automatic Log collection tool) available on the above Website. This tool when installed, will automatically collect logs and handle Data Mover panic dumps. By default it is not configured to transmit this information to EMC, but will create log files on the Control Station. It can be configured to ftp these logs to EMC, consult the user documentation, for instructions on setting this up.

39.[]If you do not wish to install this tool, simply remove the “logcoltrans.tar.gz” file before running the upgrd-ck script. If you wish to uninstall the autolog collector after it has been installed do the following:

Change directory to the installation directory

cd /home/nasadmin/logcoltrans

Uninstall the application

# ./UNINSTALL

Starting deleting files....

EventLog : will unload /nas/site/automaticcollection-cs.cfg... done

EventLog : will unload /nas/site/automaticcollection-ui.cfg... done

Done.

40.[]The backend connectivity monitor tool will be installed on all Celerras running NAS code 5.4 or higher with this version of the upgrd-ck script. The installation will be skipped if the tool is already installed and running on the Control Station.

41.[]There is a separate user’s document (Celerra Connection Change Monitor) available on the above Website. This tool will monitor changes to the backend (Fibre Channel ) configuration, and log changes discovered. This tool can be configured to monitor Fibre Switch Changes, but is not configured to do so by default. Consult the user’s document for further information.

42.[]If you do not wish to install this tool, simply remove the “connectivity.tar.gz” file before running the upgrd-ck script. If you wish to uninstall the connection monitor after it has been installed do the following:

Change directory to the installation directory

# cd /home/nasadmin/connectivity_check

Uninstall the application

# ./UNINSTALL

The uninstall script removes everything in the /celerra, including the directory itself.

Starting removing files....

Remove execution of the feature in /etc/init.d/nas

Remove execution of the feature in /nas/site/cron.d/nas_sys

Done.

Run the script before the upgrade

The script should be run just prior to the NAS code upgrade and then again the upgrade has completed. It can also be run as a quick health check of the Celerra.

To run the script before the code upgrade:

43.[]Become the root user

44.[]Enter the following command to start the script :

/home/nasadmin/upgrd-ckv10-5.bin -v 1

Note: If you wish to backup configuration files, use “-vb 1” switch instead and file backup will also be run. There are many other switch combinations which can be used, these are explained in Appendix 4 of this document.

[Sample script output]

[root@hammer1 nasadmin]# ]# ./upgrd-ckv10-13.bin -v 1

options v

run level is 1

Tue Aug 28 07:58:28 EDT 2007 upgrd-ckv10-13

##########################################################

# This script will log all activity to: /home/nasadmin/pre-upgrade.rpt

# 59 days left before script expires

# As a best practice you should verify this is the latest

# version of the script.

# NOTICE *** UUNET numbers are not available for use effective 12/31/2007.

# Please check emc82645 for further instructions.

##########################################################

UPGRD-CK Version: 10-13 v 1 /nas 5.5.26.1

Celerra: hammer1 Serial Number: FCNHH050500031 modem# 15003

VERIFY MODE TURNED ON

##########################################################

Pre-upgrade checker run: Tue Aug 28 07:58:28 EDT 2007

Enter the number that corresponds to the version of NAS code

you will be upgrading to:

1 NAS 5.4

2 NAS 5.5

3 NAS 5.3 or lower

3. Enter the number which corresponds to the version of NAS code you are upgrading to.

Then the test will continue.

Installing 5.5 nas_check_upgrade scripts ...... NOT INS

Checking for old logcollector ...... SKIP

Checking for installed logcollector ...... Passed

Checking for installed configuration monitor ...... Passed

Cleanup logcollector and connectivity tar files ...... SKIP

Checking minimum NAS code version ...... Passed

Check /nbsnas is mounted ...... Passed

Check /nas/dos is mounted ...... Passed

Check /nas is mounted ...... Passed

Check /nas/var is mounted ...... Passed

Check NAS Services are running ...... Passed

Checking /etc/nsswitch.conf entries ...... Passed

Checking server entries in /etc/hosts file ...... Passed

Checking Control Station entries in /etc/hosts file ...... Passed

Checking NS600 DM Hardware revision ...... Passed

Check nas_server command present ...... Passed

Checking number of data movers ...... Passed

Checking for failed over data movers ...... Passed

Checking DM is at RC 5 ...... Passed

Checking param for link speed of be0 and be1 ...... Passed

Checking DM xlt files ...... Passed

Check for duplicate nas_disk entries ...... Passed

Discovering disks ...... Passed

Checking for multiple LUN 0s ...... Passed

Checking that all configured backends are discovered ...... Passed

Checking that all discovered backends are configured ...... Passed

Checking DM root_fs exist ...... Passed

Checking DM root_fs extension ...... Passed

######## Performing file system checks this could take a while #####

Checking the maximum number of file systems per Celerra ..... Passed

Checking the maximum number of file systems per data mover .. Passed

Checking for MPD exclude file ...... Passed

Check DM File systems for ETA EMC122604 applicability ...... Passed

Checking for Compat type file systems ...... Passed

Checking for DIR3 type file systems ...... Passed

Checking data mover non-MPD fs free space ...... Passed

Checking data mover MPD fs free space ...... Passed

Checking ISCSI for ETA EMC141515 exposure ...... SKIP

Checking for ETA143208 exposure ...... Passed

Checking for UPS AC loss condition ...... Passed

Checking for correct nodes and dnlc settings ...... Passed

Checking for IWD running on CS ...... Passed

Checking CS external interface ...... eth3 FD Passed

Checking /boot free space ...... 90% Passed

Checking /nas free space ...... 70% Passed

Checking /nbsnas free space ...... 59% Passed

Checking / free space ...... 57% Passed

Checking /nas/dos free space ...... 72% Passed

Checking /nas/var free space ...... 95% Passed

Checking nas_eventlog.cfg file loaded ...... Passed

Checking for timefinder fs with mirror on ...... Passed

Checking for current backups of nas_db ...... 9 Passed

Collecting control station network config ...... Passed

Collecting control station cron information ...... Passed

Checking for correct DM model, and memory size ...... Passed

Collecting Symm device information ...... Passed

Checking SymmAPI is in sync ...... Passed

Checking Symm Device emulation type ...... Passed

Checking SRDF feature ...... Skip

Checking DM unique ID matches ...... Passed

Checking DM dart version does not match CS version ...... Passed

Checking data mover Hostname ...... Passed

Checking DM pre-upgrade mounted file systems ...... Passed

Checking DM file system capacity ...... Passed

Checking DM exported file system post-upgrade ...... Passed

Checking DM standby relationships ...... Passed

Collecting DM server_sysconfig information ...... Passed

Collecting DM server_ifconfig data ...... Passed

Collecting DM nas_server -i information ...... Passed

Checking for internal usermapper ...... Passed

Checking for either internal and external usermapper running Passed

##### Checking NAS Params will take a little while...... #####

Checking for param values changed by NAS upgrade ...... Passed

Checking for param values no longer visible after upgrade ... Passed

Checking the number of NAS params visible ...... Passed

Checking NAS params not at default values ...... Passed

Running nas_check_upgrade checks ...... WARN