You are on page 1of 78

NetApp Internal Only  

Do Not Distribute
Troubleshooting Workshop for Partners
Version 2.3

Offered by: Global Support, Learning & Performance

Exercise Guide

 
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3
NetApp Internal Only

Do Not Distribute
This page left intentionally blank.

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 2


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

Copyright Information
Copyright © 2013 NetApp. All rights reserved. Printed in the U.S.A. Specifications subject to change
NetApp Internal Only

Do Not Distribute
without notice.
No part of this book 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
system—without prior written permission of the copyright owner.
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 or materials described
herein, except as expressly agreed to in writing by NetApp. The use or purchase of this product or
materials does not convey a license under any patent rights, trademark rights, copyrights or any other
intellectual property rights of NetApp, Inc.
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).
Trademark Information
NetApp, the NetApp logo, DataFabric, FAServer, FilerView, gFiler, MultiStore, NearStore, NetCache, SecureShare,
SnapManager, SnapMirror, SnapMover, SnapRestore, SnapVault, SyncMirror, Data ONTAP, SnapLock, SnapDrive,
and WAFL are registered trademarks of NetApp, Inc. in the United States and other countries. gFiler, Network
Appliance, SnapCopy, Snapshot, and The Evolution of Storage are trademarks of NetApp, Inc. in the United States
and/or other countries and registered trademarks in other countries. ApplianceWatch, BareMetal, Bolt design,
Camera-to-Viewer, ComplianceClock, ComplianceJournal, ContentDirector, EdgeFiler, FlexClone, FlexVol, FPolicy,
HyperSAN, InfoFabric, LockVault, Manage ONTAP, NOW, NOW NetApp on the Web, ONTAPI, RAID-DP, RoboCache,
RoboFiler, SecureAdmin, Serving Data by Design, SharedStorage, Simulate ONTAP, Simplicore, Smart SAN,
SnapCache, SnapDirector, , SnapFilter, SnapMigrator, SnapSuite, SnapValidator, SohoFiler, vFiler, VFM, VFM Virtual
File Manager, VPolicy, and Web Filer are trademarks of NetApp, Inc. in the United States and other countries.
NetApp Availability Assurance and NetApp ProTech Expert are service marks of NetApp, Inc. in the United States.
Spinnaker Networks, the Spinnaker Networks logo, SpinAccess, SpinCluster, SpinFS, SpinHA, SpinMove, and
SpinServer are registered trademarks of Spinnaker Networks, LLC in the United States and/or other countries.
SpinAV, Spin Manager, SpinMirror, SpinRestore, SpinShot, and SpinStor are trademarks of Spinnaker Networks, LLC
in the United States and/or other countries.
Apple is a registered trademark and QuickTime is a trademark of Apple Computer, Inc. in the United States and/or
other countries.
Microsoft is a registered trademark and Windows Media is a trademark of Microsoft Corporation in the United
States and/or other countries.
IBM is a registered trademark and AIX is a trademark of IBM Corporation 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.
NetApp is a licensee of the CompactFlash and CF Logo trademarks
All other brands or products are trademarks or registered trademarks of their respective holders and should
be treated as such.

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 3


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3
NetApp Internal Only

Do Not Distribute
This page left intentionally blank.

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 4


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

Table of Contents
NetApp Internal Only

Do Not Distribute
Module 0 Exercises – Connectivity 7

Module 1 Exercises – NetApp Hardware and Software 9

Module 2 Exercises – High Availability 16

Module 3 Exercises – Networking 17

Module 4 Exercises – CIFS 18

Module 5 Exercises – NFS 25

Module 6 Exercises – Performance 28

Module 7 Exercises – SAN 29

Module 8 Exercises – NDMPcopy, SnapMirror, SnapVault, and OSSV 44

Module 9 Exercises – Virtualization 70

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 5


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3
NetApp Internal Only

Do Not Distribute
This page left intentionally blank.

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 6


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

Module 0 Exercises – Connectivity


Lab 1 – Connectivity
NetApp Internal Only

Do Not Distribute
Descriptions and Instructions

NetApp Data ONTAP 7.3.5.1, FAS3140


Product
The Storage Controller is alive; however we cannot seem to get into it!
Description
Time estimate: 20 minutes

The Storage Controller is online, and it can serve data, but you cannot get into Data ONTAP
itself.
 Get into the Storage Controller, turn on the various ways to connect to it
o Hint: It is easier to use your Linux host for this lab. Run through the ways that
you can connect to Data ONTAP, and once you are in, turn on those options that
would make logging into the Storage Controller easier.
 Use the rlm status command to find out the RLM IP address for any labs requiring
a console display.

A very handy tool for you Linux host is nmap (Network Map). Nmap is a port scanner that
can be run against a host to determine what ports are available for use. To install this tool,
follow these simple steps:
 Login as root to your Linux host
Notes  Enter the command, ‘yum install nmap’
 You will be prompted to install the utility. Enter ‘y’ to install

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 7


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

Once nmap is installed, you can test it against your Storage Controller. This is a good
troubleshooting tool, and may assist you with this lab, as well as future labs in this course.
NetApp Internal Only

Do Not Distribute
You can enter ‘nmap’ on your Linux host to see the various switches and options that are
available.

Here is some example output using the nmap utility against a Storage Controller:

[root@ibm-host1e ~]# nmap -P0 10.251.192.81

Starting Nmap 4.11 ( http://www.insecure.org/nmap/ ) at 2012-


12-10 15:11 EST
Interesting ports on 10.251.192.81:
Not shown: 1670 closed ports
PORT STATE SERVICE
22/tcp open ssh
23/tcp open telnet
80/tcp open http
111/tcp open rpcbind
139/tcp open netbios-ssn
445/tcp open microsoft-ds
514/tcp open shell
2049/tcp open nfs
4045/tcp open lockd
10000/tcp open snet-sensor-mgmt
MAC Address: 00:A0:98:26:FB:D2 (Network Appliance)

Nmap finished: 1 IP address (1 host up) scanned in 0.154


seconds

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 8


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

Module 1 Exercises – NetApp Hardware and Software


NetApp Internal Only

Do Not Distribute
Hardware & Software Lab 1 – Reverting Data ONTAP

Descriptions and instructions

NetApp Data ONTAP 7.3.5.1, FAS3140


Product
Data ONTAP needs a major downgrade.
Description
Time estimate: 30 minutes

Notes Revert Data ONTAP which is running on your Storage Controller from 7.3.5.1 to
7.2.7.

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 9


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

Steps Actions

1. Use the following Classroom Web Server to do a software install


NetApp Internal Only

Do Not Distribute
on your Storage Controller of 7.2.7.

http://10.61.77.165/ONTAP/727_setup_q.exe

2. Issue the download command to write the new Data ONTAP to disk
and flash.

3. Reboot your Storage Controller.

4. Did everything work as expected? _____________________________

What happened, and why do you think it happened?

_________________________________________________________

_________________________________________________________

_________________________________________________________

_________________________________________________________

5. At your loader prompt, boot to the backup image of Data ONTAP to get
your Storage Controller back into working condition. Use the following
command:

LOADER> boot_backup

6. Discuss in class why the revert did not succeed.

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 10


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

Hardware & Software Lab 2 – Minor Revert of Data ONTAP

Descriptions and instructions


NetApp Internal Only

Do Not Distribute
NetApp Data ONTAP 7.3.5.1, FAS3140
Product
Data ONTAP needs a minor revert of Data ONTAP.
Description
Time estimate: 30 minutes

Notes Revert Data ONTAP which is running on your Storage Controller from 7.3.5.1 to
7.3.3P4

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 11


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

Steps Actions

1. Use the following Classroom Web Server to do a software install


NetApp Internal Only

Do Not Distribute
on your Storage Controller of 7.3.3P4

http://10.61.77.165/ONTAP/733P4_setup_e.exe

2. Issue the download command to write the new Data ONTAP to disk
and flash.

3. Reboot your Storage Controller.

4. Did everything work as expected? _____________________________

What happened, and why do you think it happened?

_________________________________________________________

_________________________________________________________

_________________________________________________________

_________________________________________________________

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 12


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

5. At your loader prompt, boot to the backup image of Data ONTAP to get
your Storage Controller back into working condition.
NetApp Internal Only

Do Not Distribute
6. Did the boot_backup work? Why/Why not?

_________________________________________________________

_________________________________________________________

_________________________________________________________

_________________________________________________________

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 13


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

Hardware & Software Lab 3 – Netbooting Data ONTAP

Descriptions and instructions


NetApp Internal Only

Do Not Distribute
NetApp Data ONTAP <BROKEN!>, FAS3140
Product
Netboot the Storage Controller
Description
Time estimate: 30 minutes

Notes Netboot the Storage Controller on 7.3.3P4, and install the correct version of
Data ONTAP.

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 14


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

Steps Actions

1. Refer to your Student Guide on the steps necessary to Netboot your


NetApp Internal Only

Do Not Distribute
Storage Controller on the correct version of Data ONTAP 7.3.3P4.

Use the following information to bring up your interface:


 Port to use – e0a
 IP Address - <Your_e0a_IP_Address>
 Netmask – 255.255.255.0
 Gateway – <Your_e0a_Gateway_Address>

Use the following link to netboot your Storage Controller:


 http://10.61.77.165/ONTAP/733P4_netboot.q

2. When you arrive at the 1-5 menu, use option 1 to boot normally.

3. Use the following Classroom Web Server to do a software install


on your Storage Controller of 7.3.3P4

http://10.61.77.165/ONTAP/733P4_setup_q.exe

4. Issue the download command to write the new Data ONTAP to disk
and flash.

5. At this point, let’s enable clustering on your Storage Controller.


Clustering should be licensed, but not enabled. Enter the following
command to enable clustering:

cf enable

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 15


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

Module 2 Exercises – High Availability


NetApp Internal Only

Do Not Distribute
High Availability Lab 1 – Cluster is Down

Descriptions and instructions

NetApp Data ONTAP 7.3.3P4, FAS3140c


Product

Description The Storage Controller is doing something strange

Time estimate: 60 minutes

For some reason, one of your Storage Controllers is down, and the other
Storage Controller is not taking over.

Notes We need both of these systems back up, and we need the clustering re-
enabled.

Hint: You may want to review your Student Guide’s Module on High Availability,
and consult the NetApp Knowledge Base for answers.

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 16


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

Module 3 Exercises – Networking


Networking Lab  – The Network Is Not Working Correctly
NetApp Internal Only

Do Not Distribute
Descriptions and instructions

NetApp Data ONTAP 7.3.3P4, FAS3140


Product

Time estimate: 15 minutes

The networking for your Storage Controller doesn’t seem correct.

1) Using your Linux host, try to ping the IP address of your Storage Controller.
Attempt to telnet to the Storage Controller.

