cc/td/doc/product/webscale/webcache/ce17
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table of Contents

Console Command Reference

Console Command Reference

This appendix describes a subset of commands for the Cache Engine console command line. Each command is case sensitive and should be entered as is documented in this appendix. Only the commands documented here are supported by Cisco Systems, Inc.

CacheConfigShow

The CacheConfigShow command displays basic management settings and software version information.

CacheConfigShow


Example A-1: CacheConfigShow Command Output -> CacheConfigShow Software Configuration for Cache Engine Config Version = 2 Time = 12:02:25, Date = 08/28/1998 Network IP Address = 10.1.9.7 Netmask = 255.255.255.0 WCCP Host Router = 10.1.9.0 Default Gateway = 10.1.9.0 Cache Engine Name = CE Cache Farm Name = My Farm DNS Domain Name = domain.net Server #0 = 10.1.9.1 Server #1 = 10.1.9.2 Freshness Factor Text Multiplier = 0.10 Other Multiplier = 0.30 Cookie caching is OFF Filters URL BLOCKING is NOT ENABLED value = 1 = 0x1

The message "value = 0 = 0x1" displays to indicate that the command display is complete.

CPU_UsageShow

The CPU_UsageShow command displays average CPU utilization from the last one second and the last ten seconds.

CPU_UsageShow


Example A-2: CPU_UsageShow Command Output -> CPU_UsageShow CPU Utilization: OneSec: 1 TenSec 1 value = 0 = 0x0

The message "value = 0 = 0x0" displays to indicate that the command display is complete.

DiagDump

The DiagDump command displays the Cache Engine's usage statistics.

DiagDump ["disk" | "buffer" | "all"]


Table A-1: DiagDump Variables
Variable Description

"disk"

Disk statistics for all partitions. Options include:

  • "partition"

  • "all"

  • "every"

"buffer"

Buffer statistics for all drives. Options include:

  • "drive"

  • "all"

"all"

All usage statistics for the Cache Engine.


Note Enter each variable on the command line in double quotation marks and with commas in between options.

Example A-1:
DiagDump Command Output -> DiagDump "all" THU DEC 28 12:10:26 1998 General Stats Collecting Stats for 68821 seconds Ready=900 MaxUsed=124 Hit-Bytes=99592K Miss-Bytes=129970K Requests=24506 Hits=5738 Misses=18656 BadConnects=2309 Nearhits=109 Disk Stats For All Partitions Creates=3463 Opens=6502 Closes=10062 Deletes=169 Reads=39550 Writes=49697 Stats=8142 Free=24080922K Wraps=0 OverWrites=41 TruncatesReads=0 InodeErrors=0 CrcErrors=39 DirCollisions=0 Buffer Stats For All Drives Hits=99633 Misses=10648 Writes=14997 Reads=10648 WriteErrors=0 ReadErrors=0 SeekErrors=0 value = 0 = 0x0

The message "value = 0 = 0x0" displays to indicate that the command display is complete.

See the Table 4-4 through Table 4-6 in "Optimizing the Cache Engine" for a description of the statistical terms.

DirectoryDump

The DirectoryDump command displays the drive's partition contents on your console. Each Cache Engine contains 15 partitions [numbered from zero (0) to fourteen (14)].


Note Enter each variable on the command line in double quotation marks and with commas in between options.
DirectoryDump ["partition" | "all"]



Table A-2: DirectoryDump Variables
Variable Description

"partition"

Contents of an individual partition number 0 through 14. For example, DirectoryDump "1"

"all"

Contents of all partitions

Caution Issuing the DirectoryDump command with the "all" parameter is very time-consuming. A fully populated Cache Engine may contain up to 24 GB of data. The "all" parameter will display (and occupy) your console until all data has been dumped. The only way to stop the data dump is to reboot your Cache Engine.

See the "Updating the Basic Configuration" section in "Managing the Cache Engine," for console rebooting instructions.


Note Enter each variable on the command line in double quotation marks.

