Contents

Web caching commands· 1

cached-data· 1

cache-limit 2

display web-cache· 3

file-directory· 6

http enable· 7

listen-port 7

object-group· 8

web-cache· 9

 

Web caching commands

cached-data

Use cached-data to specify the types of the files on webpages to be cached.

Use undo cached-data to restore the default.

Syntax

cached-data { apk | bmp | doc | docx | gif | gzip | ipa | jar | jpg | jpeg | pdf | png | ppt | pptx | rar | swf | tar | txt | xls | xlsx | zip } *

undo cached-data

Default

No webpage file types are specified.

Views

Web cache view

Predefined user roles

network-admin

mdc-admin

Parameters

apk: Specifies .apk files.

bmp: Specifies .bmp files.

doc: Specifies .doc files.

docx: Specifies .docx files.

gif: Specifies .gif files.

gzip: Specifies .gzip files.

ipa: Specifies .ipa files.

jar: Specifies .jar files.

jpg: Specifies .jpg files.

jpeg: Specifies .jpeg files.

pdf: Specifies .pdf files.

png: Specifies .png files.

ppt: Specifies .ppt files.

pptx: Specifies .pptx files.

rar: Specifies .rar files.

swf: Specifies .swf files.

tar: Specifies .tar files.

txt: Specifies .txt files.

xls: Specifies .xls files.

xlsx: Specifies .xlsx files.

zip: Specifies .zip files.

Usage guidelines

If you do not specify the types of the files on webpages to be cached, the Web caching feature does not cache any types of files on webpages.

Execute this command before enabling Web caching.

Before modifying file type settings, you must disable Web caching. After modifying file type settings, enable Web caching again.

Examples

# (In standalone mode.) Configure the Web caching feature to cache .doc and .docx files on webpages.

<Sysname> system-view

[Sysname] web-cache

[Sysname-web-cache] cached-data doc docx

# (In IRF mode.) Configure the Web caching feature to cache .doc and .docx files on webpages.

<Sysname> system-view

[Sysname] web-cache slot 1

[Sysname-web-cache-slot1] cached-data doc docx

Related commands

http enable

cache-limit

Use cache-limit to set the maximum total size for Web cache files.

Use undo cache-limit to restore the default.

Syntax

cache-limit size

undo cache-limit

Default

The maximum total size of Web cache files is 4 GB.

Views

Web cache view

Predefined user roles

network-admin

mdc-admin

Parameters

size: Specifies the maximum total size for Web cache files in GB. The value range is 1 to 4095. The default is 4.

Usage guidelines

Before modifying Web caching parameters, you must disable Web caching first. After modifying Web caching parameters, enable Web caching again.

The actual maximum total size for Web cache files is the smaller one between the specified maximum total size and the maximum storage space size in the working directory. To display the maximum size of storage space in the working directory, execute the display web-cache command. After the actual maximum total size is reached, the device deletes the oldest Web cache file to save the new Web cache file.

The aging time for Web cache files is fixed at 30 days. When the device reboots or receives a request for the contents in a Web cache file, it restarts the aging timer. If no users request the contents in a file before the aging timer expires, the device deletes the file.

Examples

# (In standalone mode.) Set the maximum total size for Web cache files to 3 GB.

<Sysname> system-view

[Sysname] web-cache

[Sysname-web-cache] cache-limit 3

# (In IRF mode.) Set the maximum total size for Web cache files to 3 GB.

<Sysname> system-view

[Sysname] web-cache slot 1

[Sysname-web-cache-slot1] cache-limit 3

display web-cache

Use display web-cache to display Web caching information.

Syntax