Were you successful? _____________________________

Notes 2) Use your Classroom PC, open a CMD tool window and ping the IP address of
your Storage Controller. Attempt to telnet to the Storage Controller.

Were you successful? _____________________________

Use your RLM to log into your system and determine what the issues are.

Note, when you are finished, log out of the RLM, and verify that you can
telnet to the Storage Controller once again.

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 17


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

Module 4 Exercises – CIFS


NetApp Internal Only

Do Not Distribute
CIFS Lab 1 – Oplocks

Descriptions and instructions

NetApp Data ONTAP 7.3.5.1, FAS3140


Product
Increase in CIFS Operations
Description
Time estimate: 20 minutes

For this lab, you will perform the following:

 Create a share
Notes  Mount the share on your Windows host and copy some files into it,
while monitoring the CIFS ops that are being done.
 Copy those files again into the share, monitor the CIFS ops, and
compare the results

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 18


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

Steps Actions

1. Telnet to your Storage Controller. You should already have an


NetApp Internal Only

Do Not Distribute
aggregate on your Storage Controller called aggr1, and a 1Gb volume
from aggr1 called cifs1.
Once there, perform the following actions:

 Create an NTFS qtree called /vol/cifs1/mycifs


 Create a CIFS share called MYCIFS that points to
/vol/cifs1/mycifs

2. Remote desktop to your Windows host, and login as the domain


administrator.

3. Map a drive on your Windows hosts to your new CIFS share.

4. On your Storage Controller, begin a sysstat 1 . You will be


monitoring the CIFS Ops for this exercise.

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 19


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

5. There is a folder on your Windows host called c:\Backup_Folder. We’re


going to use that several times for this and other labs.
NetApp Internal Only

Do Not Distribute
Copy the c:\Backup_Folder to your CIFS share

Observe the CIFS Operations on the Storage Controller. What was the
maximum number of CIFS Ops per second during this copy procedure?

_________________________________________________________

6. Delete the Backup_Folder residing in your CIFS share.

7.
TELL YOUR INSTRUCTOR THAT YOU HAVE REACHED THIS POINT

8. Once your instructor has given his nod, login to the Storage Controller
again.

9. Perform the same operation again:


 Run the sysstat 1 on the Storage Controller
 Copy the c:\Backup_Folder to your CIFS share

10. Observe the CIFS Operations on the Storage Controller. What was the
maximum number of CIFS Ops per second during this copy procedure?

_________________________________________________________

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 20


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

11. Compare the 2 results.


NetApp Internal Only

Do Not Distribute
What is the difference?

_________________________________________________________

_________________________________________________________

Note that the differences may not appear very evident with a small,
single copy procedure. However multiple copies at various sizes will
show a marked different in the amount of network traffic overhead that is
needed with and without oplocks enabled.
Discuss this in class.

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 21


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

CIFS Lab 2 – Virus Scanning

Descriptions and instructions


NetApp Internal Only

Do Not Distribute
NetApp Data ONTAP 7.3.5.1, FAS3140
Product
Virus Scanning Example
Description
Time estimate: 30 minutes

For this lab, you will perform the following:

Notes  Turn on virus scanning


 Create a specific extension to scan
 Troubleshoot any problems that may arise

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 22


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

Steps Actions

1. Create a CIFS share, calling it whatever you wish. Mount your new
NetApp Internal Only

Do Not Distribute
CIFS share on your Windows host, and copy your c:\Backup_Folder to
your CIFS share. Note how long it takes to copy.

Now, change the share’s settings on the Storage Controller to include


virus scanning.

cifs shares –change <Your_Share> –vscan –vscanread

2. Enable Virus scanning. There is already an enterprise virus scanner


active and allowed for your Storage Controller. Enter the following
commands to enable and then show your virus scanning status:

filer1> vscan on
filer1> vscan

Lots of extensions, huh? We’re going to add to that list, just for the
practice.

Something to note is at the end it will list the # of files scanned and
scanned failures. They should both be 0.

3. You are going to create the same .MP3 extension for scanning that is in
your Student Guide. The steps are:

filer> fpolicy create MP3block screen

filer> fpolicy ext include set MP3block MP3

filer> fpolicy monitor set MP3block create,rename

filer> fpolicy options mP3block required on

filer> fpolicy enable MP3block -f

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 23


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

4. Excellent! On your Storage Controller, startup ‘sysstat 1’ and monitor


the activity for the next steps in the lab.
NetApp Internal Only

Do Not Distribute
Now go to your Windows host, and go back to the CIFS share that you
created and mounted. The Backup_Folder is still there, and we’re going
to overwrite it. Copy your c:\Backup_Folder to your CIFS Share. Select
‘yes’ and ‘overwrite’ to all questions that are asked.

5. Note that it took just a little bit longer to copy. CTRL-C the systat
command on the Storage Controller. Notice the large increase in
network activity?
Use the vscan command again. You may notice that the files scanned
is now over 200.

6.
LET YOUR INSTRUCTOR KNOW YOU HAVE REACHED THIS
POINT!

7. Try to once again overwrite the files on your CIFS share.

Why do you think it didn’t work?

________________________________________________________

________________________________________________________

8. Turning off virus scanning itself isn’t an option.

So how can we get it to work otherwise? Try to figure it out, and write
your answer here.

________________________________________________________

________________________________________________________

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 24


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

Module 5 Exercises – NFS


NFS Lab 1 – Stale Mounts
NetApp Internal Only

Do Not Distribute
Descriptions and instructions

NetApp Data ONTAP 7.3.3P4, FAS3140


Product
On your Linux system, you had 2 NFS exports mounted, and now they are
Description listed as Stale Mounts.

Time estimate: 15 minutes

You login to you Linux system, and notice that there are 2 mounts that have
been created to your Storage Controller. They are:

 /vol0 – This is the /vol/vol0 directory of your Storage Controller


 /mnt1 – This is a mount to /vol/cifs1/wide#, a mixed security qtree that has a
CIFS share and NFS export to service both protocols
o Where # = your Storage Controller number
Notes
 On your Storage Controller, create a 1Gb volume from aggr1 called nfs2.
 On your Linux host, create a directory called /mnt2, and mount the /vol/nfs2
volume there.
o Note: Case is important, so make sure you call your volume
‘/vol/nfs2’ in lower case.

If you look, you’ll notice that the /vol0 and /mnt1 mount points are listed as Stale
Mounts. You need to get your /mnt1 and /vol0 mount points working again.
Troubleshoot the problem and bring them back online.

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 25


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

NFS Lab 2 – User Mapping

Descriptions and instructions


NetApp Internal Only

Do Not Distribute
NetApp Data ONTAP 7.3.3P4, FAS3140
Product

Description You can no longer write to the /mnt1 mount point.


Time estimate: 30 minutes

Login to your Linux box and try to change into your /mnt1 directory. It will fail
with a Permission Denied! Something tells you that perhaps the user mapping
isn’t working correctly (hint hint).

Use the ‘wcc’ command to check out what’s going on.

Then create an /etc/usermap.cfg file on your Storage Controller which is


Notes appropriate. Verify your work with wcc by first clearing the cache and testing
both UNIX and NT users.

Go back to your Linux host and see if you can now change back into you /mnt1
mount point.

LET YOUR INSTRUCTOR KNOW WHEN YOU ARE FINISHED.

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 26


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

NFS Lab 3 – Mounting Problems

Descriptions and instructions


NetApp Internal Only

Do Not Distribute
NetApp Data ONTAP 7.3.3P4, FAS3140
Product

Description You can’t seem to mount /vol/nfs2 again.


Time estimate: 20 minutes

For some reason, you cannot get to your /mnt2 directory anymore. It was just
Notes an NFS volume on your Storage Controller you created earlier. Your task here
is to bring it back online once again.

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 27


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