Example A-1: DirectoryDump "all" Command Output -> DirectoryDump "all" Directory for Partition 0 Directory for Partition 1 #1 Inode at 1000 http://www.domain.com/images/store_special.gif lLength=1370 Directory for Partition 2 Directory for Partition 3 #3 Inode at 1000 http://www.domain.com/inserts/images/marc_hp.gif lLength=220 0 #3 Inode at 1898 http://www.domain.com/images/rule_grn.gif lLength=637 #3 Inode at 1B15 http://www.domain.com/inserts/images/marc_hp.gif lLength=220 0 Directory for Partition 4 #4 Inode at 1000 http://www.domain.com/images/bullet.gif lLength=627 Directory for Partition 5 #5 Inode at 1000 http://www.domain.com/images/footer_new.gif lLength=5229 Directory for Partition 6 Directory for Partition 7 #7 Inode at 1000 http://www.domain.com/images/banners/netscape_c0.gif lLength =17578 Directory for Partition 8 Directory for Partition 9 Directory for Partition 10 Directory for Partition 11 #11 Inode at 1000 http://www.domain.com/images/netcent.gif lLength=2215 Directory for Partition 12 Directory for Partition 13 #13 Inode at 1000 http://www.domain.com/images/download.gif lLength=2170 Directory for Partition 14 #14 Inode at 1000 http://www.domain.com/images/abcnews_3.gif lLength=8249 #14 Inode at 3039 http://www.domain.com/inserts/images/toshiba_2000ih3_brkthr u_ad.gif lLength=4578 #14 Inode at 421B http://www.domain.com/images/abcnews_3.gif lLength=8249 #14 Inode at 6254 http://www.domain.com/inserts/images/toshiba_2000ih3_brkthr u_ad.gif lLength=4578 value = 0 = 0x0

The message "value = 0 = 0x0" displays to indicate that the command display is complete.

DISK_UsageShow

The DISK_UsageShow command displays your Cache Engine's average disk utilization from the last one second and the last ten seconds.

DISK_UsageShow


Example A-2: DISK_UsageShow Command Output -> DISK_UsageShow DISK Utilization: OneSec: 0 TenSec 0 value = 0 = 0x0

The message "value = 0 = 0x0" displays to indicate that the command display is complete.

FSReset and FSSync

The FSReset command flushes the Cache Engine's data.

The FSSync command ensures that the permanent directory on disk is synchronized with the running directory that was flushed by the FSReset command.

FSReset

FSSync


Note You must issue the FSSync command each time the FSReset command finishes.

Example A-3: FSReset and FSSync Command Output -> FSReset Resetting 15 disks TID=7F1749C Creating file system! /raw0/  [filesystem.c at 1242] TID=7F1749C Creating file system! /raw1/  [filesystem.c at 1242] TID=7F1749C Creating file system! /raw2/  [filesystem.c at 1242] TID=7F1749C Creating file system! /raw3/  [filesystem.c at 1242] TID=7F1749C Creating file system! /raw4/  [filesystem.c at 1242] TID=7F1749C Creating file system! /raw5/  [filesystem.c at 1242] TID=7F1749C Creating file system! /raw6/  [filesystem.c at 1242] TID=7F1749C Creating file system! /raw7/  [filesystem.c at 1242] TID=7F1749C Creating file system! /raw8/  [filesystem.c at 1242] TID=7F1749C Creating file system! /raw9/  [filesystem.c at 1242] TID=7F1749C Creating file system! /raw10  [filesystem.c at 1242] TID=7F1749C Creating file system! /raw11/ [filesystem.c at 1242] TID=7F1749C Creating file system! /raw12/ [filesystem.c at 1242] TID=7F1749C Creating file system! /raw13/ [filesystem.c at 1242] TID=7F1749C Creating file system! /raw14/ [filesystem.c at 1242] value = 0 = 0x0 -> FSSync value = 0 = 0x0

The message "value = 0 = 0x0" displays to indicate that the command display is complete.

inetstatShow

The inetstatShow command displays the Cache Engine's current active connections.

inetstatShow

Caution Issuing the inetstatShow command may be very time-consuming because an active Cache Engine may have thousands of connection entries.

