cc/td/doc/product/iaabu/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
Copyright 1989-1998 © Cisco Systems Inc.