- Table of Contents
-
- 06-Layer 3-IP Services Command Reference
- 00-Preface
- 01-ARP commands
- 02-IP addressing commands
- 03-DHCP commands
- 04-DNS commands
- 05-NAT commands
- 06-IP forwarding basics commands
- 07-Fast forwarding commands
- 08-Multi-CPU packet distribution commands
- 09-Adjacency table commands
- 10-IP performance optimization commands
- 11-UDP helper commands
- 12-IPv6 basics commands
- 13-DHCPv6 commands
- 14-IPv6 fast forwarding commands
- 15-AFT commands
- 16-Tunneling commands
- 17-GRE commands
- 18-ADVPN commands
- 19-WAAS commands
- 20-Web caching commands
- Related Documents
-
Title | Size | Download |
---|---|---|
20-Web caching commands | 113.06 KB |
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 slot 1
[Sysname-web-cache-slot1] 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 chassis 1 slot 1
[Sysname-web-cache-chassis1-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
# 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 standalone mode.) (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
mdc-admin
mdc-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 downloaded 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 not configured.
Views
Web cache view
Predefined user roles
network-admin
mdc-admin
Parameters
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 standalone mode.)
directory: Specifies the Web cache directory, starting from the storage medium location information chassismslotn#. The chassis number m and slot number n must be the same as the chassis number and 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.
Before setting the Web cache directory, verify that the parent directory does not have a file without an extension that uses the same name as the Web cache directory. For example, to set the Web cache directory to flash:/web-cache, the flash:/ directory? have a file without an extension that is named web-cache. If this requirement is not met, Web caching cannot operate correctly.
The Web caching feature saves Web contents to be cached to files in the Web cache directory. Typically, the files use a lot of storage space (over 1 GB). As a best practice, specify a directory on a storage medium that has sufficient storage space.
The Web cache directory also stores the Web caching operating data.
Examples
# (In standalone mode.) Set the Web cache directory.
<Sysname> system-view
[Sysname] web-cache slot 1
[Sysname-web-cache-slot1] file-directory slot1#flash:/aaa
# (In IRF mode.) Set the Web cache directory.
<Sysname> system-view
[Sysname] web-cache slot 1
[Sysname-web-cache-slot1] file-directory chassis1#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
mdc-admin
Examples
# 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
# 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 use an IPv4 address object to specify the Web servers whose Web contents are to be cached.
Use undo object-group to cancel the configuration.
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.) Use 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
# (In IRF mode.) Use IPv4 object group aaa to specify the source Web servers.
<Sysname> system-view
[Sysname] web-cache chassis 1 slot 1
[Sysname-web-cache-chassis1-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
In standalone mode:
web-cache slot slot-number
undo web-cache slot
In IRF mode:
web-cache chassis chassis-number slot slot-number
undo web-cache chassis
Default
No Web cache views exist.
Views
System view
Predefined user roles
network-admin
Parameters
slot slot-number: Specifies a card by its slot number. (In standalone mode.)
chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. (In IRF mode.)
Examples
# Create a Web cache view and enter its view.
<Sysname> system-view
[Sysname] web-cache slot 1
[Sysname-web-cache-slot1]