display web-cache [ history ] [ last { day | 30-days | 365-days | hour | minute | week } | verbose ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

history: Displays history information. If you do not specify this keyword, the command displays the current statistics, which is collected at 1-second intervals.

last: Displays statistics for a specific period of time in the past. If you do not specify this keyword, the command displays the current statistics and statistics for specific periods of time in the past.

minute: Displays statistics for the most recent one minute.

hour: Displays statistics for the most recent one hour.

day: Displays statistics for the most recent one day.

week: Displays statistics for the most recent one week.

30-days: Displays statistics for the most recent 30 days.

365-days: Displays statistics for the most recent 365 days.

verbose: Displays detailed information. If you do not specify this keyword, the command displays brief information.

Examples

# Display the current Web caching statistics.

[Sysname-web-cache-slot0] display web-cache history

Date TimeRange ConnectTop CacheTop BandwidthSaved CacheHitRate

2018/06/20 14:43:02-14:43:03 3 16.0KB 0 0%

2018/06/20 14:43:01-14:43:02 3 16.0KB 96.0Kbps 100%

# Display all Web caching information.

<Sysname> display web-cache

Web-cache configurations

  Cache path: /var/web-cache/proxy/cache

  Max connections: 1022

  Max cache size: 3GB

 

Current state information

  Cache memory: 0

  Cache count: 0

 

Last 1 minute state information

  ConnectTop: 2

  CacheTop: 0

  Bandwidth saved:           0

    Service speed:           0        Service size:         0

    Download speed:          0        Download size:        0

  CacheHitRate: 0%

    Hit count: 0                     Miss count: 0

 

Last 1 hour state information

  ConnectTop: 2

  CacheTop: 0

  Bandwidth saved:           0

    Service speed:           0        Service size:         0

    Download speed:          0        Download size:        0

  CacheHitRate: 0%

    Hit count: 0                     Miss count: 0

 

Last 1 day state information

  ConnectTop: 2

  CacheTop: 463.4MB

  Bandwidth saved:           0

    Service speed:           0        Service size:         0

    Download speed:          0        Download size:        0

  CacheHitRate: 0%

    Hit count: 0                     Miss count: 0

 

Last 30 days state information

  ConnectTop: 2

  CacheTop: 463.4MB

  Bandwidth saved:           0

    Service speed:           0        Service size:         0

    Download speed:          0        Download size:        0

  CacheHitRate: 0%

    Hit count: 0                     Miss count: 0

 

Last 365 days state information

  ConnectTop: 2

  CacheTop: 463.4MB

  Bandwidth saved:           0

    Service speed:           0        Service size:         0

    Download speed:          0        Download size:        0

  CacheHitRate: 0%

Hit count: 0                     Miss count: 0

# Display detailed history Web caching statistics.

<Sysname> display web-cache history verbose

2018/06/05 09:02:47-09:02:48

  ConnectTop: 2

  CacheTop: 0

  Bandwidth saved:           0

    Service speed:           0        Service size:         0

    Download speed:          0        Download size:        0

  CacheHitRate: 0%

    Hit count: 0                     Miss count: 0

 

2018/06/05 09:02:46-09:02:47

  ConnectTop: 2

  CacheTop: 0

  Bandwidth saved:           0

    Service speed:           0        Service size:         0

    Download speed:          0        Download size:        0

  CacheHitRate: 0%

    Hit count: 0                     Miss count: 0

Table 1 Command output

Field	Description
Cache path	Web cache directory.
Max connections	Maximum number of connections allowed.
Max cache size	Current maximum storage space size.
Cache memory	Current total size of Web cache files.
Cache count	Number of Web cache files.
Last 1 minute state information	Web caching statistics for the most recent one minute.
Last 1 hour state information	Web caching statistics for the most recent one hour.
Last 1 day state information	Web caching statistics for the most recent one day.
Last 30 days state information	Web caching statistics for the most recent 30 days.
Last 365 days state information	Web caching statistics for the most recent 365 days.
ConnectTop	Maximum number of connections during the specified period of time.
CacheTop	Maximum total size (in MB) of Web cache files during the specified period of time.
Bandwidth saved	Reduced bandwidth during the specified period of time.
Service speed	Speed at which cached data was transferred to users during the specified period of time.
Service size	Amount of cached data that was transferred to users during the specified period of time, in kilobytes.
Download speed	Speed at which cached data was downloaded from Web servers during the specified period of time.
Download size	Amount of cached data that was received from Web servers during the specified period of time, in kilobytes.
CacheHitRate	Percentage of hits of cached data.
Hit count	Number of hits of cached data.
Miss count	Number of times that cached data was not matched.

 

file-directory

Use file-directory to set the Web cache directory.

Use undo file-directory to restore the default.

Syntax

file-directory directory

undo file-directory

Default

The Web cache directory is flash:/var/web-cache.

Views

Web cache view

Predefined user roles

network-admin

Parameters

directory: Specifies the Web cache directory, starting from the fixed storage medium location information slot0#. (In standalone mode.)

directory: Specifies the Web cache directory, starting from the storage medium location information slotn#. The slot number n must be the same as the slot number of the Web cache view. (In IRF mode.)

Usage guidelines

Before modifying Web caching parameters, you must disable Web caching first. After modifying Web caching parameters, enable Web caching again.

The Web caching feature saves Web contents to be cached to files in the Web cache directory.

If the specified directory does not exist, the device automatically creates the directory.

Examples

# (In standalone mode.) Set the Web cache directory.

<Sysname> system-view

[Sysname] web-cache

[Sysname-web-cache] file-directory slot0#flash:/aaa

# (In IRF mode.) Set the Web cache directory.

<Sysname> system-view

[Sysname] web-cache slot 1

[Sysname-web-cache-slot1] file-directory slot1#flash:/aaa

http enable

Use http enable to enable Web caching.

Use undo http enable to disable Web caching.

Syntax

http enable

undo http enable

Default

Web caching is disabled.

Views

Web cache view

Predefined user roles

network-admin

Examples

# (In standalone mode.) Enable Web caching.

<Sysname> system-view

[Sysname] web-cache

[Sysname-web-cache] http enable

# (In IRF mode.) Enable Web caching.

<Sysname> system-view

[Sysname] web-cache slot 1

[Sysname-web-cache slot1] http enable

Related commands

listen-port

server

listen-port

Use listen-port to specify the Web caching listening port number.

Use undo listen-port to restore the default.

Syntax

listen-port port-number

undo listen-port

Default

The Web caching listening port number is not set.

Views

Web cache view

Predefined user roles

network-admin

Parameters

port-number: Specifies a TCP port number in the range of 0 to 65535.

Usage guidelines

Make sure the specified TCP port number is not being used by any other services on the device. To display TCP port numbers being used, execute the display tcp verbose command.

Execute this command before enabling Web caching.

Before modifying Web caching parameters, you must disable Web caching first. After modifying Web caching parameters, enable Web caching again.

Examples

# (In standalone mode.) Set the Web caching listening port number to 655.

<Sysname> system-view

[Sysname] web-cache

[Sysname-web-cache] listen-port 655

# (In IRF mode.) Set the Web caching listening port number to 655.

<Sysname> system-view

[Sysname] web-cache slot 1

[Sysname-web-cache-slot1] listen-port 655

object-group

Use object-group to reference an IPv4 address object to specify the Web servers whose Web contents are to be cached.

Use undo object-group to cancel the reference.

Syntax

object-group ip object-group-name

undo object-group

Default

The Web caching feature is allowed to cache webpage contents from all Web servers.

Views

Web cache view

Predefined user roles

network-admin

mdc-admin

Parameters

ip object-group-name: Specifies an IPv4 object group by its name, a case-insensitive string of 1 to 31 characters.

Usage guidelines

This command requires the cooperation of the IPv4 object group feature. For more information about the IPv4 object group feature, see object group configuration in Security Configuration Guide.

Execute this command before enabling Web caching.

Before changing the IPv4 object group setting, you must disable Web caching. After changing the IPv4 object group setting, enable Web caching again.

Examples

# (In standalone mode.) Reference IPv4 object group aaa to specify the Web servers whose Web contents are to be cached.

<Sysname> system-view

[Sysname] web-cache

[Sysname-web-cache] object-group aaa

# (In IRF mode.) Reference IPv4 object group aaa to specify the Web servers whose Web contents are to be cached.

<Sysname> system-view

[Sysname] web-cache slot 1

[Sysname-web-cache-slot1] object-group aaa

Related commands

object-group (Security Command Reference)

web-cache

Use web-cache to create a Web cache view and enter its view, or enter an existing Web cache view.

Use undo web-cache to delete a Web cache view and all settings in the view.

Syntax

web-cache slot slot-number

undo web-cache slot

Default

No Web cache views exist.

Views

System view

Predefined user roles

network-admin

Parameters

slot slot-number: Specifies an IRF member device by its member ID. (In IRF mode.)

Examples

# (In standalone mode.) Create a Web cache view and enter its view.

<Sysname> system-view

[Sysname] web-cache

[Sysname-web-cache]

# (In IRF mode.) Create a Web cache view and enter its view.

<Sysname> system-view

[Sysname] web-cache slot 1

[Sysname-web-cache-slot1]