Module 6 Exercises – Performance


NetApp Internal Only

Do Not Distribute
Performance Lab 1 – Filer Performance Suffering

Descriptions and instructions

NetApp Data ONTAP 7.3.3P4, FAS3140


Product

Description The Storage Controller is doing something strange

Time estimate: 30 minutes

Your Storage Controller is acting very strange. It looks like nothing is


communicating to the Storage Controller, yet writes and reads are large and
sporadic, and the CPU is bouncing around. However when they do connect to
the Storage Controller, their clients run very slow.

What you are required to do is:


Notes  Download perfstat
 Run perfstat against the Storage Controller, and your hosts that you believe
would contribute to the problem
 Use the perfviewer tool to look at the data.

Note that this lab does not need to be solved. It is meant for you understand
the tools that are available, and framing a case.

Bonus points to those who figure out what is going on.

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 28


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

Module 7 Exercises – SAN


NetApp Internal Only

Do Not Distribute
SAN – iSCSI Lab 0 - Provision Storage and License iSCSI
Step Action

1. Create two 10G Flexible Volumes on aggr1 named “vol1” and “vol2” by issuing the
following commands:
filerx> vol create vol1 aggr1 10G
filerx> vol create vol2 aggr1 10G

2. Make sure that iSCSI is enabled the Storage Controller.

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 29


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

3. Login to your Windows2k8R2 system as Administrator.


SnapDrive has been pre-installed into your Windows host for you to use. Many
NetApp Internal Only

Do Not Distribute
people will not have in-depth experience with this tool, so the following steps were
created for you to proceed. To launch SnapDrive, go to:
Start -> Administrative Tools -> Computer Management.
SnapDrive is listed under Storage. Selecting it will start the service. Under
SnapDrive open up your computer name listed there, and click on Disks. When
Disks is open, right click on the name “Disks” and select “Create Disk”

Use the SnapDrive Create Disk Wizard to:

 Create a LUN /vol/vol1


 LUN Name = lun1
 LUN Size = 1Gb
 LUN Type = windows_2008
 Drive Letter = <whichever is available>
 Everything else should be default

When complete, your SnapDrive screen should look similar to the picture below.
Note the picture is an example only; your LUN will look different.
WHEN YOU ARE FINISHED, LET YOUR INSTRUCTOR KNOW.

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 30


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

SAN – iSCSI Lab 1 – LUN Not Accessible

Descriptions and instructions


NetApp Internal Only

Do Not Distribute
Data ONTAP 7.3.3P4, FAS3140
Product
Windows iSCSI LUN is offline
Symptom
Time estimate – 30 minutes

Looking at your Windows host, you see that your mapped LUN you just created with
SnapDrive is offline. Not only that, but SnapDrive itself does not seem to be
working. The object is to get the LUN back online quickly, so you are tasked with:

 Troubleshoot the Storage Controller to find out why things are not working
Notes correctly
 Forget about getting SnapDrive working and use the iSCSI service itself to
attach back to the Storage Controller and re-map your LUN

After that is completed, bonus points go to those that can figure out why SnapDrive
isn’t working, and get it functional again.

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 31


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

SAN – iSCSI Lab 2 – iSCSI LUN Offline

Descriptions and instructions


NetApp Internal Only

Do Not Distribute
Data ONTAP 7.3.3P4, FAS3140
Product
Your iSCSI map is once again no longer online
Symptom
Time estimate – 15 minutes

Once more, your iSCSI map is no longer functioning. Troubleshoot the


problem, fix things, and re-map your iSCSI LUN on your Windows host.

Notes
Hint: After you have fixed the problem, you will more than likely have to
refresh iSCSI Windows host in the iSCSI Initiator Control Panel, for your
Windows host to allow for access again.

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 32


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

SAN – FCP Lab 0 – Configure fiber channel ports 0c and 0d as targets.


Step Action
NetApp Internal Only

Do Not Distribute
1. Telnet into your Storage Controller using the remote console. The IP and port information
are on the IP handout.
2. The Storage Controller FC adapters are required to be in ‘target’ mode in order to connect to
the fabric correctly. Sometimes on newly installed Storage Controllers, the ports are all set
to ‘initiator’. The following steps are in this lab in case your classroom Storage Controllers is
not setup correctly. Note that if you run the ‘fcadmin config’ command, and see that
adapters 0c and 0d are setup as ‘target’, you can skip this section, and go on to the next lab,
“Create and connect to a LUN”.

Issue the following command:


filerx> fcadmin config
The output will look something like this:
Adapter Type State Status
---------------------------------------------------
0a initiator UNDEFINED online
0b initiator UNDEFINED online
0c initiator UNDEFINED online
0d initiator UNDEFINED online

In this case ports 0c and 0d are configured as initiators and need to be reconfigured. If ports
0c and 0d are targets and online nothing else needs to be done.

Note: If the Status reads ‘offline’ for adapters 0c and 0d, make sure that FCP has been
enabled.
3. Issue the following command:
filerx> reboot
When prompted to “Press CTRL-C for special boot menu”, press CTRL-C

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 33


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

4. When the prompt shown below appears select 5 for Maintenance mode boot.
Starting boot on Mon Mar 5 13:39:13 GMT 2007
NetApp Internal Only

Do Not Distribute
(1) Normal boot.
(2) Boot without /etc/rc.
(3) Change password.
(4) Initialize all disks.
(4a) Same as option 4, but create a flexible root volume.
(5) Maintenance mode boot.
Selection (1-5)? 5
5. At the prompt issue the following commands:
*> fcadmin offline 0c
*> fcadmin offline 0d
*> fcadmin config -t target 0c
*> fcadmin config -t target 0d
6. Reboot the filer by issuing the following commands:
*> halt
LOADER> bye
7. Check your work by issuing the following command:
filerx> fcadmin config
The output should look like this:
Adapter Type State Status
---------------------------------------------------
0a initiator UNDEFINED online
0b initiator UNDEFINED online
0c target CONFIGURED online
0d target CONFIGURED online

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 34


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

Create and connect to a LUN


Step Action
NetApp Internal Only

Do Not Distribute
1. You will need the Linux FCP ports in order to be able to add them to the igroup. To do
this, login to your Linux host and run the following command:

linux# sanlun fcp show adapter

sanlun is part of the NetApp Host Utilities, and necessary for any flavor of UNIX to
collect information used by support. Here is a sample output for comparison:

[root@IBM-Host1B ~]# sanlun fcp show adapter

host3 WWPN:10000000c9787a8a

host4 WWPN:10000000c9787a8b

Note the ‘host#’ and the WWPN.

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 35


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

2. Now on your Storage Controller, run the command:

filer1> fcp show initiators


NetApp Internal Only

Do Not Distribute
This will tell you what the Storage Controller can see, here is some sample
output:

filer1> fcp show initiators


Initiators connected on adapter 0c:
Portname Group
-------- -----
21:00:00:e0:8b:86:a4:40
21:00:00:e0:8b:89:59:2d
21:00:00:e0:8b:86:31:42
21:00:00:e0:8b:86:7b:41
10:00:00:00:c9:77:75:a0
10:00:00:00:c9:77:75:0a
10:00:00:00:c9:77:75:ce
10:00:00:00:c9:78:7a:8a

Initiators connected on adapter 0d:


Portname Group
-------- -----
21:01:00:e0:8b:a6:a4:40
21:01:00:e0:8b:a6:31:42
21:01:00:e0:8b:a6:7b:41
21:01:00:e0:8b:a9:59:2d
10:00:00:00:c9:77:75:a1
10:00:00:00:c9:77:75:0b
10:00:00:00:c9:77:75:cf
10:00:00:00:c9:78:7a:8b

What is common between the Linux and the Storage Controller data? Notice on
adapter 0c the WWPN 10:00:00:00:c9:78:7a:8a appears, which matches
host3 on the Linux host. Also notice adapter 0d the WWPN
10:00:00:00:c9:78:7a:8b appears, which matches host4 on the Linux system.

So we’re going to use both of those WWPNs in our iGroup for the next step.

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 36


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

3. . Create a LUN on the Storage Controller for FCP using the lun setup command.
Provide the following values:
NetApp Internal Only

Do Not Distribute
 LUN = /vol/vol2/lun2
 Type = linux
 Size = 1g
 Name of initiator group [windows_fcp]: linux_fcp
 Initiator Group Members is the WWPN that you noted in the above steps.
Add both the WWPN’s that you saw earlier on the Linux host.
4. Since we have multiple paths from the Linux host to the Storage Controller, we’re
going to enable multipathing.
On the Linux host, type the command:

service multipathd start

5. On the Linux host, use the command:

sanlun lun show all

Did you see your new LUN? If you did, that’s great, but not likely. The Linux host
needs to re-scan it’s BUS to show the new LUN. To do this, you need to issue the
command below EXACTLY as it is shown. You need to re-scan the hosts host3 and
host4 that you used in the above steps.

echo “- - -“ > /sys/class/scsi_host/host3/scan

echo “- - -“ > /sys/class/scsi_host/host4/scan

Note that in double-quotes, there are 3 dashes separated by spaces. So it would be


double-quote dash <space> dash <space> dash double-quote. That’s important, and
easy to miss. Those 3 dashes tell the host to rescan the BUS.

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 37


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

