NetCache Utilities

March 2003

Utilities 1

Objectives
When you have completed this module
you will be able to do the following:

Flush objects and DNS entries form the NetCache

Describe NetCache Utilities
Use trace analysis application to evaluate packet
traces
Describe statistics available
Configure custom error pages
State how to contact Network Appliance Technical
Support

March 2003

Utilities 2

NetCache Utilities

NetCache Utilities
This page provides tools and options useful to administering and testing the NetCache.

March 2003

Utilities 3

Utilities > User Interface > General

Utilities- User Interface

This page allows you to control how statistical data will be displayed.

March 2003

Utilities 4

Data Display Options

Numerical Display

Statistics may be
displayed numerically
or graphically
Real-Time Charts

March 2003

Utilities 5

Statistics Graphs

March 2003

Utilities 6

Statistics Graphs contd

March 2003

Utilities 7

Flush

Flush
The flush command empties the cache of all objects or all cached DNS entries, if DNS
caching is enabled (Utilities tab > Cache Objects > Flush).

March 2003

Utilities 8

diag command
Syntax 1: diag dump [-i ifile]
The file containing the \n separated commands to be
executed (default: /etc/[Link])

Syntax 2: diag delete [ [Link]]+

Syntax 3: diag list
Example:
netcache> diag dump
Dumping diagnostic data to file (default time is < 2 mins) ...
Diagnostic data successfully dumped to file: /20020814_084229.diag
netcache> diag list
List of diagnostic files:
20020814_084229.diag
netcache>

2002.[Link]

596974

diag command
Use the diag command to manage appliance diagnostics data files.

Note: By default, diagnostic commands in etc/[Link] are executed and their output is
written to a diagnostics file. Default diagnostics might take more than two minutes to
complete, during which the CLI is not available.

Four options are supported:

1. Delete a file that is no longer needed
2. Copy a file to a specified location
3. Send a file to an FTP or Web server
4. Send a copy of the file to Network Appliance Technical Support

Note: Sending a file leaves the original file in place.

March 2003

Utilities 9

diag Command Output

[Link].show_chunk = 0
[Link] = \\
[Link] [Link]
<snip>
[Link] = 0
[Link] = 0
[Link] = 0
<snip>
[Link] = \\
0
1 sec 5 sec 10 sec 30 sec 1 min
0
0
0
0
0
5 min 10 min 30 min 1 hour 2 hour
0
0
0
0
0
<snip>

March 2003

Utilities 10

diag Command Output contd

CPU
URLs/s
Net kB/s
Disk kB/s
BW
savings/s
tot
hit miss
in
out
read write
4%
0
0
0
0
0
0
0
0%
2%
0
0
0
0
0
248
360
0%
7%
0
0
0
0
0
0
0
0%
1%
0
0
0
1
0
0
0
0%
3%
0
0
0
1
0
0
0
0%
<snip>
Sun Aug 18 [Link] GMT [log_rotate:notice]: System
netcache205 (ID 0016803056) is running NetApp Release
5.3.1X13
Sun Aug 18 [Link] GMT [console_login_mgr:info]: root logged
in from console
Sun Aug 18 [Link] GMT [[Link]:info]:
1:00am up 2
days, 2:42 0 URLs
Sun Aug 18 [Link] GMT [console_login_mgr:info]: root logged
in from console
Sun Aug 18 [Link] GMT [[Link]:info]:
2:00am up 2
days, 3:42 0 URLs

March 2003

Utilities 11

/etc/[Link] file
netcache> rdfile /etc/[Link]
show config.*
show status.*
options
sysstat -c 30 1
show status.*
sysstat -c 30 -x 1
show status.*
ifstat -a
netstat -p tcp
netstat -rn
sysconfig -a
sysconfig -v
nfsstat -l
nfsstat -c
nclog -ta -2000 http
nclog -v messages
netcache>

March 2003

Utilities 12

Utilities > Diagnostics > Data Dump

March 2003

Utilities 13

Utilities -> Diagnostics -> Packet Trace

pktt command:
Syntax 1:
Syntax 2:
Syntax 3:
Syntax 4:
Syntax 5:

pktt start [if | all] [-m <pklen>]

[-b <bsize>] [-i <ipaddr> -i <ipaddr>]
pktt pause [if | all]
pktt dump [if | all]
pktt stop [if | all]
pktt status [if | all] -v

Option

Definition