Example A-4:
inetstatShow Command Output -> inetstatShow Active Internet connections (including servers) PCB   Proto  Recv-Q  Send-Q  Local Address  Foreign Address   (state) ---   -----  ------  ------  -------------  ---------------   ------ 7e1a6a4 TCP     0     0      192.168.69.80  192.168.29.1568   FIN_WAIT_2 7e1a724 TCP     0     0      192.168.69.80  192.168.29.1566   FIN_WAIT_2 7e1a9a4 TCP     0     0      192.168.69.23  192.168.108.208   ESTABLISHED 7e1af24 TCP     0     0      10.0.0.0.80    10.1.9.0.10       LISTEN 7e1afa4 TCP     0     0      10.0.0.0.80    10.0.0.0.0        LISTEN 7e1b324 TCP     0     0      10.0.0.0.10    10.0.0.0.0        LISTEN 7e1b7a4 TCP     0     0      10.0.0.0.21    10.0.0.0.0        LISTEN 7e1b924 TCP     0     0      10.0.0.0.255   10.0.0.0.0        LISTEN 7e1b0a4 UDP     0     0      192.168.69.255 10.0.0.0.0 7e1b224 UDP     0     0      10.0.0.0.0     10.0.0.0.0 7e1b2a4 UDP     0     0      10.0.0.0.255   10.0.0.0.0 7e1b3a4 UDP     0     0      10.0.0.0.255   10.0.0.0.0 7e1b6a4 UDP     0     0      127.0.0.1.255  172.0.1.255 7e1b724 UDP     0     0      10.0.0.0.1     10.0.0.0.9 value = 1 = 0x1

The message "value = 0 = 0x0" displays to indicate that the command display is complete.

ipstatShow

The ipstatShow command displays IP error statistics.

ipstatShow


Example A-5: ipstatShow Command Output -> ipstatShow total 5851 badsum 0 tooshort 0 toosmall 0 badhlen 0 badlen 0 infragments 0 fragdropped 0 fragtimeout 0 forward 0 cantforward 0 redirectsent 0 unknownprotocol 0 nobuffers 0 reassembled 0 outfragments 0 noroute 0 value = 1 = 0x1

The message "value = 0 = 0x0" displays to indicate that the command display is complete.

memShow

The memShow command displays current free and allocated memory.

memShow


Example A-6: memShow Command Output -> memShow status     bytes     blocks     avg block     max block ------     -----     ------     ---------     --------- current free    45900720      48        956265      45747008 alloc    23362448    8584          2721             - cumulative alloc    26204664    8708          3009             - value = 0 = 0x0

The message "value = 0 = 0x0" displays to indicate that the command display is complete.

NET_UsageShow

The NET_UsageShow command displays average network utilization over the previous one second and ten seconds.

NET_UsageShow


Example A-7: NET_UsageShow Command Output -> NET_UsageShow NET Utilization: OneSec: 0 TenSec 0 value = 0 = 0x0

The message "value = 0 = 0x0" displays to indicate that the command display is complete.

routeShow

The routeShow command displays assigned gateways and route host tables.

routeShow


Example A-8: RouteShow Command Output -> routeShow ROUTE NET TABLE destination     gateway        flags   Refcnt   Use Interface -----------     -------        -----   ------   ------------- 10.0.10.1       10.1.9.113 101 0       0        fei0 10.0.10.1       10.1.9.104 101 0       0        fei0 10.1.19.1       10.1.9.104 101 0       0        fei0 -------------------------------------------------------------- ROUTE HOST TABLE destination     gateway        flags   Refcnt    Use Interface -----------     -------        -----   ------    ------------- 10.0.10.1       10.0.0.1 5     1       0         lo0           -------------------------------------------------------------- value = 77 = 0x4d = 'M'

The message "value = XX = 0xX" = "X" displays to indicate that the command display is complete.

routestatShow

The routestatShow command displays a comprehensive list of routing errors.

routestatShow


Example A-9: routestatShow Command Output -> routestatShow routing: 0 bad routing redirect 0 dynamically created route 0 new gateway due to redirects 1 destination found unreachable 0 use of a wildcard route value = 27 = 0x1b