6.
Now run the sanlun command again and see if you can see your Storage
Controller’s new FCP LUN. Here’s an example of what you should see:
NetApp Internal Only

Do Not Distribute
[root@IBM-Host1B ~]# sanlun lun show all
controller: lun-pathname device filename adapter protocol lun size lun state
filer1: /vol/vol2/lun2 /dev/sdd host4 FCP 1g (1073741824) GOOD
filer1: /vol/vol2/lun2 /dev/sde host4 FCP 1g (1073741824) GOOD
filer1: /vol/vol2/lun2 /dev/sdc host3 FCP 1g (1073741824) GOOD
filer1: /vol/vol2/lun2 /dev/sdb host3 FCP 1g (1073741824) GOOD

We’re seeing the same LUN 4 times? 2 adapters on the host each going
through 2 adapters on the Storage Controller makes 4 paths to the LUN. In the
next few commands, this will become more clear. Let’s configure the LUN
using multipathing, so if there’s 1 link that fails, the LUN will still be visible
and able to serve data.
Note: If you want to see what the NetApp multipath config is for Linux, check
out /etc/multipath.conf.

7. Since we turned on multpathing earlier, we’re going to use the device for that.
Let first do a check to make sure that ALUA is enabled on the drives. By
default, it should be, and it is what is generally preferred to be used. Issue the
command:

multipath –ll

Note that the command option above is 2 lower case letter ‘L’s, not the number
one. Here is a sample of what you will see. Note the bolded area below that
will tell you if ALUA is being used:

root@IBM-Host1B ~]# multipath -ll


360a98000486e2f706c5a6c7a49665438 dm-2 NETAPP,LUN
[size=1.0G][features=1 queue_if_no_path][hwhandler=1 alua][rw]
\_ round-robin 0 [prio=100][active]
\_ 3:0:1:0 sdc 8:32 [active][ready]
\_ 4:0:1:0 sde 8:64 [active][ready]
\_ round-robin 0 [prio=20][enabled]
\_ 3:0:0:0 sdb 8:16 [active][ready]
\_ 4:0:0:0 sdd 8:48 [active][ready]

Note the ‘dm-2’ in the above data. This command is showing you what the
multipath device is for the current configuration.

Let’s check the sanlun command now.

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 38


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

8. Use the command:

sanlun lun show –p


NetApp Internal Only

Do Not Distribute
Here is some sample output. Note the DM-MP DevName bolded below. The
name at the end should start with ‘dm-#’. In this example, it is dm-2. That
device is what you’re going to use as your drive on the Linux host.

This command may make things more clear the hosts# and the
primary/secondary controller ports that make up the 4 devices.

[root@IBM-Host1B ~]# sanlun lun show -p

filer1:/vol/vol2/lun2 (LUN 0) Lun state: GOOD


Lun Size: 1g (1073741824) Controller_CF_State: Cluster Enabled
Protocol: FCP Controller Partner: filer2b
DM-MP DevName: 360a98000486e2f706c5a6c7a49665438 dm-2
Multipath-provider: NATIVE
------- ---------- ------- -------- ----------------- ---------------
sanlun Controller Primary Partner
path Path /dev/ Host Controller Controller
state type node HBA port port
------- ---------- ------- -------- ----------------- ---------------
GOOD primary sdc host3 0c --
GOOD primary sde host4 0d --
GOOD secondary sdb host3 -- 0d
GOOD secondary sdd host4 -- 0c

9. Prepare and mount the drive. In our example, we’re going to use /dev/dm-2.
Use whichever drive you were show in your output above.

# fdisk /dev/dm-2

So you won’t spend a lot of cycles wondering how Linux fdisk works, use the
following as a step-by-step guide. Note that these are fdisk commands
below, and used after running fdisk:

n = new partition
p = primary partition
1 = partition number
Use all the cylinders
w = write the partition table

NOTE: DO NOT REBOOT YOUR LINUX SYSTEM! The fdisk command will
prompt you to reboot, however in these labs it is not necessary.

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 39


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

10. Create the file system on the Linux host with the following command. Use
whichever device (/dev/dm-2) that you just partitioned. You will be
prompted to format the entire device, you should answer ‘y’.
NetApp Internal Only

Do Not Distribute
mkfs -t ext3 /dev/dm-2
11. Let’s create a directory and mount our LUN. Again, use your /dev/dm-2 that
you partitioned above.

mkdir /linux_lun
mount /dev/dm-2 /linux_lun

To make the mapping persistent add the following line to /etc/fstab:

/dev/dm-2 /linux_lun ext3 defaults 0 0

12. Change into the /linux_lun directory, and let’s just copy a file into it, just to
know that we can use it.

cp /etc/hosts /linux_lun/file1

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 40


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

SAN – FCP Lab 1 – LUN Cloning


Descriptions and instructions
NetApp Internal Only

Do Not Distribute
Product Data ONTAP 7.3.3p4, NetApp 3140

Symptom You need a LUN clone of your FCP LUN

Time estimate: 20 minutes


 Create a LUN clone of your FCP LUN called /vol/vol2/lun2
Notes
 Split the clone away from the parent
 mount the new LUN on the Linux host

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 41


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

1. . Create a LUN clone of /vol/vol2/lun2. Start with the following information:


NetApp Internal Only

Do Not Distribute
 Create a volume snapshot of vol2 called clone_snap
 Create a clone of /vol/vol2/lun2 called lun2_clone using the snapshot above

Do a snap list of vol1and see that you have a snapshot that’s (busy,LUNs).

2. Now split the lun2_clone from the parent snapshot. When it is finished, check:

snap list vol2 – notice that the snapshot clone_snap is no longer busy (and
can be deleted!)
lun show – will now show you have a new lun called /vol/vol2/lun2_clone.

3.  Ok, so let’s login to your Linux host now. We’re going to be doing work here,
but first, let’s copy another file into your /linux_lun directory.

cp /etc/passwd /linux_lun/file2
4. Now, remember how we earlier mounted /vol/vol2/lun2 on the Linux host? That’s
your task now for the lun2_clone. Here’s some tips:

Remember to:
 Map your LUN to an igroup
 Rescan your Linux BUS, and then use ‘sanlun lun show –p’ to show the new
device
 Make a directory called /linux_clone and mount your new device
5. Successful?
List out the contents of /linux_clone. Do you see the file1 file we had there earlier?
List out the contents of /linux_lun. Do you see file1 and file2?

Everything that was inside that snapshot was saved, and can be brought back just
that easy. You just cannot delete the snapshot that is backing a LUN.

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 42


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

SAN – FCP Lab 2 – nSANity


Descriptions and instructions
NetApp Internal Only

Do Not Distribute
Product Data ONTAP 7.3.3P4, FAS3140, SnapDrive 6.x

Symptom You need support data on your SAN environment

Time estimate: 30 minutes


In support, you often need data to be able to start your analysis. One of the more useful
tools to have is nSANity. It is a data collector which will retrieve information on the Storage
Controller, hosts, switches, and more.

Download nSANity from the NOW site and place it on your classroom PC. Extract the
content, and use nSANity to collect data on your Storage Controller (both yours and your
Notes partners), your Windows host, and your Linux host.

Once you have the data, normally the next step would be to upload the file to NetApp for
analysis. However, if you wish to view the data that was collected, you can use nSANity with
the –x EXTRACT option against the file. This option will unarchive all of the commands that
were used to generate data. Note that there will be a lot of files that will be extracted n the
end.

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 43


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

Module 8 Exercises – NDMPcopy, SnapMirror, SnapVault,


and OSSV
NetApp Internal Only

Do Not Distribute
Exercise 1: NDMPcopy Failure

Scenario
Description and instructions

Product Data ONTAP 7.3.3P4, FAS storage system, Windows Domain

Description ndmpcopy is failing.

Notes For some unknown reason, ndmpcopy is failing.

Your task is to find out what the issue is and address it.

Follow the notes below to begin the lab. Note that you will be
using both Storage Controllers in the cluster for this lab.

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 44


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

Steps Actions

1. Note, for this lab you will be utilizing both Storage Controllers in the
NetApp Internal Only

Do Not Distribute
cluster. The Storage Controller prompts dictate which one should be
issuing the commands:
 filer1 = The odd numbered Storage Controllers (filer1x, filer3x,
filer5x, filer7x)
 filer2 = The even numbered Storage Controller (filer2x, filer4x,
filer6x, filer8x)

Verify the following to provision the storage systems for this scenario.

Each storage system has a five disk aggregate. (aggr1 should already
exist and meet the need for this lab.)
On filer1, create a 1GB volume called srcvol1 in aggr1
On filer2, create a 1GB volume called dstvol1 in aggr1

2. Enable the NDMP service and set NDMP access to all for on both
storage systems.
filer1> options ndmpd.enable on
filer1> options ndmpd.access all

Verify the NDMP settings.


filer2> options ndmp

The expected outputs should be as follows, correct these parameters if


needed.
ndmpd.access all
ndmpd.authtype challenge
ndmpd.connectlog.enabled off
ndmpd.enable on
ndmpd.ignore_ctime.enabled off
ndmpd.offset_map.enable on
ndmpd.password_length 16
ndmpd.preferred_interface disable
ndmpd.tcpnodelay.enable off

3. Turn on logging during backup.


filer2> options backup.log.enable on

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 45


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

4. Enable logging of NDMP connections attempts.


NetApp Internal Only

Do Not Distribute
filer1> options ndmpd.connectlog.enabled on

filer2> options ndmpd.connectlog.enabled on

5. Display the NDMP version that the storage systems support.


filer1> ndmpd version

filer2> ndmpd version


The expected result should look like this:
ndmpd highest version set to: 4

6.
STOP: Let the instructor know when you reach this point.

7. Perform the data transfer from the source volume to the destination
volume using the ndmpcopy command from the destination.

filer2> ndmpcopy –sa root:passwd -da root:passwd


filer1:/vol/srcvol1 filer2:/vol/dstvol1

The expected result should look like this:

Ndmpcopy: filer6e: Log: RESTORE: Message from Read


Socket : Connection reset by peer
Ndmpcopy: filer6e: Log: RESTORE: RESTORE IS ABORTED
Ndmpcopy: filer5e: Notify: dump failed
Ndmpcopy: filer6e: Notify: restore failed
Ndmpcopy: Transfer failed
Ndmpcopy: Done

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 46


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

Exercise 2: SnapMirror Exercises


Description and instructions
NetApp Internal Only

Do Not Distribute
Product Data ONTAP 7.3.3P4, FAS3140

Description Volume and Qtree SnapMirror creation, breaking, re-syncing, and


compression.

Notes You are tasked with:


 Building a volume and qtree SnapMirror relationship
 Breaking that relationship
 Resyncing the SnapMirror correctly
 Enabling compression on your volume SnapMirror

Follow the notes below to begin the lab. Note that you will be
using your own Storage Controller for this lab to allow students
more time to use all the commands used to setup, configure,
manage, and destroy the mirrors.

Note that for the following labs, replace all instances of


“filerA” with the hostname of your Storage Controller!

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 47


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

Volume SnapMirror Basics


Steps Actions
NetApp Internal Only

Do Not Distribute
1. Verify the following to provision the storage systems for this scenario.

Each storage system has a five disk aggregate. (aggr1 should already
exist and meet the need for this lab.)
On your Storage Controller, create the following:

Two 100Mb volumes called srcvol2 and dstvol2 in aggr1

In order to give everyone practice with SnapMirror, you will be creating


these relationships on your own Storage Controller

2. Verify that dstvol2 is the same size or larger than srcvol2 on the other
Storage Controller with the vol status –b command.
Example:
filerA> vol status –b srcvol2
Volume Block Size (bytes) Vol Size (blocks) FS Size
(blocks)
------ ------------------ ------------------ -------------
srcvol2 4096 25600 25600

Verify that dstvol2 is the same size or large than srcvol2.


Example:
filerA> vol status –b dstvol2
Volume Block Size (bytes) Vol Size (blocks) FS Size
(blocks)
------ ------------------ ------------------ -------------
dstvol2 4096 25600 25600

3. At the system prompt, restrict the destination volume for the other
Storage Controller with the vol restrict command.

filerA> vol restrict dstvol2


Volume dstvol2 is now restricted

Use the vol status command to verify that the dstvol2 is now
restricted.

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 48


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

Step

This step will specify the destinations hosts that are allowed to access
NetApp Internal Only

Do Not Distribute
4.
the source. For the purpose of this exercise, the destination host and the
source are the same.

Use the snapmirror.access option to verify the current configuration and


specify the hosts allowed. For example, enter the following but enter
your Storage Controller name for “filer#’

filerA> options snapmirror.access


snapmirror.access legacy
filerA> options snapmirror.access host=filerA
filerA> options snapmirror.access
snapmirror.access host=filerA

5. Configure the /etc/snapmirror.conf file for the volume snapmirror


configuration. The qtree snapmirror configuration will be performed in a
future step. This file defines the following for the destination Storage
Controller, which is filerA:
 The relationship between the source and destination
 The schedule used by the destination to copy data from the source
 The arguments that control SnapMirror when copying data.

Enter the following entries in the /etc/snapmirror.conf file using vi,


wrfile, or other text editor. Remember, the first Storage Controller entry
on the line is the source; the second Storage Controller entry on the line
is the destination. Your input should look similar to the following:

filerA> wrfile /etc/snapmirror.conf


filerA:srcvol2 filerA:dstvol2 - * * * *
<CTRL-C>

6. Start SnapMirror

At the system console of the source and destination appliances, use the
snapmirror on command to turn on SnapMirror. Enter the following:
filerA> snapmirror on

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 49


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

Step

Use the vol status -v command to verify the current status of vol0,
NetApp Internal Only

Do Not Distribute
7.
srcvol2 and dstvol2.
What is the status of vol0; is it online or restricted?
What is the snapmirrored status of vol0; is it on or off?
What is the status of srcvol2; is it online or restricted?
What is the snapmirrored status of srcvol2; is it on or off?
What is the status of dstvol2; is it online or restricted?
What is the snapmirrored status of dstvol2; is it on or off? _

8. The snapmirror initialize command will start the transfer from the source
to the destination. It uses the /etc/snapmirror.conf file on filerA as its
map for what to transfer.

Make the first baseline transfers using the snapmirror initialize


command. Remember, that everything is case sensitive.

filerA> snapmirror initialize –S filerA:srcvol2 filerA:dstvol2

9. At the system console, enter the snapmirror status command several


times until the transfer completes. Observe that the system display
shows the Source, Destination, State, Lag, and Status headings. Verify
that the values shown under these headings are reasonable for the
current exercise. When the transfer completes, your output should look
similar to the following:

filerA> snapmirror status


Snapmirror is on.
Source Destination State Lag Status
filerA:srcvol2 filerA:dstvol2 Snapmirrored 00:01:33 Idle

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 50


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

Qtree SnapMirror Basics.


Steps Actions
NetApp Internal Only

Do Not Distribute
1. When setting up a destination volume for qtree snapmirror the
destination volume should be online and not restricted.
At the system prompt, verify that the destination volume for the other
Storage Controller is online.

2. Create a qtree on the source volume.

filerA> qtree create /vol/vol0/src_qtree

3. Use the qtree status command to verify your work

Here is an example:
filerA> qtree status
Volume Tree Style Oplocks Status
------------ ---------- ----- -------- ---------
vol0 unix enabled normal
vol0 src_qtree unix enabled normal
srcvol2 unix enabled normal
dstvol2 unix enabled normal

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 51


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

Step

You are going to add a configuration for a qtree snapmirror for a qtree
NetApp Internal Only

Do Not Distribute
4.
on vol0 of the to a qtree on the same vol0.

Add the required entries for a qtree snapmirror in the


/etc/snapmirror.conf file. When specifying the source for a qtree you
must give the full path and the qtree must already exist. When
specifying the destination you must also specify the full path but the
qtree destination must not already pre-exist. For the purposes of this
configuration the destination qtree name is going to be “dst_qtree”. The
results of your entry should look similar to the following:

(Note, the command below is all on 1 line).

filerA> wrfile –a /etc/snapmirror.conf filerA:/vol/vol0/src_qtree


filerA:/vol/vol0/dst_qtree - * * * *

Check the /etc/snapmirror.conf file to verify that


it’s correct.

filerA> rdfile /etc/snapmirror.conf


filerA:srcvol2 filerA:dstvol2 - * * * *
filerA:/vol/vol0/src_qtree filerA:/vol/vol0/dst_qtree - * * * *

SnapMirror is already started, but reissuing the snapmirror on command


5.
will cause SnapMirror to reread the /etc/snapmirror.conf file and
implement any configuration changes that have been made. Enter the
following command:

filerA> snapmirror on

Issue a snapmirror initialize command to start the transfer from of the


6.
src_qtree to the dst_qtree. It uses the /etc/snapmirror.conf file on filerA
as its map for what to transfer.

Make the first baseline transfer for the qtree using the snapmirror
initialize command

(Note, the command below is all on 1 line).

filerA> snapmirror initialize –S


filerA:/vol/vol0/src_qtree filerA:/vol/vol0/dst_qtree

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 52


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

Step

At the system console, enter the snapmirror status command several


NetApp Internal Only

Do Not Distribute
7.
times until the transfer completes. Observe that the system display
shows the Source, Destination, State, Lag, and Status headings. Verify
that the values shown under these headings are reasonable for the
current exercise. When the transfer completes, your output should look
similar to the following:
filerA> snapmirror status

Snapmirror is on.
Source Destination State Lag Status
filerA:/vol/vol0/src_qtree filerA:/vol/vol0/dst_qtree Snapmirrored 00:00:53 Idle
filerA:srcvol2 filerA:dstvol2 Snapmirrored 00:00:52 Idle

Convert a read-only SnapMirror volume to read-write


One reason to convert a read-only SnapMirror volume to read-write is to turn the destination into
a stand-alone copy because the source has suffered some sort of catastrophe and is not
available for an unacceptable length of time. In this exercise we are going to assume that the
srcvol2 volume has suffered a catastrophe.

Step

1. In order to mimic a catastrophe with the srcvol2 volume, we are going to turn
the volume off. In order to do that, we need to shutdown snapmirror first.

filerA> snapmirror off

If there are any running snapmirror jobs will start to give errors, since
they are terminating abnormally.
Turn the srcvol2 volume offline. Note that if there are any snapmirror
jobs that have not timed out, then you will not be able to turn the
volume offline. If this is the case, wait several seconds and try the
command again until you are successful.

filerA> vol offline srcvol2

Now that the srcvol2 volume is offline, turn snapmirror back on again.
You will see errors that the source is unreachable.

filerA> snapmirror on

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 53


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

Step

Check the available volumes on the system. Note you may have to wait up
NetApp Internal Only

Do Not Distribute
2.
to 60 seconds for the snapmirror to update.

filerA> vol status

Check the snapmirror status on the system


filerA> snapmirror status

The status output from these commands should not indicate any errors. The
snapmirror transfer error messages being written to the console,
/etc/messages and /etc/log/snapmirror file are the indication that there is
something wrong with the filerA site.

3. Since we’re simulating a catastrophe on the volume SnapMirror, we are also


going to break the qtree SnapMirror to see how that works as well.

When breaking a qtree SnapMirror, Snapmirror needs to be turned on.


Enter the following command to quiesce the qtree mirror.

filerA> snapmirror quiesce filerA:/vol/vol0/dst_qtree


snapmirror quiesce: in progress
This can be a long-running operation. Use Control - C
(^C) to interrupt.
snapmirror quiesce: /vol/vol0/dst_qtree : Successfully
quiesced

4. Enter the following command to break the qtree mirror of.

filerA> snapmirror break filerA:/vol/vol0/dst_qtree


snapmirror break: Destination /vol/vol0/dst_qtree is now
writable.

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 54


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

Step

Now, let’s take care of the volume Snapmirror and make the dstvol2 volume
NetApp Internal Only

Do Not Distribute
5.
read-writeable. Before beginning this procedure you should turn off
SnapMirror. This prevents SnapMirror from trying to perform updates and
unintentionally updating the destination qtree and volumes from the source
qtrees or volumes. It will also suppress the error messages that are sure to
be displayed on the console.
Enter the following command on filerA

filerA> snapmirror off

Check the snapmirror status on the system


filerA> snapmirror status

6. Enter the following command to break the mirror of filerA:srcvol2 on


filerA:dstvol2

filerA> snapmirror break filerA:dstvol2


snapmirror break: Destination dstvol2 is now writable.
Volume size is being retained for potential snapmirror
resync. If you would like to grow the volume and do not
expect to resync, set vol option fs_size_fixed to off.

7. Check the snapmirror status on the system. Your results should look similar
to the output below.

filerA> snapmirror status


snapmirror status
Snapmirror is off.
Source Destination State Lag
Status
filerA:/vol/vol0/src_qtree filerA:/vol/vol0/dst_qtree Broken-off 00:00:47
Idle
filerA:srcvol2 filerA:dstvol2 Broken-off 00:33:17
Idle

8. Using an NFS export mount the vol0 and dstvol2 volumes for filerA from your
Unix adminhost or if you prefer, create CIFS shares for each of the volumes
and open them from your Windows host.

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 55


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

Step

Access /vol/dstvol2/ and /vol/vol0/dst_qtree on filerA and delete or create some


NetApp Internal Only

Do Not Distribute
9.
new files or directories. Write down a summary record of your changes.

Changes to /vol/dstvol2:

Changes to /vol/vol0/dst_qtree:

Resync the mirrors


The specific steps taken to resynchronize broken mirrors after a catastrophe is going to vary
from site to site. In this scenario we have two mirrors that were broken and made read-
writeable. Those were:
 filerA:dstvol2 which was a volume snapmirror
 filerA:/vol/vol0/dst_qtree which was a qtree snapmirror
The resynchronization process effectively involves reversing the source destination relationship
temporarily for one resync. That is; the dstvol2 volume is the temporary source and srcvol2
volume is the temporary destination. Then there is a second resync which reestablishes the
original relationship between the two volumes.

Step
In order to start the resync, snapmirror needs to be turned on and the volume
1.
re-enabled. Enter the following commands.

filerA> snapmirror on

filerA> vol online srcvol2

Because the mirrors were broken and the volumes are not in an appropriate
state for snapmirror to execute the updates as defined in the
/etc/snapmirror.conf file you will get error messages on the console.

These messages can be ignored for now.

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 56


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

Step

Before starting the resync for dstvol2 volume to the srcvol2 volume,
NetApp Internal Only

Do Not Distribute
2.
applications and users must stop accessing the dstvol2 volume. This also
applies for the resync of the dst_qtree to the src_qtree.

Start the resync for srcvol2. Notice that we are using dstvol2 volume as the
3.
source because it has the most recent updates and the srcvol2 volume as
the destination . Enter the following command.

filerA> snapmirror resync -S filerA:dstvol2


filerA:srcvol2

The resync base snapshot will be:


filerA(0033604816)_dstvol2.221
These newer snapshots will be deleted from the destination:
hourly.0
nightly.0
hourly.1
hourly.2
Are you sure you want to resync the volume? y
Sun Sep 11 08:12:02 PDT [filerA:
snapmirror.dstvol2.resync.info:notice]: SnapMirror resync of
srcvol2 to filerA:dstvol2 is using filerA(0
033604816)_dstvol2.221 as the base snapshot.
Volume srcvol2 will be briefly unavailable before coming back
online.
Sun Sep 11 08:12:02 PDT [filerA: config_async_0:notice]: CIFS
- disabled for volume srcvol2
Share srcvol2 disabled while volume srcvol2 is offline.
Volume srcvol2 is now restricted.
Sun Sep 11 08:12:03 PDT [filerA: config_async_0:notice]:
Reverting volume srcvol2 to a previous snapshot (snapid 2).
Share srcvol2 activated.
Volume 'srcvol2' is now online.
Revert to resync base snapshot was successful.
Sun Sep 11 08:12:03 PDT [filerA:
snapmirror.dstvol2.resync.success:notice]: SnapMirror resync
of srcvol2 to filerA:dstvol2 successful.
Transfer started.
Monitor progress with 'snapmirror status' or the snapmirror
log.

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 57


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

Step

The SnapMirror resync command used a baseline snapshot for the resync.
NetApp Internal Only

Do Not Distribute
4.
Now use the SnapMirror update command to request any changes made
since the baseline snapshot was used. Issue the following command to
complete the synchronization of filerA:dstvol2 with filerA:srcvol2

filerA> snapmirror update -S filerA:dstvol2


filerA:srcvol2
Transfer started.
Monitor progress with 'snapmirror status' or the
snapmirror log.

5.
Enter the following command.
filerA> vol status srcvol2
Is srcvol2 in a read-write state?

filerA> vol status dstvol2


Is dstvol2 in a read-write state?

6. Before you start the resync for the qtree src_qtree check the status of the qtrees.
What is the status of the qtree src_qtree?

filerA> qtree status


Volume Tree Style Oplocks Status
------- --------- ----- -------- ---------
vol0 unix enabled normal
vol0 dst_qtree unix enabled normal
vol0 src_qtree unix enabled normal
dstvol2 unix enabled normal
srcvol2 unix enabled normal

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 58


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

Step
Now let’s complete the first resync for the qtree, src_qtree, on vol0 on filerA.
NetApp Internal Only

Do Not Distribute
7.
Notice that we are using filerA:/vol/vol/dst_qtree as the source because it has
the most recent updates. On filerA we are using filerA:/vol/vol0/src_qtree as
the destination . Enter the following command.

filerA> snapmirror resync –S filerA:/vol/vol0/dst_qtree


filerA:/vol/vol0/src_qtree
The resync base snapshot will be:
filerA(0033604816)_vol0_dst_qtree-src.219
Resync may alter the data in this qtree.
Are you sure you want to resync the qtree? y
Sun Sep 11 09:04:17 PDT [filerA:
snapmirror.dst.resync.success:notice]: SnapMirror resync
of /vol/vol0/src_qtree to filerA:/vol/vol0/dst_qtree
successful.
Transfer started.
Monitor progress with 'snapmirror status' or the
snapmirror log.

8. The SnapMirror resync command used a baseline snapshot for the resync.
The SnapMirror update command requests any changes made since the
baseline snapshot be transferred to the destination. Issue the following
command to complete the synchronization of filerA:/vol/vol0/dst_qtree with
filerA:/vol/vol0/src_qtree

filerA> snapmirror update -S filerA:/vol/vol0/dst_qtree


filerA:/vol/vol0/src_qtree
Transfer started.
Monitor progress with 'snapmirror status' or the
snapmirror log.
What is the status of the qtree src_qtree now? Is it read-write or read only?
9.

filerA> qtree status


Volume Tree Style Oplocks Status
-------- --------- ----- -------- ---------
vol0 unix enabled normal
vol0 dst_qtree unix enabled normal
vol0 src_qtree unix enabled snapmirrored
dstvol2 unix enabled normal
srcvol2 unix enabled normal

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 59


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

Step

After breaking the mirrors to make the qtree filerA:/vol/vol0/dst_qtree and


NetApp Internal Only

Do Not Distribute
10.
filerA:dstvol2 read-write you were instructed to make changes to those
objects. You were also asked to record a summary of those changes. Now
access /vol/src/ and /vol/vol0/src_qtree and verify that the changes you made
are the same as what you are now seeing. Write down a summary record of
your changes you see. Hint: If you want to quickly check, you can enter
these commands on the Storage Controller:

filerA> priv set diag

filerA*> ls /vol/srcrvol2

