ONTAP 90 Upgrade Express Guide
ONTAP 90 Upgrade Express Guide
ONTAP 90 Upgrade Express Guide
Table of Contents | 3
Contents
Deciding whether to use this guide ............................................................. 4
Cluster software update workflow .............................................................. 5
Performing manual checks before an automated cluster upgrade .......... 6
Reviewing pre-update resources .................................................................................. 6
Reviewing cluster upgrade requirements .................................................................... 7
Cluster upgrade requirements .......................................................................... 7
Guidelines for estimating the duration of the upgrade process ....................... 8
Upgrade considerations for root-data partitioning and root-data-data
partitioning ................................................................................................ 8
Verifying cluster upgrade limits .................................................................................. 8
Verifying the SAN configuration ................................................................................ 9
Ensuring that no jobs are running ............................................................................... 9
Disabling automatic LIF rebalancing ........................................................................ 10
Checking for back-end configuration errors before downgrading ............................ 11
Obtaining ONTAP software images .......................................................................... 12
Upgrades to releases in the ONTAP 9.0 release family from any 8.3.0 or later release (major
upgrades), except for MetroCluster configurations.
Upgrades from 9.0.x to 9.0.z (minor upgrades), except for MetroCluster configurations.
For minor or major upgrades of MetroCluster configurations, or if you want to perform the upgrade
manually, use the procedures in the Clustered Data ONTAP Upgrade and Revert/Downgrade Guide.
Perform the
upgrade.
Review pre-upgrade
resources.
Verify adequate
volume freespace.
Disable LIF
rebalancing.
Review upgrade
requirements.
Verify SAN
configuration.
Obtain ONTAP
image.
Verify cluster
upgrade limits.
Ensure no jobs
running.
The Important cautions section describes potential issues that you should be aware of before
upgrading to the new release. The New and changed features and Known problems and
limitations sections describe new system behavior after upgrading to the new release.
2. Confirm that your hardware platform is supported in the target release.
Find the Upgrade and Revert/Downgrade Guide for your version of Data ONTAP 8
Configuration requirements
The cluster must meet the following configuration requirements before you upgrade it:
If your cluster serves NFS clients, you must use hard mounts.
You should not use soft mounts when there is a possibility of frequent NFS timeouts, which can
lead to disruptions during the upgrade process and possible data corruption.
1. Verify that the cluster does not exceed the system limits for your platform.
You should monitor CPU and disk utilization for 30 seconds. The values in the CPU and Disk
Util columns should not exceed 50% for all 10 measurements reported. No additional load
should be added to the cluster until the upgrade is complete.
1. On each host, verify that a sufficient number of direct and indirect paths are configured, and that
each path is active.
Each host must have a path to each node in the cluster.
2. Verify that each host is connected to a LIF on each node.
You should record the list of initiators for comparison after the upgrade.
For...
Enter...
iSCSI
FC
1. Review the list of any running or queued aggregate, volume, or Snapshot jobs:
job show
Example
cluster1::> job show
Owning
Job ID Name
Vserver
------ -------------------- ---------8629
Vol Reaper
cluster1
Description: Vol Reaper Job
8630
Certificate Expiry Check
cluster1
Description: Certificate Expiry
.
.
.
Node
State
-------------- ---------Queued
Check
Queued
Example
In this example, all running and queued jobs have been deleted:
cluster1::> job show
Owning
Job ID Name
Vserver
Node
State
------ -------------------- ---------- -------------- ---------9944
SnapMirrorDaemon_7_2147484678
cluster1
node1
Dormant
Description: Snapmirror Daemon for 7_2147484678
18377 SnapMirror Service Job
cluster1
node0
Dormant
Description: SnapMirror Service Job
2 entries were displayed
When automatic LIF rebalancing is enabled, LIFs can be migrated to a less-utilized port on another
node based on the LIF failover configuration. However, because a batch upgrade enables you to
upgrade multiple nodes concurrently, automatic LIF rebalancing could cause the LIFs to migrate to a
node that is rebooting.
Steps
2. View and record any LIFs that have automatic LIF rebalancing enabled:
network interface show -allow-lb-migrate true
Example
cluster1::*> network interface show -allow-lb-migrate true
Logical
Status
Network
Current
Vserver
Interface Admin/Oper Address/Mask
Node
----------- ---------- ---------- ------------------ ------------vs0
data1
up/up
192.0.2.120/24
node0
data2
up/up
192.0.2.121/24
node0
data3
up/up
192.0.2.122/24
node1
data4
up/up
192.0.2.123/24
node1
data5
up/up
192.0.2.124/24
node2
data6
up/up
192.0.2.125/24
node2
data7
up/up
192.0.2.126/24
node3
data8
up/up
192.0.2.127/24
node3
8 entries were displayed.
Current Is
Port
Home
------- ---e0e
e0f
e0e
e0f
e0e
e0f
e0e
e0f
true
true
true
true
true
true
true
true
You should record which LIFs have automatic rebalancing enabled so that you can reenable it
after the batch upgrade is completed.
3. Disable automatic LIF rebalancing for each LIF that you identified:
network interface modify * -allow-lb-migrate false
2. Based on the result of the previous step, proceed with one of the following options:
If...
Then...
You are instructed to run the storage errors show command if ONTAP detects a back-end
configuration error that would prevent ONTAP and the back-end storage array from operating
together properly.
3. Enter the following command:
storage errors show
The storage errors show command provides details about the error at the array LUN level.
Example
DGC_RAID5_1
---------NAME (Serial #): This Array LUN is only available on one path.
Proper configuration requires two paths.
4. Fix the problems indicated by the storage errors show command, and then downgrade your
system.
The FlexArray Virtualization Installation Requirements and Reference Guide contains
explanations about errors shown in the storage errors show output and provides information
about how to fix them.
To upgrade the cluster to the target release of ONTAP, you need access to software images. Software
images, firmware version information, and the latest firmware for your platform model are available
on the NetApp Support Site. Note the following important information:
Software images include the latest version of system firmware that was available when a given
version of ONTAP was released.
Steps
1. Locate the target ONTAP software in the Software Downloads area of the NetApp Support Site.
NetApp Downloads
2. Copy the software image (for example, 900_q_image.tgz) from the NetApp Support Site to the
directory on the HTTP or FTP server from which the image will be served.
Related information
13
For each HA pair, each node should have one or more ports on the same broadcast domain.
When a set of nodes is upgraded during a batch upgrade, the LIFs are migrated to the HA partner
nodes. If the partners do not have any ports in the same broadcast domain, then the LIF migration
fails.
Steps
1. If you do not plan to monitor the progress of the upgrade process, use the event route adddestinations command to send a notification if the upgrade encounters an error and requires
manual intervention.
In this example, if the upgrade pauses due to an error, a notification will be sent to the test_dest
event destination:
cluster1::> event route add-destinations -messagename
upgrademgr.update.pausedErr -destinations test_dest
Alternatively, you can configure an AutoSupport message to send your internal support
organization. An AutoSupport message with the title AUTOMATED NDU PAUSED will be
sent in case of upgrade errors.
This AutoSupport notification includes a record of the system status just prior to upgrade. It saves
useful troubleshooting information in case there is a problem with the upgrade process.
If your cluster is not configured to send AutoSupport messages, a copy of the notification is saved
locally.
3. Download the target ONTAP software package:
cluster image package get -url location
The software package contains the target ONTAP image and firmware, and the set of upgrade
validation rules. This package is downloaded to the cluster package repository on the root volume
of one of the nodes in the cluster.
Example
cluster1::> cluster image package get http://www.example.com/software/9.0/
image.tgz
Package download completed.
Package processing completed.
4. Verify that the software package is available in the cluster package repository:
cluster image package show-repository
Example
cluster1::> cluster image package show-repository
Package Version Package Build Time
---------------- -----------------9.0
2/25/2016 10:32:15
This command checks the cluster components to validate that the upgrade can be completed
nondisruptively, and then provides the status of each check and any required action you must take
before performing the software upgrade.
You can proceed to the next step after completing all identified required actions.
Example
cluster1::> cluster image validate -version 9.0
It can take several minutes to complete validation...
Pre-update Check
Status
Error-Action
--------------------- --------------------------------------------------Aggregate status
OK
CIFS status
OK
Cluster health
OK
status
.
.
.
The software upgrade estimate displays details about each component to be updated, and the
estimated duration of the upgrade.
7. Perform the software upgrade:
cluster image update -version package_version_number
This command validates that each cluster component is ready to be upgraded, installs the target
ONTAP image on each node in the cluster, and then performs a nondisruptive upgrade in the
background. If an issue is encountered, the update pauses and prompts you to take corrective
action. You can use the cluster image show-update-progress command to view details
about any issues and the progress of the update. After correcting the issue, you can resume the
update by using the cluster image resume-update command.
If the cluster consists of 2 through 6 nodes, a rolling upgrade is performed.
If the cluster consists of 8 or more nodes, a batch upgrade is performed by default. If desired, you
can use the -force-rolling parameter to specify a rolling upgrade instead.
Release Candidate Documentation - Contents Subject To Change
After completing each takeover and each giveback, the upgrade waits for 8 minutes to enable
client applications to recover from the pause in I/O that occurs during the takeover and giveback.
If your environment requires more or less time for client stabilization, you can use the
-stabilize-minutes parameter to specify a different amount of stabilization time.
Example
cluster1::> cluster image update -version 9.0
Starting validation for this update. Please wait..
It can take several minutes to complete validation...
WARNING: There are additional manual upgrade validation checks that must be
performed after these automated validation checks have completed successfully.
Refer to the Upgrade Advisor Plan or "Performing manual checks before an
automated cluster upgrade" section in the "Clustered Data ONTAP Upgrade
Express Guide" for the remaining manual validation checks that need to be
performed before update.
Failing to do so can result in an update failure or an I/O disruption.
Pre-update Check
--------------------Aggregate plex
resync status
Aggregate status
Broadcast Domain
status
CIFS status
Cluster health status
Cluster quorum status
Disk status
High Availability
status
LIF failover
LIFs not hosted
LIFs on home node
status
Manual checks
Status
Error-Action
---------- -------------------------------------------OK
OK
OK
OK
OK
OK
OK
OK
OK
OK
OK
Warning
MetroCluster
OK
configuration status
NDMP status
OK
NFS netgroup check
OK
Platform status
OK
SAN status
OK
SnapMirror status
OK
Volume status
OK
Overall Status
Warning
20 entries were displayed
Would you like to proceed with update ? {y|n}: y
Starting update...
cluster-1::>
To do this...
9. Display the cluster update history to verify that the upgrade was completed successfully for each
node:
cluster image show-update-history
Example
The ONTAP version numbers in the following example are provided for example purposes only:
cluster1::> cluster image show-update-history
Package
Start
Completion
Status
Version
Time
Time
---------- --------- ---------- ---------successful 9.0.y
03/21/2016 03/21/2016
15:20:51
15:44:13
successful 9.0.y
03/21/2016 03/21/2016
15:20:51
16:03:20
2 entries were displayed.
Component ID
-----------node0
Previous
Version
--------8.3.x
Updated
Version
--------9.0.y
node1
8.3.x
9.0.y
If your cluster is not configured to send AutoSupport messages, a copy of the notification is saved
locally.
Related information
17
Copyright information
Copyright 19942016 NetApp, Inc. All rights reserved. Printed in the U.S.
No part of this document covered by copyright may be reproduced in any form or by any means
graphic, electronic, or mechanical, including photocopying, recording, taping, or storage in an
electronic retrieval systemwithout prior written permission of the copyright owner.
Software derived from copyrighted NetApp material is subject to the following license and
disclaimer:
THIS SOFTWARE IS PROVIDED BY NETAPP "AS IS" AND WITHOUT ANY EXPRESS OR
IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE,
WHICH ARE HEREBY DISCLAIMED. IN NO EVENT SHALL NETAPP BE LIABLE FOR ANY
DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
POSSIBILITY OF SUCH DAMAGE.
NetApp reserves the right to change any products described herein at any time, and without notice.
NetApp assumes no responsibility or liability arising from the use of products described herein,
except as expressly agreed to in writing by NetApp. The use or purchase of this product does not
convey a license under any patent rights, trademark rights, or any other intellectual property rights of
NetApp.
The product described in this manual may be protected by one or more U.S. patents, foreign patents,
or pending applications.
RESTRICTED RIGHTS LEGEND: Use, duplication, or disclosure by the government is subject to
restrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and Computer
Software clause at DFARS 252.277-7103 (October 1988) and FAR 52-227-19 (June 1987).
18
Trademark information
NetApp, the NetApp logo, Go Further, Faster, AltaVault, ASUP, AutoSupport, Campaign Express,
Cloud ONTAP, Clustered Data ONTAP, Customer Fitness, Data ONTAP, DataMotion, Fitness, Flash
Accel, Flash Cache, Flash Pool, FlashRay, FlexArray, FlexCache, FlexClone, FlexPod, FlexScale,
FlexShare, FlexVol, FPolicy, GetSuccessful, LockVault, Manage ONTAP, Mars, MetroCluster,
MultiStore, NetApp Insight, OnCommand, ONTAP, ONTAPI, RAID DP, RAID-TEC, SANtricity,
SecureShare, Simplicity, Simulate ONTAP, Snap Creator, SnapCenter, SnapCopy, SnapDrive,
SnapIntegrator, SnapLock, SnapManager, SnapMirror, SnapMover, SnapProtect, SnapRestore,
Snapshot, SnapValidator, SnapVault, StorageGRID, Tech OnTap, Unbound Cloud, and WAFL and
other names are trademarks or registered trademarks of NetApp, Inc., in the United States, and/or
other countries. All other brands or products are trademarks or registered trademarks of their
respective holders and should be treated as such. A current list of NetApp trademarks is available on
the web.
http://www.netapp.com/us/legal/netapptmlist.aspx
19
[email protected]
To help us direct your comments to the correct division, include in the subject line the product name,
version, and operating system.
If you want to be notified automatically when production-level documentation is released or
important changes are made to existing production-level documents, follow Twitter account
@NetAppDoc.
You can also contact us in the following ways:
Index
A
feedback
how to send comments about documentation 19
B
back-end configurations
checking for errors before downgrading 11
batch upgrades
disabling automatic LIF rebalancing before 10
I
images, ONTAP software
obtaining 12
information
how to send feedback about improving
documentation 19
J
jobs
cluster upgrades
performing nondisruptive, using automated method
13
requirements for 7
clusters
ensuring that no jobs are running before upgrading
or downgrading 9
introduction to upgrade requirements for 7
performing manual checks on before upgrade 6
update workflow for 5
verifying upgrade limits before upgrading 8
comments
how to send feedback about documentation 19
configuration requirements
for cluster upgrades 7
configurations
SAN, verifying prior to upgrade 9
configurations, back-end
checking for errors before downgrading 11
D
documentation
how to receive automatic notification of changes to
19
how to send feedback about 19
downgrades
checking for back-end configuration errors before
downgrading 11
reviewing resources before performing 6
dump operations
verifying job status before upgrading or
downgrading 9
E
errors, back-end configuration
checking for, before downgrading 11
express guides
requirements for using the Upgrade Express Guide 4
L
LIFs
disabling automatic rebalancing for 10
limits
verifying before a cluster upgrade 8
M
MetroCluster configurations
where to find procedures for upgrading 4
mixed version requirements
for cluster upgrades 7
N
NetApp Support Site
obtaining ONTAP software images 12
nondisruptive upgrades
guidelines for estimating the duration of 8
using automated method for cluster 13
O
ONTAP software images
obtaining 12
P
partitioning, root-data
upgrade considerations for 8
partitioning, root-data-data
upgrade considerations for 8
pre-downgrades
reviewing resources for 6
pre-upgrades
reviewing resources for 6
Index | 21
R
release requirements
for cluster upgrades 7
requirements
for cluster upgrades 7
verifying job status before upgrading or
downgrading 9
resources
reviewing before upgrading or downgrading 6
restore operations
verifying job status before upgrading or
downgrading 9
reversions
obtaining ONTAP software images 12
root-data partitioning
upgrade considerations for 8
root-data-data partitioning
upgrade considerations for 8
S
SAN
verifying configuration prior to upgrade 9
software images, ONTAP
obtaining 12
storage systems using array LUNs
checking for back-end configuration errors before
downgrading 11
suggestions
how to send feedback about documentation 19
system limits
verifying before a cluster upgrade 8
U
updates, cluster software
workflow for 5
upgrades
considerations for root-data partitioning and rootdata-data partitioning 8
guidelines for estimating the duration of 8
introduction to requirements for cluster 7
manual checks before an automated cluster update 6
obtaining ONTAP software images 12
performing nondisruptive cluster, using automated
method 13
requirements for cluster 7
reviewing resources before performing 6
verifying limits for cluster 8
verifying SAN configuration prior to 9
where to find procedures for upgrading manually 4
V
volumes
verifying volume status before upgrading or
downgrading 9
W
workflows
for cluster software updates 5
T
Twitter