Guest

Cisco 500 Series Cache Engines

How to Check What Web Sites/URLs the Cache Engine Is Caching

Document ID: 15040

Updated: Nov 30, 2005

   Print


Contents


Introduction

This document explains how to set up transaction logging to keep track of what web sites/URLs are being cached on the Cache Engine.

Hardware and Software Versions

This configuration was developed and tested using these hardware and software versions:

  • Hardware: Cisco Cache Engine 500 series and 73xx

  • Software: Cisco Cache Software, Release 2.3.0 and updated for ACNS version 4.x and 5.x

Transaction Logging

To keep a track of what web sites are being visited, you need to enable transaction logging on the Cache Engine.

    1. To begin, verify that transaction logging is enabled. Issue the show transaction-logging command.

      ACNS 4.x

      ce-5#show transaction-logging
              Transaction Logs:
              Logging is disabled.
              End user identity is visible.
              File markers are disabled
              Archive interval: every-day at 00:00
              Maximum Number of Archived Files:  3
              Exporting files to servers is disabled.
              Export interval: every-day every 1 hour
              Working Log file - size: 0
              age: Unavailable
              No Archive Log file found
      ce-5#
      

      You can see that logging is disabled.

      ACNS 5.x

      ce-5#show transaction-logging 
      Transaction log configuration:
      ---------------------------------------
      Logging is enabled.
      End user identity is visible.
      File markers are disabled.
      Archive interval: every-day every 1 hour
      Maximum size of archive file: 2000000 KB
      Log File format is squid.
      Windows domain is not logged with the authenticated username
      
      Exporting files to ftp servers is disabled.
      File compression is disabled.
      Export interval: every-day every 1 hour
      
      HTTP Caching Proxy Transaction Log File Info
        Working Log file - size : 206
                           age: 23
      
      WMT MMS Caching Proxy/Server Transaction Log File Info
        Working Log file - size : 575
                           age: 139
        Archive Log file - mms_export_192.168.10.208_20040108_115421  size: 575
      
      A&D Transaction Log File Info
        Working Log file - size : 119
                           age: 139
        Archive Log file - acqdist_192.168.10.208_20040108_115421     size: 119
      
      TV-out Transaction Log File Info
        Working Log file - size : 48
                           age: 139
        Archive Log file - tvout_192.168.10.208_20040108_115421       size: 48
      

    2. The current log file is named working.log, and is stored in the /local/var/log/translog directory (version 2) or /local1/logs (version 4 and 5). Check your current directory.
      ce-5#pwd
      /local
      ce-5#
      change directory to
      ce-5# cd /local/var/log/translog  (version 2)
      ce-5# cd /local1/logs             (version 4)
      check directory contents
      ce-5#pwd
      /local/var/log/translog
      
      ce-5#dir
        size      date         time       name                LongName        
      ----------  -------      ------     -----------         ----------------
             512  May-01-2001  00:00:00   .            <DIR>  .
             512  Jan-01-1988  00:09:14   ..           <DIR>  ..
             512  Aug-02-2000  19:28:32   ARCHIVE      <DIR>  archive
               0  May-01-2001  00:00:00   WORKING.LOG         working.log
          3 DIR(S),     1 FILE(S) 0 bytes
          2130116608 bytes AVAILABLE ON VOLUME /c0t0d0s1
      ce-5#
      

      Version 4 and 5 include a boomerang directory where content routing race results are logged (configured with the boomerang log-races enable command) and an export directory where log file FTP export results are logged (configured with the transaction-logs export command).

    3. To read the contents of the file, issue the type working.log command.
      ce-5#type working.log
      ce-5#
      

      As of now, the file is empty. Notice that the file size in the dir command is zero.

    4. Enable transaction logging.
      ce-5#conf t
      Enter configuration commands, one per line. End with CNTL/Z
      ce-5(config)#transaction-logs enable
                  Starting transaction log processes
                  Started Transaction Log File Manager Archive Script
                  Started Transaction Log Daemon
      ce-5(config)#
      

      Check again to see if transaction logging is enabled.

      ce-5#show transaction-logging
              Transaction Logs:
              Logging is enabled.
              End user identity is visible.
              File markers are disabled
              Archive interval: every-day at 00:00
              Maximum Number of Archived Files:  3
              Exporting files to servers is disabled.
              Export interval: every-day every 1 hour
              Working Log file - size: 0
              age: 48
              No Archive Log file found
      ce-5#
      

      The transaction logs are now enabled.

Verifying the Configuration

These are Web sites that were visited (www.cisco.com for example) to check the contents of the file working.log :

ce-5#type working.log 
987816643.766 116 10.1.1.5 TCP_MISS/0 1468 GET http://www.cisco.com/images* 
987816643.783 133 10.1.1.5 TCP_MISS/0 269 GET http://www.cisco.com/images/* 
987816643.799 299 10.1.1.5 TCP_MISS/0 18036 GET http://www.cisco.com/ - DI* 
987816643.816 166 10.1.1.5 TCP_MISS/0 4508 GET http://www.cisco.com/images* 
987816643.866 83 10.1.1.5 TCP_MISS/0 308 GET http://www.cisco.com/images/h*  
987816643.916 116 10.1.1.5 TCP_MISS/0 269 GET http://www.cisco.com/images/*  
987816643.933 99 10.1.1.5 TCP_MISS/0 1039 GET http://www.cisco.com/images/*  
987816644.16 149 10.1.1.5 TCP_MISS/0 1060 GET http://www.cisco.com/images/*  
987816644.49 133 10.1.1.5 TCP_MISS/0 868 GET http://www.cisco.com/images/h*
987816644.66 133 10.1.1.5 TCP_MISS/0 1130 GET http://www.cisco.com/images/*  
987816644.99 299 10.1.1.5 TCP_MISS/0 13945 GET http://www.cisco.com/images*
987816644.116 83 10.1.1.5 TCP_MISS/0 1886 GET http://www.cisco.com/images/* 
987816644.149 83 10.1.1.5 TCP_MISS/0 729 GET http://www.cisco.com/images/h*  

Tip: Most times, the working.log file will become very large. It is not possible to view the file on screen. To do this, FTP into the Cache Engine and copy the file into a local machine to view it.

To obtain an understanding of TCP_MISS, refer to Understanding Cache Engine Transaction Log Analysis.

To disable transaction logging, issue these commands:

 
ce-5#conf t 
Enter configuration commands, one per line. End with CNTL/Z 
ce-5(config)#no transaction-logs enable 
Stopping transaction log processes: 
Stopped transaction log daemon 
ce-5(config)# 

To check the status of transaction logging, issue this command:

ce-5#sh transaction-logging 
Transaction Logs: 
  Logging is disabled. 
  End user identity is visible. 
  File markers are disabled 
  Archive interval: every-day at 00:00 

  Maximum Number of Archived Files:  3 
  Exporting files to servers is disabled. 
  Export interval: every-day every 1 hour 

 Working Log file - size: 3887 
                      age: Unavailable 
    No Archive Log file found 
ce-5# 

Related Information


Updated: Nov 30, 2005
Document ID: 15040