filerA*> ls/vol/vol0/src_qtree

Changes to /vol/srcvol2:
:

Changes to /vol/vol0/src_qtree:

Do the changes match what you recorded earlier? They should.

11. You have just completed the first resync and made filerA:srcvol2 a
snapmirror of filerA:dstvol2 and filerA:/vol/vol0/src_qtree a snapmirror of
filerA:/vol/vol0/dst_qtree. Now it’s time to complete the second resync and
reverse the mirror relationship so that the srcvol2 volume and src_qtree qtree
are once again the source for these objects.

12. In order to start the second resync for you need to break the mirror again.
Enter the following command.

filerA> snapmirror break filerA:srcvol2

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 60


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

Step

Start the second resync for the dstvol2 volume. Enter the following
NetApp Internal Only

Do Not Distribute
13.
command.

filerA> snapmirror resync -S filerA:srcvol2


filerA:dstvol2
The resync base snapshot will be:
filerA(0033604817)_srcvol2.3
Are you sure you want to resync the volume? y
Sun Sep 11 10:17:46 PDT [filerA:
snapmirror.dstvol2.resync.info:notice]: SnapMirror
resync of dstvol2 to filerA:srcvol2 is using
filerA(0033604817)_srcvol2.3 as the base snapshot.
Volume dstvol2 will be briefly unavailable before coming
back online.
Sun Sep 11 10:17:46 PDT [filerA: config_async_0:notice]:
CIFS - disabled for volume dstvol2
Share dstvol2 disabled while volume dstvol2 is offline.
Volume dstvol2 is now restricted.
Sun Sep 11 10:17:47 PDT [filerA: config_async_0:notice]:
Reverting volume dstvol2 to a previous snapshot (snapid
7).
Share dstvol2 activated.
Volume 'dstvol2' is now online.
Revert to resync base snapshot was successful.
Sun Sep 11 10:17:47 PDT [filerA:
snapmirror.dstvol2.resync.success:notice]: SnapMirror
resync of dstvol2 to filerA:srcvol2 successful.
Transfer started.
Monitor progress with 'snapmirror status' or the
snapmirror log.

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 61


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

Step

In order to start the second resync for filerA:/vol/vol0/dst_qtree you need to


NetApp Internal Only

Do Not Distribute
14.
break the mirror filerA:/vol/vol0/src_qtree. Enter the following command.

filerA> snapmirror quiesce filerA:/vol/vol0/src_qtree


snapmirror quiesce: in progress
This can be a long-running operation. Use Control - C
(^C) to interrupt.
snapmirror quiesce: /vol/vol0/src_qtree : Successfully
quiesced
filerA> snapmirror break filerA:/vol/vol0/src_qtree

snapmirror break: Destination /vol/vol0/src_qtree is now


writable.

Now let’s complete the second resync. Notice that we are using
15.
filerA:/vol/vol/src_qtree as the source and filerA:/vol/vol0/dst_qtree as the
destination . Enter the following command.

filerA> snapmirror resync –S filerA:/vol/vol0/src_qtree


filerA:/vol/vol0/dst_qtree

The resync base snapshot will be:


filerA(0033604817)_vol0_src_qtree-src.2
Resync may alter the data in this qtree.
Are you sure you want to resync the qtree? y
Sun Sep 11 10:26:44 PDT [filerA:
snapmirror.dst.resync.success:notice]: SnapMirror resync
of /vol/vol0/dst_qtree to filerA:/vol/vol0/src_qtree
successful.
Transfer started.
Monitor progress with 'snapmirror status' or the
snapmirror log.

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 62


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

SnapMirror Compression
Step
NetApp Internal Only

Do Not Distribute
Let’s go through entering in SnapMirror compression. This is done by adding
1.
an extra line in the /etc/snapmirror.conf file, and then re-configuring
SnapMirror to allow compression.

Since we’re working with /vol/srcvol2 and /vol/dstvol2 on the same Storage
Controller, we’ll set that up now.

Enter the following commands on your Storage Controller:


2.
Note to replace “filerA” with your Storage Controllers hostname.

filerA> wrfile /etc/snapmirror.conf


comp=multi (filerA,filerA)
comp:srcvol2 filerA:dstvol2 compression=enable * * * *
<CTRL-C>

Looks a little redundant here, however it breaks down like so:

<Relationshipname>=multi (srcFiler, dstFiler)


<Relationshipname>:<src> dstFiler:<dst> compression=enable * * * *

Since we’re using the same Storage Controller, the ‘multi’ part has the
source and destination looking the same. For the actual SnapMirror line, the
source has become the relationship name “comp”, however note that the
destination Storage Controller has not changed!
Let’s see if compression works. First, type in snapmirror on so Data ONTAP
3.
will re-read the /etc/snapmirror.conf file. If there’s an error, you will see it
come up now. If there’s no error, you typed it in perfectly!

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 63


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

Next, type ‘date’ and hit return. Keep typing ‘date’ until the time is exactly
4.
after the minute (i.e., the seconds read 00).
NetApp Internal Only

Do Not Distribute
Now let’s make a file on the source. Enter the following commands on the
Storage Controller:

filerA> priv set diag

filerA*> mkfile 50m /vol/srcvol2/testing

Now type the ‘date’ command again. When it reaches 55 seconds, start
5.
typing the following command:

filerA*> snapmirror status –l

<note that this is a lowercase L>

You should very soon see the SnapMirror transfer begin. To know what’s
going on with compression, you can see it during a transfer. Here is an
example of what you may see (note the compression status)

filerA*> snapmirror status -l


Snapmirror is on.

Source: dev:srcvol2
Destination: dev:dstvol2
Status: Transferring
Progress: 10328 KB
Compression Ratio: 93.3 : 1
State: Snapmirrored
Lag: 00:01:01
Mirror Timestamp: Sun Sep 11 17:29:01 EDT 2011
Base Snapshot: dev (0151752914)_dst.9
Current Transfer Type: Scheduled
Current Transfer Error: -
Contents: Replica
Last Transfer Type: Scheduled
Last Transfer Size: 56 KB
Last Transfer Duration: 00:00:01
Last Transfer From: dev:srcvol2

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 64


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

Exercise 3: SnapVault Scheduling & OSSV


NetApp Internal Only

Do Not Distribute
Description and instructions

Product Data ONTAP 7.3.3P4, FAS3140,

Description SnapVault scheduling

Notes This lab will request that you enable SnapVault and set it up to
backup your Windows host at c:\Backup_Folder. You will need to
enter an appropriate schedule, and actually backup the required
folder, and have it restored.

For the labs here, substitute Secondary with the hostname of


your Storage Controller.

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 65


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

Configure the SnapVault Secondary Storage Controller


Steps Actions
NetApp Internal Only

Do Not Distribute
1. In SnapVault terms, the primary systems are the hosts being backed up, in
this case, the Windows host. The Secondary is the Storage Controller
which is doing the backups. So in this example, each Storage Controller
becomes a Secondary Storage Controller.

For the labs here, substitute Secondary with the hostname of your
Storage Controller.

2. The following is already installed on your Storage Controller:


sv_ontap_sec
sv_windows_pri

Enable SnapVault access permission to all with the options command:


Secondary> options snapvault.access all
3. Create a flexible volume named sv1 in aggregate aggr1. The volume size will be
500Mb.

Secondary> vol create sv1 aggr1 500m


4. Create a CIFS share on the secondary to access sv1:

Secondary> cifs shares –add <sharename> /vol/sv1

Map a network drive on your Windows host to the volume sv1.

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 66


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

Establishing the Open Systems SnapVault Baseline


From the Open Systems SnapVault primary you are going to protect a directory named ossv on
the C drive to the destination path /vol/sv1/Backup_Folder
NetApp Internal Only

Do Not Distribute
Steps Actions

1. On the Windows host, there is a folder called c:\Backup_Folder, which we


are going to use for our examples.

OSSV for Windows has already been installed on your Windows hosts.

2. Perform the SnapVault initial baseline transfer. At this stage the destination
qtree ossv does not exist and will be created by the snapvault start
command:

Note the command below is all on 1 line.

snapvault start –S <Windows_IP>:c:\Backup_Folder


Secondary:/vol/sv1/Backup_Folder

3. Verify that the secondary qtree ossv was created in the secondary volume
sv1. (Hint: qtree status)

Secondary> qtree status sv1

4. Issue the snapvault status –l command to collect the following information:

State of the relationship: ______________________________________

Snapshot copy created for the baseline transfer: ___________________

Last transfer type: ___________________________________________

Transfer size and duration: ____________________________________

5. On the Open Systems SnapVault primary, drop down to the bin directory to
run and verify the outputs of the following commands. Note you will have to
use Windows ‘cmd’ and use a DOS window:

C:\Program Files\netapp\snapvault\bin\snapvault
destinations

C:\Program Files\netapp\snapvault\bin\snapvault status

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 67


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

Perform an Update, and create a SnapVault schedule


NetApp Internal Only

Do Not Distribute
Steps Actions

1. On the Windows host, copy some extra files into c:\Backup_Folder.

Then, let’s perform an update on SnapVault secondary. On your Storage


Controller, first list out all the snapshots:

Secondary> snap list sv1

You will see a snapshot ending with *_sv1-base.0. That’s what we’ll need.
Enter the command:
Secondary> snapvault update -s <snapshot>
/vol/sv1/Backup_Folder