The message "value = XX = 0xX" displays to indicate that the command display is complete.

ShowSyslogSettings

The ShowSyslogSettings command displays syslog (Cache Engine system logging) settings.

ShowSyslogSettings


Example A-10: ShowSyslogSettings Command Output -> ShowSyslogSettings Syslog host is valid. Syslog Host is 172.16.21.9 Syslog Critical Event Tracking is enabled. Syslog Warning Event Tracking is enabled. Syslog Notice Event Tracking is enabled. Syslog Stat Tracking is not enabled. Syslog URL Tracking is enabled. Syslog Critical Priority = 183 Syslog Warning Priority = 191 Syslog Notice Priority = 183 Syslog Stat Priority = 0 Syslog URL Tracking priority = 191 value = 34 = 0x22=""

The message "value = XX = 0xXX = "" " displays to indicate that the command display is complete.

tcpstatShow

The tcpstatShow command displays general TCP statistics.

tcpstatShow


Example A-11: tcpstatShow Command Output -> tcpstatShow TCP: 26235 packets sent 12762 data packets (10917780 bytes) 53 data packets (55168 bytes) retransmitted 11281 ack-only packets (4593 delayed) 0 URG only packet 0 window probe packet 632 window update packets 1507 control packets 22353 packets received 9577 acks (for 10747367 bytes) 741 duplicate acks 0 ack for unsent data 6754 packets (4090672 bytes) received in-sequence 37 completely duplicate packets (20272 bytes) 0 packet with some dup. data (0 byte duped) 1880 out-of-order packets (450813 bytes) 0 packet (0 byte) of data after window 0 window probe 1307 window update packets 14 packets received after close 1 discarded for bad checksum 0 discarded for bad header offset field 0 discarded because packet too short 521 connection requests 1855 connection accepts 2366 connections established (including accepts) 2375 connections closed (including 304 drops) 10 embryonic connections dropped 9907 segments updated rtt (of 10127 attempts) 132 retransmit timeouts 0 connection dropped by rexmit timeout 0 persist timeout 70 keepalive timeouts 57 keepalive probes sent 13 connections dropped by keepalive 282 pcb cache lookups failed value = 29 = 0x1d

The message "value = 29 = 0x1d" displays to indicate that the command display is complete.

TechSupport

The TechSupport command displays the Cache Engine information necessary for Cisco Systems' Technical Assistance Center (TAC) to assist you with your technical support needs.

TechSupport


Example A-12: TechSupport Command Output -> TechSupport Version: CE v1.7.0 (9-19-98) [/ata0/1_7_0.dir] Software Configuration for Cache Engine Config Version = 2 Time = 18:58:51, Date = 12/06/1998 Network IP Address = 10.1.1.1 Netmask = 10.1.1.2 WCCP Host Router = 10.1.1.3 Default Gateway = 10.1.1.4 Cache Engine Name = CE Cache Farm Name = ISP Cache Farm DNS Domain Name = cisco.com Server #0 = 10.1.1.5 Server #1 = 10.1.1.6 Proxy Acting as a Proxy Server on port 2001 Freshness Factor Text Multiplier = 0.10 Other Multiplier = 0.25 Cookie caching is OFF Filters URL BLOCKING is NOT ENABLED Syslog host is valid. Syslog Host is 172.31.84.96 Syslog Critical Event Tracking is enabled. Syslog Warning Event Tracking is enabled. Syslog Notice Event Tracking is enabled. Syslog Stat Tracking is not enabled. Syslog URL Tracking is enabled. Syslog Critical Priority = 183 Syslog Warning Priority = 191 Syslog Notice Priority = 183 Syslog Stat Priority = 0 Syslog URL Tracking priority = 191 CPU Utilization: OneSec: 1 TenSec 1 NET Utilization: OneSec: 0 TenSec 0 DISK Utilization: OneSec: 0 TenSec 0 memShow follows: 1 0x693e4c0 21380 2 0x7ffc8f8 44 3 0x7ffe1cc 96 4 0x7df0a54 32 5 0x7eaf278 24 6 0x7eb5480 28 7 0x7ee4d5c 16 8 0x7eb5710 16 9 0x7ead708 28 10 0x7ffcc94 16 11 0x7f3bc94 28 12 0x7edc694 20 13 0x7f3bacc 16 14 0x3dbb0f4 45626220 15 0x7ffc000 2280 16 0x7ffa000 4088 17 0x7ff8000 4088 52 0x7fb2000 4072 status bytes blocks avg block max block ------ --------- -------- ---------- ---------- current free 45801484 52 880797 45626220 alloc 23682792 11914 1987 - cumulative alloc 100822036 16582 6080 - ipstatShow follows: total 8 badsum 0 tooshort 0 toosmall 0 badhlen 0 badlen 0 infragments 0 fragdropped 0 fragtimeout 0 forward 0 cantforward 0 redirectsent 0 unknownprotocol 4 nobuffers 0 reassembled 0 outfragments 0 noroute 0 tcpstatShow follows: TCP: 46342 packets sent 17267 data packets (8942149 bytes) 154 data packets (116871 bytes) retransmitted 26292 ack-only packets (3959 delayed) 0 URG only packet 0 window probe packet 365 window update packets 2264 control packets 44816 packets received 13662 acks (for 7881674 bytes) 5029 duplicate acks 0 ack for unsent data 10579 packets (4395598 bytes) received in-sequence 30 completely duplicate packets (2546 bytes) 0 packet with some dup. data (0 byte duped) 1135 out-of-order packets (145185 bytes) 0 packet (0 byte) of data after window 0 window probe 1098 window update packets 116 packets received after close 0 discarded for bad checksum 0 discarded for bad header offset field 0 discarded because packet too short 1018 connection requests 6959 connection accepts 7976 connections established (including accepts) 7977 connections closed (including 2310 drops) 0 embryonic connection dropped 13979 segments updated rtt (of 18581 attempts) 137 retransmit timeouts 0 connection dropped by rexmit timeout 0 persist timeout 0 keepalive timeout 0 keepalive probe sent 0 connection dropped by keepalive 681 pcb cache lookups failed inetstatShow follows: Active Internet connections (including servers) PCB      Proto   Recv-Q  Send-Q   Local Address   Foreign Address   (state) ---      -----   ------  ------   -------------   ---------------   ------ 275a9dc  TCP     0       1        10.0.0.0.2101   10.1.9.0.10       LISTEN 275a95c  TCP     0       0        10.0.0.0.80     10.1.9.0.10       LISTEN 275a8dc  UDP     0       1        172.31.90.255   10.1.9.0.10       - routeShow follows ROUTE NET TABLE destination      gateway          flags     Refcnt    Use Interface -----------      -------          -----     ------    ------------- 0.0.0.0          172.71.70.129    3         6786      fei0 172.71.0.0       172.71.70.152    101       0         fei0 172.71.70.128    172.71.70.152    101       0         fei0 ------------------------------------------------------------------- ROUTE HOST TABLE destination      gateway          flags     Refcnt    Use Interface -----------      -------          -----     ------    ------------- 172.0.0.1        172.0.0.1         5        1         lo0 ------------------------------------------------------------------- routestatShow routing: 0 bad routing redirect 0 dynamically created route 0 new gateway due to redirects 1 destination found unreachable 0 use of a wildcard route Statistics subsystem: Transaction Logging to local file Enabled. LOGS directory summary Working log lifespan is 86400 sec. Working log is 78965 bytes and 86400 sec old. archive.log is 76548976 bytes. TUES DEC 17 14:00:01 1998 General Stats Ready=900 Hit-Bytes=511000 Miss-Bytes=4041000 Requests=5972 Hits=207 Misses=5057 Nearhits=0 Disk Stats For All Partitions Creates=166 Opens=299 Closes=468 Deletes=0 Reads=725 Writes=953 Stats=47 Free=24176722000 Wraps=0 OverWrites=0 TruncatesReads=0 InodeErrors=0 CrcErrors=0 DirCollisions=0 Buffer Stats For All Drives Hits=15302 Misses=94 Writes=13299 Reads=94 WriteErrors=0 ReadErrors=0 SeekErrors=0 value = 0 = 0x0

