Preposition Configuration Mode Commands

To create and modify preposition directives on a WAAS device for prepositioning files for WAFS, use the accelerator cifs preposition global configuration command.

accelerator cifs preposition directive_id

Syntax Description

directive_id

Preposition directive ID of an existing preposition directive that you want to change or a new directive that you want to create.

Defaults

No default behavior or values.

Command Modes

global configuration

Device Modes

application-accelerator

Usage Guidelines

Use the accelerator cifs preposition command to create and edit preposition directives to be used with the transparent CIFS accelerator. A preposition directive defines a set of files that are to be prepositioned on the WAE device.

Within preposition configuration mode, you can use the various commands (server, root, scan-type, schedule, and so on) to configure a preposition directive. After you are done defining and scheduling the preposition directive, you must use the command to enable it. To return to global configuration mode, enter the exit command at the preposition configuration mode prompt.

Note We recommend that you use the WAAS Central Manager GUI to configure preposition directives. For more information, see the "Creating a Preposition Directive" section in the Cisco Wide Area Application Services Configuration Guide.

Note If you create a preposition directive from the CLI before the secure store on the WAE is initialized, you must wait at least two datafeed poll cycles (10 minutes by default) before initializing the secure store; otherwise, the preposition directive will not propagate to the Central Manager because the credentials will not be able to be decrypted on the WAE.

Examples

The following example shows how to enter preposition configuration mode and configure a preposition directive using the accelerator cifs preposition command:

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.

dscp value

no dscp value

Syntax Description

value

DSCP marking value to assign to prepositioning traffic.

Defaults

No default behavior or values.

Command Modes

preposition configuration mode

Device Modes

application-accelerator

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.

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.

duration minutes

no duration minutes

Syntax Description

minutes

Maximum number of minutes that the preposition task is allowed to run.

Defaults

No default behavior or values.

Command Modes

preposition configuration mode

Device Modes

application-accelerator

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

The following example shows how to set the maximum task duration to 60 minutes:

Related Commands

(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

full

Specifies to copy all files to the Edge WAE cache.

since last

Specifies to copy only the files that have changed since the last preposition to the Edge WAE cache. This differential filter is applied from the second iteration of a task execution onward.

If a new directory is moved to an already prepositioned directory (without changing its last-modified time), this new directory is not prepositioned during the next prepositioning session when you choose this option.

since period units

Specifies to copy only the files that have changed within the specified period. Period values are the number of minutes, hours, days, or weeks (depending on the units specified). Unit values are min, hour, day, or week.

Defaults

Full

Command Modes

preposition configuration mode

Device Modes

application-accelerator

Examples

The following example shows how to set the scan-type for a preposition directive:

Syntax Description

Specifies that prepositioning occurs within a few minutes of submitting the schedule.

daily time

Specifies that prepositioning occurs daily at the defined time at which to run the prepositioning task, in the following format: hh:mm, where hh is the hour (00-23) and mm is the minutes (00-59).

Hours are in 24-hour format, as in the following example: 23:01

date date time

Specifies that prepositioning occurs at the defined time and date at which to run the prepositioning task, in the following format: DD:MM:YYYY, where DD is the day (01-31), MM is the month (01-12), and YYYY is the year (1993-2035). The time is in the following format: hh:mm, where hh is the hour (00-23) and mm is the minutes (00-59).

Example: 28:09:2008 23:01

weekly dayname

Specifies that prepositioning occurs on the selected days of the week at the defined time. To specify multiple days, separate them with spaces, as follows: Monday Tuesday

time time

Specifies the time to run the preposition task on the specified days.

monthly

Specifies that prepositioning occurs on the selected days or dates of the month at the defined time.

week-day dayname weeknumber

Specifies a named day of the week and week of the month to start preposition. Only one day is allowed. Week number values are 1-4.

day day

Specifies a numbered day of the month (integer). To specify multiple days, separate them with spaces, as follows: day 1 6 11 16 21 26 31.

Defaults

now

Command Modes

preposition configuration mode

Device Modes

application-accelerator

Examples

The following example shows how to set the preposition task to run daily at 11:30 p.m.:

WAE(config)# accelerator cifs preposition 3

WAE(config-preposition)# schedule daily 23 30 00

The following example shows how to set the preposition task to run on December 15, 2008 at midnight:

WAE(config-preposition)# schedule date 15:12:2008 00:00

The following example shows how to set the preposition task to run weekly on Wednesdays and Fridays at 8 p.m.:

WAE(config-preposition)# schedule weekly Wednesday Friday time 20:00

The following example shows how to set the preposition task to run monthly on the 1st and 15th days at 1:00 a.m.: