- Preface
- Using the WAAS Command-Line Interface
- Cisco WAAS Software Command Summary
- CLI Commands
- EXEC Mode Commands
- Global Configuration Mode Commands
- Interface Configuration Mode Commands
- Standard ACL Configuration Mode Commands
- Extended ACL Configuration Mode Commands
- Preposition Configuration Mode Commands
- PKI Certificate Authority Configuration Mode Commands
- PKI Global Settings Configuration Mode Commands
- SSL Accelerated Service Configuration Mode Commands
- SSL Cipher List Configuration Mode Commands
- SSL Global Service Configuration Mode Commands
- SSL Host Peering Service Configuration Mode Commands
- SSL Management Service Configuration Mode Commands
- WCCP Configuration Mode Commands
- Class Map Configuration Mode Commands
- Policy Map Configuration Mode Commands
- Policy Map Class Configuration Mode Commands
- Acronyms and Abbreviations
- Command Summary by Mode
- (config-preposition) accelerator http preposition dre enable
- (config-preposition) accelerator http preposition task task-name
- (config-preposition) credentials
- (config-preposition) dscp
- (config-preposition) duration
- (config-preposition) enable
- (config-preposition) ignore-hidden-dir
- (config-preposition) max-cache
- (config-preposition) max-file-size
- (config-preposition) min-file-size
- (config-preposition) name
- (config-preposition) pattern
- (config-preposition) recursive
- (config-preposition) root
- (config-preposition) scan-type
- (config-preposition) schedule
- (config-preposition) server
- (config-preposition) use-proxy
- (config-preposition) user-agent
Preposition Configuration Mode Commands
Use preposition configuration mode for configuring preposition tasks and related parameters. To enter this mode, enter the specified preposition command from the global configuration mode. The prompt for preposition configuration mode consists of the hostname of the WAE followed by (config-preposition) and the pound sign (#). You must be in preposition configuration mode to enter preposition configuration commands.
(config-preposition) accelerator http preposition dre enable
To enable DRE (DDUP feature) for preposition connections, use the accelerator http preposition dre enable preposition configuration command. To disable DRE for preposition connections, use the no form of this command.
accelerator http preposition dre enable
no accelerator http preposition dre enable
Syntax Description
Command Default
Command Modes
Device Modes Default
Usage Guidelines
Examples
The following example shows how to enable DRE for preposition connection.
WAAS(config-preposition)# accelerator http preposition dre enable
Related Commands
(config-preposition) accelerator http preposition task task-name
(config-preposition) accelerator http preposition task task-name
To configure a preposition task for one or more sites, use the accelerator http preposition task task-name preposition configuration command. To disable the specified preposition task, use the no form of this command.
accelerator http preposition task task-name duration | enable | pattern | rate | recursion | schedule | url
no accelerator http preposition task task-name duration | enable | pattern | rate | recursion | schedule | url
Command Default
Command Modes
Device Modes Default
Usage Guidelines
Use the sub-mode facility (prompt “>”) to configure a preposition task:
Examples
The following example shows the preposition task “test1,” which runs daily at 14:30. The task length is ten minutes; there is a recursion delay of two seconds between requests. The task URL is www.cisco.com. This task excludes.jsp files, and includes any objects to “www.sampletestdomain.com” if www.cisco.com references it. The task has a maximum download rate of 1000, and the recursion depth is four.
Related Commands
(config-preposition) accelerator http preposition dre enable
(config-preposition) credentials
To set the username and password credentials for a file server in a preposition directive, use the credentials preposition configuration command.
credentials username username password { 0 | 1 } password }
Syntax Description
Specifies the password. To indicate that the password string is unencrypted, specify 0. To indicate that the password string is encrypted, specify 1. |
Defaults
Command Modes
preposition configuration mode
Device Modes
Examples
Related Commands
(config-preposition) dscp
To set the DSCP marking value for a preposition task, use the dscp preposition configuration command. To remove a DSCP marking value, use the no form of this command.
Syntax Description
Defaults
Command Modes
preposition configuration mode
Device Modes
Usage Guidelines
This command specifies the DSCP marking value to be used for prepositioning traffic.
DSCP is a field in an IP packet that enables different levels of service to be assigned to the network traffic. The levels of service are assigned by marking each packet on the network with a DSCP code and associating a corresponding level of service. DSCP is the combination of IP Precedence and Type of Service (ToS) fields. For more information, see RFC 2474.
For details on the valid DSCP marking values, see Table 3-2, “DSCP Marking Values” for the service-policy global configuration command.
Examples
Related Commands
(config-preposition) duration
To set the maximum duration for a preposition task, use the duration preposition configuration command. To remove a duration limit, use the no form of this command.
Syntax Description
Maximum number of minutes that the preposition task is allowed to run. |
Defaults
Command Modes
preposition configuration mode
Device Modes
Usage Guidelines
This command specifies the maximum amount of time that the WAAS software should take to complete the preposition task. If the software takes longer than this amount of time, the software stops the prepositioning process before all files are copied to the Edge WAE cache. If the preposition task does not start at the scheduled start time (for example, because the Edge and the Core have no connection), the start retries are counted in the duration. If you do not specify a value for this command, WAAS takes as much time as needed to export this file server.
Examples
Related Commands
(config-preposition) enable
To enable a preposition directive, use the enable preposition configuration command. To disable a preposition directive, use the no form of this command.
Syntax Description
Defaults
Command Modes
preposition configuration mode
Device Modes
Usage Guidelines
You must use this command to enable a preposition directive after you define it and schedule it.
Examples
Related Commands
(config-preposition) ignore-hidden-dir
To ignore hidden directories in the set of files to be prepositioned, use the ignore-hidden-dir preposition configuration command.
Syntax Description
Defaults
Command Modes
preposition configuration mode
Device Modes
Examples
Related Commands
(config-preposition) max-cache
To set the maximum percentage of the cache that the files from a preposition directive can use, use the max-cache preposition configuration command.
Syntax Description
Integer from 1–100 that specifies a percentage of the overall Edge WAE cache that prepositioned files can consume. |
Defaults
Command Modes
Preposition configuration mode
Device Modes
Examples
Related Commands
(config-preposition) max-file-size
To set the maximum size file that can be prepositioned, use the max-file-size preposition configuration command. To remove this limit, use the no form of this command.
Syntax Description
Defaults
Command Modes
preposition configuration mode
Device Modes
Usage Guidelines
Files that are larger than the specified size are not prepositioned.
Examples
Related Commands
(config-preposition) min-file-size
To set the minimum size file that can be prepositioned, use the min-file-size preposition configuration command. To remove this limit, use the no form of this command.
Syntax Description
Defaults
Command Modes
preposition configuration mode
Device Modes
Usage Guidelines
Files that are smaller than the specified size are not prepositioned.
Examples
Related Commands
(config-preposition) name
To set the display name of a preposition directive, use the name preposition configuration command.
Syntax Description
Defaults
Command Modes
preposition configuration mode
Device Modes
Examples
Related Commands
(config-preposition) pattern
To filter the files included for a preposition directive, use the pattern preposition configuration command. To remove this filter, use the no form of this command.
pattern { equals | starts-with | ends-with | contains } text
no pattern { equals | starts-with | ends-with | contains } text
Syntax Description
Defaults
Command Modes
preposition configuration mode
Device Modes
Examples
Related Commands
(config-preposition) recursive
To include files in subdirectories for a preposition directive, use the recursive preposition configuration command. To not include subdirectories, use the no form of this command.
Syntax Description
Defaults
Command Modes
preposition configuration mode
Device Modes
Examples
Related Commands
(config-preposition) root
To set a root directory for a preposition directive, use the root preposition configuration command.
Syntax Description
Full pathname to the directory, not including the server name. |
Defaults
Command Modes
preposition configuration mode
Device Modes
Usage Guidelines
You can configure multiple root directories by executing this command multiple times for a preposition directive.
Examples
Related Commands
(config-preposition) recursive
(config-preposition) scan-type
To set the file scanning type for a preposition directive, use the scan-type preposition configuration command.
scan-type { full | since last | since period units }
Syntax Description
Defaults
Command Modes
preposition configuration mode
Device Modes
Examples
Related Commands
(config-preposition) schedule
To set the schedule for starting a preposition task, use the schedule preposition configuration command.
schedule { now |
daily time |
date date time |
weekly { dayname [ dayname ]...} time time |
monthly { week-day dayname weeknumber time time | { day day [ day ]...} } time time }
Syntax Description
Defaults
Command Modes
preposition configuration mode
Device Modes
Examples
The following example shows how to set the preposition task to run on December 15, 2008 at midnight:
The following example shows how to set the preposition task to run weekly on Wednesdays and Fridays at 8 p.m.:
The following example shows how to set the preposition task to run monthly on the 1st and 15th days at 1:00 a.m.:
Related Commands
(config-preposition) server
To set a server name for a preposition directive, use the server preposition configuration command.
Syntax Description
Defaults
Command Modes
preposition configuration mode
Device Modes
Examples
Related Commands
(config-preposition) use-proxy
To enable the proxy use by a specific preposition task, use the use-proxy global configuration command. To disable proxy use by a specific preposition task, the no form of this command.
Syntax Description
Command Default
Command Modes
Device Modes Default
Usage Guidelines
For WAAS Version 6.2.1 and later, you can preposition external content in the case of a deployment with proxy. Consider the following when configuring HTTP/S preposition proxy for Akamai Connect:
- IPv4 proxy is supported for HTTP/S prepositioning.
- The HTTP preposition proxy feature is a feature independent of the WAAS CM and external HTTP proxy.
- Specific IP address-based proxy configuration is supported for HTTP/S preposition proxy. File-based and auto-detected configurations are not supported for HTTP/S preposition proxy.
Examples
Related Commands
(config-preposition) accelerator http preposition task task-name
(config-preposition) user-agent
To create a user agent to display information about the client browsers and operating systems used to access the URLs specified for a preposition task, use the user-agent global configuration command. To not use a specified user agent, use the no form of this command.
no user-agent user-agent-string
Syntax Description
String for the user agent. Use only letters, numbers, hyphen, and underscore, up to a maximum of 256 characters. |
Defaults
Syntax Description
Command Default
Command Modes
Device Modes Default
Usage Guidelines
The user agent displays information about the client browsers and operating systems used to access the URLs specified for a particular preposition task. The server populates the cache with content that is dependent in part on the type of user agent used for the specified cache prepositioning task.