Phone Lines icon GFI Support

Articles in this section

See more

Exinda CLI: Edge Cache Acceleration

Author: Sughra Mehdi Updated

Overview

 

This article provides information regarding the Exinda CLI command acceleration edge-cache. 

You can use the acceleration edge-cache command to configure Edge Cache acceleration. Edge Cache enables single-sided caching of Internet-based content, including web objects, videos and software updates. Edge Cache requires only one Exinda appliance.

When web objects are downloaded from the Internet or across WAN links, Edge Cache stores them at the edge of the network. When subsequent requests come for the same material, the content is quickly delivered from Edge Cache, without the need to re-download the data over the WAN. The result is the ability to experience LAN speeds of WAN objects, and provide users with better network experience.

Edge Cache also supports HTTPS sites allowing the appliance to be a forward proxy and decrypt content for caching. This is important as more and more applications and services are moving to the cloud. These SaaS-based applications are typically delivered over HTTPS and so to be effective, Edge Cache must support caching this HTTPS traffic.

 

Information

 

NOTE:  The following syntax convention is used:
  • {}: Options are enclosed in braces and are separated by '|'
  • []: Optional keywords are enclosed in brackets
  • <>: User input is required where variables are enclosed in greater-than and less-than symbols

The following table describes the commands used for performing common actions related to the edge-cache acceleration:

 

Action Description

 Command Parameter Description

To specify the maximum and minimum size of objects to store

 acceleration edge-cache object-size {maximum|minimum> <size> <size> – The size parameter should use SI units e.g. 100M or 512k.

To specify how long Edge Cache should wait for a response when fetching objects from the server

 acceleration edge-cache connect-timeout <seconds> NA (Not Applicable) 

To add or remove an HTTP URL or domain that should be blacklisted (i.e. should never be cached)

 [no] acceleration edge-cache never-cache <URL or domain> NA (Not Applicable) 
To add or remove HTTP applications that should be cached [no] acceleration edge-cache application <application>

application <application> - Only applications that use the HTTP protocol are supported.
To enable [or disable] HTTPS caching

[no] acceleration edge-cache enable-https

 NA (Not Applicable) 

To specify the signing certificate to use to create dynamic SSL certificates during HTTPS caching

 acceleration edge-cache https-cert <cert-name> NA (Not Applicable) 
To specify an HTTPS black-list of IPs or domains acceleration edge-cache https-list-type black-list

Specifies that Edge Cache will use a black-list for determining what sites can not be cached. All others will be allowed.

acceleration edge-cache https-black-list {dest-domain|dest-ip|src-domain|src-ip}

  • src-domain <domain> - The domain that initiated the conversation.
  • src-ip <ip> - The IP that initiated the conversation. The IP can include a mask.
  • dest-domain <domain> - The domain that was the destination of the conversation.
  • dest-ip <ip> - The IP that was the destination of the conversation. The IP can include a mask.
Note: Domains are resolved using the DSN. Ensure the domains are in the format that is required by DNS (i.e. without https://)
To remove a domain or IP from the black-list no acceleration edge-cache https-black-list <internal ID>

https-black list <internal ID> – To determine the internal ID, type: no acceleration edge-cache https-black-list ?, which presents the list of HTTPS black-list sites in the format: Internal ID, Type, Value
To specify an HTTPS white-list of IPs or domains acceleration edge-cache https-list-type white-list

Specifies that Edge Cache will use a white-list for determining what sites can be cached. No others will be allowed.

acceleration edge-cache https-white-list {dest-domain|dest-ip|src-domain|src-ip}

  • src-domain <domain> - The domain that initiated the conversation.
  • src-ip <ip> - The IP that initiated the conversation. The IP can include a mask.
  • dest-domain <domain> - The domain that was the destination of the conversation.
  • dest-ip <ip> - The IP that was the destination of the conversation. The IP can include a mask.
Note: Domains are resolved using the DSN. Ensure the domains are in the format that is required by DNS (i.e. without https://)
To remove a domain or IP from the white-list no acceleration edge-cache https-white-list <internal ID>

https-white list <internal ID> - To determine the internal ID, type: no acceleration edge-cache https-white-list ?, which presents the list of HTTPS whit-list sites in the format: Internal ID, Type, Value

To clear the object cache

 acceleration edge-cache cache clear NA (Not Applicable) 
To configure an Edge Cache peer [no] acceleration edge-cache peer <hostname> [http-port|icp-port|option]

If you have an upstream proxy in your environment, you can configure it as a proxy peer to ensure that Edge Cache can fetch content from the Internet.

  • <hostname> - The hostname of the peer object memory.
  • http-port <port> - The HTTP port for the peer command
  • icp-port <port> - The ICP port for the peer command
  • option default - Use the default peer options
  • option proxy-only - Do not cache objects from this peer.
  • option no-query - This peer does not support ICP
  • option weight=n - Specify the peer priority. Peers with higher priority will be consulted first.
  • option round-robin - Specify that peers should be consulted in round-robin order.
  • option closest-only - Only forward closest parent ICP misses.
  • option originserver - Specify that this peer is an origin server

To never fetch a file directly; always use the peer

 [no] acceleration edge-cache never-direct NA (Not Applicable) 

To prevent delays when skipping ahead during video downloads

 acceleration edge-cache range-offset <limit> NA (Not Applicable) 

To show the current Edge Cache configuration settings

 show acceleration edge-cache NA (Not Applicable) 

 

VERSION INFO
As of version 7.0.2, Edge Cache can cache HTTPS content, as well as HTTP content.

 

Find more CLI commands.

Back to Top