2. Now let’s enter a SnapVault schedule for the volume. That way, at certain
times each hour, night, or weekly, SnapVault will do an incremental backup
of the systems that are using the volume for Snapvault.

snapvault snap sched -x sv1 sv_weekly 1@sat@19


snapvault snap sched -x sv1 sv_nightly 2@mon-fri@19
snapvault snap sched -x sv1 sv_hourly 11@mon-fri@7-18

Enter snapvault snap sched to view the schedule you just made.

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 68


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

Perform a Restore and Resume Snapvault Operations


Because restoring to a directory that is a part of a SnapVault relationship is not allowed, you will
restore the content of the ossv directory to a new location.
NetApp Internal Only

Do Not Distribute
Steps Actions

1. On the Windows host, delete the source directory c:\Backup_Folder

2. To restore the content of the Backup_Folder directory to a new location


named backup_folder1, use the command syntax:

C:\Program Files\netapp\snapvault\bin\snapvault restore


–S Secondary:/vol/sv1/Backup_Folder C:\Backup

Notes:

If during the Open Systems SnapVault agent installation, you specified the
IP address of the authorized secondary system, you must enter this IP
address in the command syntax.

You do not have to create the Backup_Folder1 directory; the snapvault


restore command will create it on the C drive.

3. Display the SnapVault log from the Open Systems SnapVault client and the
secondary system. You should see entries for the initial baseline transfer,
the manual update, and the restore operations:

On the Storage Controller: /etc/log/snapmirror

On the Windows host:

C:\Program Files\netapp\snapvault\etc\snapvault

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 69


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

Module 9 Exercises – Virtualization


Virtualization – Scenario 1: NFS Datastore is not accessible
NetApp Internal Only

Do Not Distribute
Description and instructions

Product Data ONTAP 7.3.3P4, FAS storage system, Windows Domain

Symptom NFS datastore is offline.

Notes This is a new NFS datastore and has not worked.


To recreate the issue, you will export an NFS Datastore and examine
the results.

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 70


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

Steps Actions

1.
NetApp Internal Only

Do Not Distribute
First we need to create a new VMkernal port.

To create a new VMkernel port (see your instructor for the assigned IP
Address).

1. Use your vSphere Client to connect to the VMWare ESX Service


Console. Use the username of ‘root’ and password of ‘passwd’
2. Double-click on Inventory icon
3. From the Configuration tab, select (Hardware) Networking.
4. Click on “Add Networking . . .” on the right. The Add Network
Wizard appears.
5. For the Configuration Type, choose VMkernel
6. Network Access, select the existing vSwitch.
7. For Connection Settings, leave the defaults and click Next.
8. For the IP Settings, use the ESX Kernel IP as assigned by your
instructor.
9. You will be prompted at some point for your gateway address.
Use the same gateway IP address that the client has (it will show
it to you at the time you are prompted).
Review the summary and click Finish

2. On your assigned storage system, create 2 10GB flexible volumes


in aggr1.
Example

Filer1> vol create nfsstore aggr1 10g

Filer1> vol create nfsstore2 aggr1 10g

3. Stop: Let your instructor know when you reach this point.

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 71


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

4. Next, create a qtree.


NetApp Internal Only

Do Not Distribute
Filer1> qtree create /vol/nfsstore2/nfstree

5. Create an export for the nfstree qtree and change the export for
the nfsstore2 volume.

Filer1> exportfs –u /vol/nfsstore2

Filer1> exportfs –io sec=sys,


nosuid,rw,root=<VMkernel_IP> /vol/nfsstore2

Filer1> exportfs –io sec=sys,


nosuid,rw,root=<VMkernel_IP> /vol/nfsstore2/nfstree

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 72


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

Mount both of the NFS datastore volumes (nfsstore and nfstree) as a


6.
datastore to your ESX host. Name this datastore nfsstoreXX, where XX
is your storage system number.
NetApp Internal Only

Do Not Distribute
1. From the vSphere Client and select the host from the Inventory
panel.
2. Click the Configuration tab and click Storage in the Hardware
panel.
3. Click Datastores and click Add Storage.
4. Select Network File System and click Next.
5. Enter the server name, the mount point folder name, and the
datastore name.
6. Click Next.
7. In the Network File System Summary page, review the
configuration options and click Finish.

If this works, you should see something similar to the following:

Note, those if you do not see this, move on to Step 7.

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 73


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

7.
Did both the volume /vol/nfsstore AND the qtree /vol/nfsstore2/nfstree
NetApp Internal Only

Do Not Distribute
work?

Which one(s) worked? ______________________________________

Which one(s) did not work? ___________________________________

Did you see any messages on the storage system?

________________________________________________

________________________________________________

________________________________________________

________________________________________________

What messages did you see on the ESX host?

________________________________________________

________________________________________________

________________________________________________

If one or both of them did not work, it is your job now to figure out why
they didn’t, and make sure that in the end, both NFS exports are
mounted in VMware as Datastores.

NOTE: You will only be troubleshooting the Storage Controller’s


configuration, not the VMware ESX host.

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 74


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

Virtualization – Scenario 2: iSCSI Datastore is not working


Description and instructions
NetApp Internal Only

Do Not Distribute
Product Data ONTAP 7.3.3P4, FAS storage system, Windows Domain

Symptom iSCSI datastore is offline.

Notes This is a new datastore and has not worked.

Your iSCSI datastore on the storage system is not accessible.

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 75


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

Steps Actions
Referring to your classroom IP map, create verify the VMkernel port that
1.
NetApp Internal Only

Do Not Distribute
you created on a new vSwitch.

Note: You may need to free up some adapters to create the new switch.

2.
Configure the iSCSI software initiator on your ESX host to use your
assigned storage system interface as a target
1. From the vSphere Client and select the host from the Inventory
panel.
2. Click the Configuration tab and click Storage Adapters in the
Hardware panel.
3. Select the iSCSI Software adapter and click Properties.
4. The iSCSI Initiator Properties pop-up appears. Click Configure.
5. Click Enable and OK.
6. The IQN (nodename) for the ESX server should appear. You will
need this later, so make sure you copy & paste this into a buffer
to use when you create a igroup as part of the LUN setup.

3.
On your assigned storage system, create a volume and LUN as follows:

Filer> vol create iscsistore1 aggr1 200g


Filer> lun setup
 Multiprotocol type: vmware
 Path: /vol/iscsistore1/lun0
 Space reserved: Yes
 Size: 30GB
 Initiator group: host#_iscsi where # is your Storage Controller’s
ID number (i.e. 1 = filer1x; 2 = filer2x; etc.)
 Initiator type: iSCSI
 Initiator group members: your ESX host iqn name
 NOTE: You may need to address the problem of having an
invalid iqn name coming from the ESX host.
 OS type: vmware
 LUN ID: 0

Filer> iscsi start

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 76


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

4.
NOTE: If you refresh your connections, you should see that the Storage
Controller is connected. It should look like the picture below:
NetApp Internal Only

Do Not Distribute
If you do not see your Storage Controller here after a refresh, perform
the following steps:
1. Go back to the properties of your iSCSI software adapter
2. Under the Dynamic Discovery tab, click on Add
3. Add your e0a IP address. This is important, and it forces ESX to
try a connection to that host. Keep the default port of3260. Click
Ok.
4. Click on Close and rescan your storage when prompted. You
should now see your Storage Controller.
5. If not, check the Storage Controller settings and make sure
iSCSI is turned on, enabled for port e0a, and check your igroup
to see if your ESX box has logged into your e0a interface.

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 77


Company Confidential - For Internal Use Only
GS Learning and Performance
Troubleshooting Workshop for Partners v2.3

Create a new iSCSI LUN and datastore using the following parameters.
5.
Use the ESX Software iSCSI initiator to connect the LUN to the ESX
host.
NetApp Internal Only

Do Not Distribute
1. From the vSphere Client and select the host from the Inventory
panel.
2. Click the Configuration tab and click Storage in the Hardware
panel.
3. Click Datastores and click Add Storage.
4. Select Disk/LUN and click Next. Your Storage Controller’s disk
should be listed.
5. Enter the server name, the mount point folder name, and a
datastore name called filer#_iscsi
0. .Where # is your Storage Controller’s ID number (i.e. 1 =
filer1x; 2 = filer2x; etc.)
6. Click Next.
7. In the Network File System Summary page, review the
configuration options and click Finish.

6. Verify that you can browse the new datastore. Right click on the
datastore you created, and select Browse.

7. STOP: Let the instructor know when you reach this point.

Keep a telnet or console connection to your storage system open while


performing the following tasks. You will want to monitor the console messages.

8. Verify again that you can still browse the datastore. You most likely
cannot at this point. Something has changed, and needs to be fixed.

You job now is to find out what happened on the Storage Controller, and
fix so you can once again browse your iSCSI datastore. When you
believe you have fixed the problem, click on the Refresh link in VMware
to see if your LUN is now back online. Note, if it is not fixed, the refresh
can take several minutes before timing out.

NOTE: You will only be troubleshooting the Storage Controller’s


configuration, not the VMware ESX host.

© Copyright 2013 NetApp, Inc. All rights reserved. Exercise Guide - 78


Company Confidential - For Internal Use Only

You might also like