The message "value = 0 = 0x0" displays to indicate that the command display is complete.

TeeDebugOn and TeeDebugOff

The TeeDebugOn and TeeDebugOff commands toggle the console display of incoming and outgoing HTTP header requests (misses only) between the Cache Engine and a server.

TeeDebugOn

TeeDebugOff


Example A-13: TeeDebugOn and TeeDebugOff Command Output -> TeeDebugOn value = 0 = 0x0

The message "value = 0 = 0x0" displays to indicate that the command display is complete.

Turn debugging off using the TeeDebugOff command.

-> TeeDebugOff value = 0 = 0x0

The message "value = 0 = 0x0" displays to indicate that the command display is complete.

This is sample debugging output:

GET / HTTP/1.0 Proxy-Connection: Keep-Alive User-Agent: Mozilla/3.01 (X11; I; BSD/OS 3.0 i386) Host: www.domain.com Accept: image/gif, image/x-xbitmap, image/jpeg, image/pjpeg, * Incoming Response Buffer: HTTP/1.0 200 OK Server: Netscape-Enterprise/2.01 Date: Thu, 23 Oct 1998 18:20:49 GMT Content-type: text/html Outgoing Request Buffer: GET /images/abcnews_3.gif HTTP/1.0 Referer:
http://www.domain.com/ Proxy-Connection: Keep-Alive User-Agent: Mozilla/3.01 (X11; I; BSD/OS 3.0 i386) Host: www.domain.com Accept: image/gif, image/x-xbitmap, image/jpeg, image/pjpeg Incoming Response Buffer: HTTP/1.0 200 OK Server: Netscape-Enterprise/2.01 Date: Thu, 23 Oct 1998 18:20:51 GMT Accept-ranges: bytes Last-modified: Thu, 23 Oct 1998 13:30:14 GMT Content-length: 7668 Content-type: image/gif Outgoing Request Buffer: GET /inserts/images/sdclick_125ih3_likxmas_ad.gif HTTP/1.0 Referer: http://www.domain.com/ Proxy-Connection: Keep-Alive User-Agent: Mozilla/3.01 (X11; I; BSD/OS 3.0 i386) Host: www.domain.com Accept: image/gif, image/x-xbitmap, image/jpeg, image/pjpeg Incoming Response Buffer: HTTP/1.0 200 OK Server: Netscape-Enterprise/2.01 Date: Thu, 23 Oct 1998 18:20:51 GMT Accept-ranges: bytes Last-modified: Fri, 17 Oct 1998 21:09:04 GMT Content-length: 4007 Content-type: image/gif

UpgradeShow

The UpgradeShow command displays the directory location of the Cache Engine image and the Cache Engine version number.

UpgradeShow


Example A-14: UpgradeShow Command Output -> UpgradeShow Version: CE v1.7.0 (12-19-98) [/ata0/1_7_0.dir]

WC_ResetMother

The WC_ResetMother command and the unlink "basiccfg.txt" command must be used together to return the Cache Engine to its default factory settings.

WC_ResetMother

unlink "basiccfg.txt"


Note You must include the double quotation marks in the unlink "basiccfg.txt" command.

Example A-15: WC_ResetMother Command Output -> WC_ResetMother Unlinking /ata0/1_7_0.dir/config.cfg Unlinking /ata0/1_7_0.dir/events.dat Unlinking /ata0/1_7_0.dir/users.dat Unlinking /ata0/1_7_0.dir/radius.dat Unlinking /ata0/1_7_0.dir/dnsconf.dat value = 0 = 0x0 -> unlink "basiccfg.txt" value = 0 = 0x0
-> reboot

The message "value = 0 = 0x0" displays to indicate that the command display is complete.


hometocprevnextglossaryfeedbacksearchhelp
Posted: Sat Sep 28 02:25:47 PDT 2002
All contents are Copyright © 1992--2002 Cisco Systems, Inc. All rights reserved.
Important Notices and Privacy Statement.