[if | all]
[-m <pklen>]
[-b <bsize>]
[-i <ipaddr>
-v

List IP addresses.
View the status.

March 2003

Utilities 14

Utilities -> Diagnostics -> Packet Trace ->

Diskless Packet Tracing

March 2003

Utilities 15

Sysstat Command
edu2-C760> sysstat 1
CPU

URLs/s

Net

kB/s

Disk kB/s

BW savings/s

tot

hit

miss

in

out

read

write

4%

0%

1%

80

168

0%

4%

0%

0%

0%

4%

0%

2%

560

240

0%

4%

0%

Sysstat Command
The sysstat command is used to display performance statistics, such as the current CPU
usage, the amount of network I/O, and the amount of disk I/O.
Refer to the command line help for syntax and option information.

March 2003

Utilities 16

netdiag Examples
netdiag -s -- presents a summary of physical,
transport, and network layer diagnostic
results
netdiag -s -p -I ns0 -- presents a summary of
diagnostic results restricted to interface
ns0 on the physical layer
netdiag -v -e -- presents diagnostic results in
verbose mode with error codes displayed

Netdiag Command
The netdiag command runs automated diagnostic analysis routines on the on the physical,
network, and transport layers of the NetCache appliance and displays the results in
summary, verbose, or debug format.
Refer to the command line help for syntax and option information.

March 2003

Utilities 17

Other netdiag Commands

edu2-C760> netdiag -n
Performing network layer diagnostics.....OK
edu2-C760> netdiag -t
Performing transport layer diagnostics.....OK
edu2-C760> netdiag -p
Performing physical layer diagnostics.....OK

March 2003

Utilities 18

Packet Trace
Syntax
Usage: pktt
pktt
pktt
pktt
pktt

start
<if>|all [-m pklen] [-b bsize] [-i ipaddr -i ...]
pause
<if>|all
dump
<if>|all
stop
<if>|all
status [<if>|all] [-v]

Example:
netcache> pktt start all
netcache> pktt dump all
Mon Aug 14 [Link] GMT [rc:info]: pktt: 3617 packets seen, 0
dropped, 130102 by tes written to /[Link]
netcache> pktt stop all
ns0: Tracing stopped and packet trace buffers released.
netcache>

Packet Trace
When helping you to troubleshoot problems, Network Appliance Technical Support
might instruct you to run a packet trace by using the pktt command. The pktt command
creates a packet trace file, which contains information about your network.
Refer to the NetCache 5.4 Administration Guide, Chapter 13, Troubleshooting for
additional information.

March 2003

Utilities 19

Packet Trace Utility

Refer to On Line Help for configuration information.

March 2003

Utilities 20

Network Statistics
netcache> netstat ?
usage: netstat [-an]
netstat -mnrs
netstat {-i | -I interface} [-dn] [-w interval]
netstat [-p protocol]

Netstat
Use the netstat command to display the network status.
Syntax 1: netstat [-an]
Syntax 2: netstat -mnrs
Syntax 3: netstat -i [-I <interface>] [-dn]
Syntax 4: netstat -w <interval> -i [-I <interface>] [-dn]
Syntax 5: netstat -p <protocol>
Refer to the command line help for syntax and option information.

March 2003

Utilities 21

Routing Table
netcache> netstat -r
Routing tables
Internet:
Destination
default
10.120.4/22
[Link]
localhost
netcache>

Gateway
[Link]
link#1
[Link]
localhost

Flags
UGS
UC
UHL
UH

Refs
21
0
1
0

Use
624
0
0
0

Interface
ns0
ns0
ns0
lo

Refer to the command line help for syntax and option information.

March 2003

Utilities 22

Routing Statistics
netcache>
routing:
0
0
0
0
0
netcache>

netstat -rs
bad routing redirects
dynamically created routes
new gateways due to redirects
destinations found unreachable
uses of a wildcard route

Refer to the command line help for syntax and option information.

March 2003

Utilities 23

Active Sockets
netcache> netstat -an
Active TCP connections (including servers)
Local Address
Remote Address
Swind Send-Q
[Link].23
[Link].45543
8760
0
ESTABLISHED
[Link].1132
[Link].80
31856
0
CLOSE_WAIT
[Link].1131
[Link].80
31856
0
[Link].1054
[Link].554
31856
0
LISTEN
*.3132
*.*
0
0
Active UDP sockets (including servers)
Local Address
Remote Address
[Link].554
[Link].6972
[Link].554
[Link].6970
*.161
*.*
*.1025
*.*
*.1755
*.*
*.3130
*.*
[Link].520
*.*
[Link].520
*.*

Rwind Recv-Q State

8760
0
8760

8760
32768

0
0

Send-Q Recv-Q
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0

Refer to the command line help for syntax and option information.

March 2003

Utilities 24

Memory Buffers
netcache> netstat -m
168 mbufs out of 1050 in use:
12 mbufs allocated to socket names and addresses
54 out of 500 large buffers in use
102 out of 500 small buffers in use
12 out of 50 non-data mbufs in use
938 Kbytes allocated to network (12% in use)
0 requests for memory denied
netcache>

Refer to the command line help for syntax and option information.

March 2003

Utilities 25

Interface Statistics
netcache> ifstat -a
usage: ifstat [-z] -a | <interface>
netcache> ifstat e0
-- interface

e0

RECEIVE
Packets:
Queue full:
TRANSMIT
Packets:
Collisions:

(2 hours, 55 minutes, 18 seconds) -108k | Bytes:

0
165k | Bytes:
0

58881k | Errors:
61642k | Errors:

0
0

Ifstat Command
Displays network interface statistics for each interface.
Refer to the command line help for syntax and option information.

March 2003

Utilities 26

System Statistics

March 2003

Utilities 27

Maintenance > Software > Error Pages

Error Pages
Use options on this page to download error pages for editing and then uploading the
pages to this NetCache Appliance after you have finished editing the pages.
Refer to On Line Help for additional information.

March 2003

Utilities 28

[Link].domain_behavior

netcache> show [Link].domain_behavior

[Link].domain_behavior = \\
Domain
Response Failures Attempts
(All)
0.02s
475
803
NTAPNC
0.02s
20
348
BAD-DOMAIN
0.02s
455
455
\\

March 2003

Utilities 29

General Use for

[Link].domain_behavior
Evaluate the windows environment
Determine if specific domains are the problem,
or if everything is broken
Some possible problems:
Poor response times
Flaky networks
Overloaded servers
Broken trust relationships

March 2003

Utilities 30

Domain Behaviour in Syslog

Messages
Tue May 7 [Link] GMT [sthread_loop:warning]: For 2 of 2
windows domains(s), average response time is above 1.00s.
Tue May 7 [Link] GMT [sthread_loop:warning]: For 2 of 2
windows domain(s), 60-second failure rate is above 40%.
Tue May 7 [Link] GMT [sthread_loop:warning]: Top response
time(s): NTAPNC=3.01s BAD-DOMAIN=3.01s
Tue May 7 [Link] GMT [sthread_loop:warning]: Top failure
rate(s): NTAPNC=116/150 BAD-DOMAIN=503/503
Tue May 7 [Link] GMT [sthread_loop:warning]: You might
want to check domain connectivity, availability, and trust
relationships.

March 2003

Utilities 31

Domain Behavior in Syslog

Messages
Triggered by the same status information
High response times
High failure rates
Must pass threshold of 20 attempts to count

Issued about every five minutes while

possible problem persists
Name domains with worst response times
and failure rates

March 2003

Utilities 32

Setup > Authentication > NTLM and Kerberos

Test Environment Tab

Exposes the new windiag command on the GUI

Windows NT only

March 2003

Utilities 33

Contacting Network Appliance

Technical Support
Telephone
For U.S. customers:
(888) 4-NETAPP (US and Canada)
(1-888-463-8277)
(408) 822-4700
For European customers:
00-800-44-638277 Europe
31-23-567-9605 Europe
For all other international customers:
+1 408 822-4700 (Ask for Technical Support.)

Web address [Link]

[Link]

March 2003

Utilities 34

Utilities Exercises
Netdiag Command
Packet Trace

March 2003

Utilities 35

Exercises

15 minutes in length
Use breakout rooms
Instructor will visit all rooms
Broadcast announcement 5 minutes
prior to regroup
Stay focussed, start telnet, start GUI
Share microphones, or no one else can
be heard

March 2003

Utilities 36

NetCache Utilities Exercises

Objectives
Use NetCache tools to evaluate NetCache performance.

Exercise Overview
The purpose of this activity is for you to perform the procedures to provide experience in
using troubleshooting tools. During these exercises, you will be guided through each step
in the process, and you will have an opportunity to verify that each step was successfully
completed.

Time Estimate: 15 Minutes

Required Hardware, Software, and Tools
Hardware

Workstation

NetCache machine

Software

NetCache 5.4

Windows 2000

Netscape 4.7

Internet Explorer 5.5 and later

March 2003

Utilities 37

Netdiag Command
Use the following procedure to practice using the netdiag command:
1.

At the NetCache CLI prompt, enter each of the following netdiag variants and
observe the results. Identify when you would use each of these.
netdiag -n = network layer
netdiag -t = transport layer
netdiag -p = physical layer
netdiag -s = summary
netdiag -d = debug
Note: Use ifconfig a to get information about the NetCache physical
interfaces.

2.

Use the appropriate netdiag command switch to answer the following

questions:
Which netdiag command will display status information for the NetCaches
interfaces?

3.

4.

Which command line option(s) should be used to specify physical layer

analysis of a particular interface?

What does the netdiag command without any options tell you?

March 2003

Utilities 38

Packet Trace
In this exercise you will use the Packet Trace utility to capture a trace.
Start a packet trace and generate network traffic to the filer.
Open the NetCache Manager
1.
2.
3.
4.
5.
6.
7.

Select Utilities > Network Tests > Packet Trace

Select Start to begin a trace
Ensure that you have a browser proxied through your cache.
Browse to a couple of Web sites (to generate data).
Select Stop to end the trace
Scroll to Current Packet Trace Files and verify the trace you just finished is
on the list.

March 2003

Utilities 39

NetCache Admin Review Exercise

You are to configure your NetCache appliance to add a new group comprised of the users
identified in [Link] on the PDC. These people are to be restricted from URLs
containing pornographic, gambling, job search or entertainment materials. In addition,
these users must be denied access to [Link] during working hours (8:00 a.m. to
5:00 p.m.).
Configure your NetCache to require authentication for this group .
Verify that the NetCache is properly configured by testing the setup and reviewing the
configuration settings and the logs.

March 2003

Utilities 40

March 2003

Utilities 41