Configuring File Services
To accelerate CIFS traffic, you can enable and configurethe CIFS accelerators, as described below.
Configuring the CIFS Accelerator
The CIFS accelerator relies on automatic discovery and transparently accelerates CIFS traffic with no configuration needed.
Table 11-1 provides an overview of the steps that you must complete to configure the CIFS accelerator.
Table 11-1 Checklist for Configuring CIFS Accelerator
|
Additional Information and Instructions
|
Prepare for file services. |
Provides the tasks that you need to complete before enabling and configuring file services on your WAAS devices. For more information, see Preparing for File Services. |
Enable SMB acceleration. |
Enables and configures the SMB accelerator. For more information, see Enabling and Disabling the Global Optimization Features of Chapter 12, “Configuring Application Acceleration.” |
(Optional) Identify dynamic shares. |
Identifies the dynamic shares on an exported file server. If your file server uses Access Based Enumeration (ABE) to give users different views of the share, you must configure the dynamic shares on the WAAS Central Manager. For more information, see Creating Dynamic Shares for the CIFS Accelerator |
(Optional) Create a preposition directive. |
Defines which files are proactively copied from an exported file server to the Edge WAE cache. For more information, see About Preposition Directives section. |
Creating Dynamic Shares for the CIFS Accelerator
Many file servers use dynamic shares, that is, multiple users can access the same share, but the share is then automatically mapped to a different directory based on a user’s credentials. Dynamic shares are most commonly used on file servers to set up user home directories. For example, a directory named Home can be set up as a dynamic share on a file server so that each user accessing that share is automatically redirected to their own personal directory.
If a file server contains a dynamic share or is using Access Based Enumeration (ABE), you must register that dynamic share with the WAAS Central Manager, as described in this section.
Defining a dynamic share in the WAAS Central Manager allows each user to see a different view of the share and allows the operation of ABE if it is configured on the Windows Server.
Note Dynamic share configuration on the WAAS Central Manager overrides any dynamic share configuration set up directly on the WAE device using the CLI.
Before adding a dynamic share, note the following limitations:
- Each dynamic share on a file server must be unique.
- You cannot add a dynamic share if that share has a preposition directive. You must remove the preposition policy before you can add the dynamic share.
- You can use the WAAS Central Manager GUI to define any directory as a dynamic share. However, if a directory is not set up as a dynamic share on the file server, all the users will read or write the same content from the same directory and will not be redirected to different directories based on their credentials.
To add a dynamic share for the CIFS accelerator, follow these steps:
Step 1 From the WAAS Central Manager menu, choose Configure > CIFS File Services > Dynamic Shares.
A list of dynamic shares appears. The Dynamic Shares window shows all the dynamic shares that are configured. From this window, you can perform the following tasks:
- Edit the configuration of an existing dynamic share by clicking the Edit icon next to the share. You can delete a dynamic share, or modify any of the dynamic share settings.
- Add a new dynamic share definition.
Step 2 Click the Create New Dynamic Share icon in the taskbar to add a new dynamic share.
The Creating a new Dynamic Share window appears.
Step 3 In the Name field, enter a name for the dynamic share.
The following characters are not supported in the dynamic share name: /, \, :, *, ?, ", <, >, |. From the Assigned Domain drop-down list, choose the WAAS domain that you want to assign to the dynamic share. Only administrators who are also assigned to this WAAS domain have permission to edit the dynamic share configuration. The domain does not affect a client’s access to the dynamic share.
Note A WAAS domain is not the same as a DNS domain or Windows domain. For more information on WAAS domains, see Working with Domains.
This kind of WAAS domain does not use entities. When defining the WAAS domain, choose None for the Entity Type. The WAAS domain must be assigned to each WAAS admin user who needs to edit the dynamic share configuration (see Assigning a Domain to a User Account).
Step 4 In the File Server field, enter the name or IP address of the file server with the dynamic share.
If you specify the file server name, the Edge WAE resolves it to an IP address.
The registered file servers are displayed in a drop-down list.
Step 5 In the User name, Password, and Confirm Password fields, enter the username and password credentials for the file server. If the username is in a Windows domain, specify the domain name as part of the User name field, as follows: domain\username.
These credentials are used only to access the file server when you click Browse.
Step 6 In the Share Name field, specify the location of the dynamic share by doing one of the following tasks:
- Enter the name of the dynamic share on the file server. The following characters cannot be used in the share name: \, /, :, *, ?, “, <, >, |.
- Click Browse next to the Share Name field to navigate to the correct root directory.
Note The Browse button appears only if you have at least one WAE device with the CIFS accelerator enabled and registered to the WAAS Central Manager.
Step 7 Ensure that the status of the share is set to Enabled. If you change the status to Disabled, the share will not be set up as a dynamic share in your WAAS environment.
Step 8 Click Submit.
The specified directory now functions as a dynamic share on the Edge WAE cache.
About Preposition Directives
A preposition directive allows you to determine which files should be proactively copied from CIFS file servers to the cache of selected Edge WAEs. Prepositioning enables you to take advantage of the idle time on the WAN to transfer frequently accessed files to selected WAEs, where users can benefit from cache-level performance even during first-time access of these files.
Prepositioning is supported on automatically discovered file servers in the transparent CIFS accelerator.
When defining a preposition directive, select the Edge WAEs that you want to be prepositioned with content from the file server, and then specify the root directories on the file server to be prepositioned. Initially, the preposition directive is in the unscheduled state. You must create a schedule that determines when and how often the content is prepositioned. Because content can be prepositioned on a regular basis, you can specify whether each new iteration of the task should copy all designated files, or only those files that have changed over a specified time interval.
In addition, you can specify time and size limits to prevent a preposition task from consuming too much bandwidth on the WAN or too much space on the Edge WAE cache. We strongly recommend that you use these limits to optimize network efficiency and prevent misuse of this feature.
When the activation time of a preposition directive arrives, a preposition task starts on the Edge WAE. Each preposition task can be monitored in the WAAS Central Manager GUI during and after processing. You can also terminate active preposition tasks, if required.
Prepositioning requires that the username and password needed to access the file server be specified. These items are specified directly in the Creating New Preposition Directive window, as described in Creating a New Preposition Directive.
Note When preposition updates are sent to the Central Manager, if any preposition file server credentials cannot be decrypted, all further preposition updates are not sent from the WAE to the Central Manager, and decryption failure error messages are logged in errorlog/cms_log.current. You must reconfigure the preposition credentials from the CLI.
Prepositioning includes the ability to configure multiple roots. See Creating a New Preposition Directive.
When using prepositioning, both branch and data center WAEs are required (the same as for any other accelerated traffic). The branch WAE retrieves prepositioned files through an optimized connection. Verify that you have connectivity between the following network entities:
- Client to branch WAE
- Branch WAE to data center WAE
- Branch WAE to file server
- Data center WAE to file server
You will need to change any ACLs that might be blocking prepositioning traffic.
Note Although preposition directives can be created and managed by using the CLI, we recommend that you use the Central Manager GUI because you can manage prepositioning for groups of WAEs from the Central Manager. If you mix GUI and CLI configuration, unpredictable results may occur because changes on one device can affect other devices.
The following topics describe how to create and manage a preposition directive:
Creating a New Preposition Directive
To create a preposition directive, follow these steps:
Step 1 From the WAAS Central Manager menu, choose Configure > CIFS File Services > Preposition.
The Preposition Directives window appears. This window displays the following information about preposition directives that exist on the system:
- Preposition Directive—Name of the preposition directive.
- Type—Whether the preposition directive affects all files (Full) or just those that have changed since the last preposition task (Differential).
– When the type is Full, all the files that match the other filters of the task and that are found on the file server are sent to the Edge to be compared with the cache.
– When the type is Differential, only the files that are found as changed since the last successful preposition are sent to the Edge cache. The time of the last successful preposition is taken from the Edge device, so ensure that the clock is synchronized with the file server. The first scan is always a full scan. If you change the preposition task, the last successful scan time is reset.
– When the type is Since, only the files that are found as changed within a specified time period are sent to the Edge cache.
- Status—Whether the preposition directive is enabled or disabled.
- File Server—Name of the exported file server.
From the Preposition Directive window, you can perform the following tasks:
- Edit the configuration of an existing preposition directive by clicking the Edit icon next to the corresponding directive. You can then delete the preposition directive, or modify any of the settings.
- Add a new preposition directive, as described in the following steps.
Step 2 Click the Create New Preposition Directive icon in the taskbar to create a new preposition directive.
The Creating New Preposition Directive window appears. (Figure 11-2)
Figure 11-2 Creating a New Preposition Directive Window
Step 3 Enter a unique name for the directive. The name cannot contain characters other than letters, numbers, period, hyphen, and underscore; the double quote (") character is not allowed in the name.
Step 4 From the Status drop-down list, choose either enabled or disabled. (Disabled directives are not put into effect.)
Step 5 (Optional) Define the time and size limitations using the provided fields.
Note Table 11-3 describes the time and size limitation fields.If one of these limits is exceeded during a prepositioning task, the task is terminated and a message is sent to the Administrator log. Any remaining files are exported the next time the task is run. If a user requests one of the missing files before this happens, it is fetched over the WAN through WAAS software as usual.
Step 6 (Optional) Check the Ignore Hidden Directories check box if you want to prevent hidden directories on the file server from being prepositioned. This check box is unchecked by default. If you leave this box unchecked, hidden directories are prepositioned.
Step 7 In the File Server field, enter the unique name of a file server to export. The name cannot contain characters other than letters, numbers, period, hyphen, and underscore; the double quote (") or forward slash (/) characters are not allowed in the name.
Step 8 From the Location drop-down list, choose the device location that will provide browsing services for the file server. Normally, this is the data center WAE. For the best browsing performance, specify a location that is close to the file server. The location is used only for browsing; each edge WAE will retrieve prepositioned files directly from the file server, not from this location. For more information on defining locations, see Working with Device Locations.
Step 9 In the User name, Password, and Confirm Password fields, enter the username and password credentials for the file server. If the username is in a Windows domain, specify the domain name as part of the User name field, as follows: domain\username.
The access credentials that you enter must allow read access to the prepositioned root directories and to their parent directories.
Step 10 (Optional) Check the DSCP value for high priority messages check box if you want to assign a DSCP marking value to the prepositioning traffic. Choose a DSCP value from the drop-down list or enter a number from 0 to 63 in the text field.
DSCP is a field in an IP packet that enables different levels of service to be assigned to the network traffic. 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.
Step 11 In the Root Share and Directories field, enter the directories on the file server that you want to export. Use any of the following methods to identify a directory:
- Manually enter one or more directory paths in the following format: protocol :// server / share or server\share, for example, cifs://win12srv/home or win12srv\home. You can enter multiple lines for multiple directories, with each full directory path on its own line. You cannot specify the root directory (/) as a root share.
When you define multiple root shares, the preposition sequence that is performed for a single root configuration is repeated for each root serially.
- Click Browse to browse the directories on the file server. To navigate to a directory, click the File Folder icon to the left of the directory name. Check the check box next to the directory that you want to export and then click Select Directory. The browse window allows you to choose multiple directories.
The browse function operates best when you choose the location of the nearest CIFS accelerator to the file server, from the Location drop-down list. If you do not choose a location, the browse request is sent to all the devices that have the CIFS accelerator enabled, and the request may time out.
- Check the Include Sub Directories check box to include all the subdirectories under the specified root directory. If this option is not selected, only the files in the specified root directory are prepositioned and you cannot select subdirectories when you are browsing.
- Narrow the policy definition to a particular type of file by choosing a pattern operator from the File Name drop-down list and entering the text that describes the pattern in the adjacent text box, for example, enter ends with.doc. Do not use a space or the following special characters:
|, :, >, <, ", ?, *, /, \.
Step 12 Click Submit.
The directive is saved and additional tabs appear at the top of the window.
Assigning Edge Devices to a Preposition Directive
After you create a preposition directive, you need to assign Edge WAEs or device groups to the directive. This task determines which Edge WAEs will store-preposition content in their cache.
Note Prepositioning includes the ability to configure multiple roots. See Creating a New Preposition Directive.
To assign an Edge WAE or device group to a preposition directive, follow these steps:
Step 1 From the WAAS Central Manager menu, choose Configure > CIFS File Services > Preposition.
The Preposition Directives window appears, which lists the preposition directives that exist on the system.
Step 2 Click the Edit icon next to the preposition directive that you want to assign to an Edge WAE or device group.
Step 3 Click one of the following tabs at the top of the window:
- Assign Edge Devices —Allows you to select one or more Edge WAEs to assign to this directive.
- Assign Edge Groups —Allows you to select a device group to assign to this directive.
The Edge Device Assignments window or the Device Groups Assignments window appears, depending on the selected option.
For either view, the assignments window lets you filter your view of the items in the list. Filtering enables you to find items in the list that match the criteria that you set.
Step 4 Choose the Edge WAEs or device groups to assign to this preposition directive by doing either of the following:
(Assign All) in the taskbar to assign all the available Edge WAEs or device groups to this directive.
next to the individual Edge WAE or device group that you want to assign to this directive. The icon changes to
when selected.
Note If a device or device group is offline (identified by ), then you cannot assign that device or group to this directive. The preposition directive, when assigned to a device group, is applied only to connected Edge devices in the assigned device group.
When assigning a CIFS accelerator preposition directive to a device group, the directive is applied only to those devices enabled for CIFS acceleration in the assigned device group.
Step 5 Click Submit.
The icon next to each edge device or device group you selected changes to .
Note If the CIFS accelerator is disabled on a WAE, the WAE is removed from any preposition directives to which it is assigned. Also, the preposition directive is removed from the device’s running configuration.
Creating a New Preposition Schedule
After you create a preposition directive and assign WAEs to the directive, we recommend that you create a schedule that determines when and how often prepositioning occurs.
For example, you may want to schedule prepositioning to occur at night to minimize the amount of traffic during business hours, or, you may want to schedule prepositioning to occur on a recurring basis if the exported data changes often. This will help ensure that the WAEs assigned to this directive have the latest file updates in their cache.
When a preposition task is scheduled to begin at the same time for multiple Edge WAEs that are located in different timezones, the task will begin on the Edge WAEs based on the Core WAE timezone. If the clocks of the Edge WAE and the Core WAE are not synchronized, the task will not start on time.
To create a preposition schedule, follow these steps:
Step 1 From the WAAS Central Manager menu, choose Configure > CIFS File Services > Preposition.
The Preposition Directives window appears, which lists the preposition directives that exist on the system.
Step 2 Click the Edit icon next to the preposition directive for which you want to create a schedule.
Step 3 Click the Schedule tab at the top of the window.
The Creating New Preposition Schedule window appears. By default, no schedule is configured.
Step 4 Choose one of the following scheduling options:
- Not Scheduled—Prepositioning is not scheduled at this time.
- Now—Prepositioning occurs within a few minutes after you submit this schedule.
A Now schedule begins again each time you make a change to the preposition directive and click Submit button.
A Now schedule also begins again as soon as an Edge device that has been reloaded comes back online.
- Daily—Prepositioning occurs daily at the defined time.
- Date—Prepositioning occurs at the defined time and date.
- Weekly—Prepositioning occurs on the selected days of the week at the defined time.
- Monthly Days—Prepositioning occurs on the selected days of the month at the defined time.
- Monthly Weekdays—Prepositioning occurs on the defined day (as opposed to a defined date) and time during the month. For example, you can schedule prepositioning to occur on the second Tuesday of every month.
Step 5 Specify a start time for the prepositioning task.
The time is expressed in 24-hour format with 00:00 representing midnight. The time refers to the local time of the Edge WAE where the data is to be prepositioned. If there are multiple Edge WAEs in different time zones, the time refers to the local time of the Core WAE.
Note You cannot schedule a start time for the Now option.
Step 6 Click Submit.
The message Changes Submitted appears at the bottom of the window confirming that your schedule was saved.
Step 7 Verify that the preposition directive has completed successfully by checking the preposition status. For more information, see Checking the Preposition Status.
Checking the Preposition Status
After you create one or more preposition directives, you can verify the status of all the preposition tasks to ensure that they are completed successfully. If a task does not complete successfully, then some of the prepositioned files may have not been copied to the Edge WAE cache.
To check the status of a prepositioning task, follow these steps:
Step 1 From the WAAS Central Manager menu, choose Configure > CIFS File Services > Preposition.
The Preposition Directives window, which lists the preposition directives that exist on the system, appears.
Step 2 Click the Edit icon next to the preposition directive that you want to check.
Step 3 Click the Preposition Status tab at the top of the window.
The Preposition Status window displays the following information:
- WAE—The name of each Edge WAE that received the prepositioned files in its cache.
- Start Time—The time the preposition task started.
- Duration—The amount of time it took the preposition task to be completed.
- Amount Copied—The amount of data copied to the WAE cache, in bytes.
- Status—Whether the preposition task is completed successfully.
- Reason—The reason a preposition task failed.
Step 4 Ensure that the Status column shows Completed.
If this column shows Failure, look in the Reason column for an explanation that can help you troubleshoot why the preposition task failed. After resolving the issue, you can schedule the preposition task to run again now, or wait until the scheduled start time and verify the status again later.
Starting and Stopping Preposition Tasks
You can start or stop a preposition task from the Device Manager GUI.
Configuring the SMB Accelerator
Table 11-2 provides an overview of the steps that you must complete to configure the SMB accelerator.
Table 11-2 Checklist for Configuring SMB Accelerator
|
Additional Information and Instructions
|
Prepare for file services. |
Provides the tasks that you need to complete before enabling and configuring file services on your WAAS devices. For more information, see Preparing for File Services. |
Enable SMB acceleration. |
Enables and configures the SMB accelerator. For more information, see Enabling and Disabling the Global Optimization Features of Chapter 12, “Configuring Application Acceleration.” |
(Optional) Identify dynamic shares. |
Identifies the dynamic shares on an exported file server. If your file server uses Access Based Enumeration (ABE) to give users different views of the share, you must configure the dynamic shares on the WAAS Central Manager. For more information, see Creating Dynamic Shares for the SMB Accelerator. |
(Optional) Create a preposition directive. |
Defines which files are proactively copied from an exported file server to the Edge WAE cache. For more information, see About Preposition Directives |
About Preposition Directives
A preposition directive allows you to determine which files should be proactively copied from SMB file servers to the cache of selected Edge WAEs. Prepositioning enables you to take advantage of the idle time on the WAN to transfer frequently accessed files to selected WAEs, where users can benefit from cache-level performance even during first-time access of these files.
Note Cisco SMB AO supports accelerating client connections to Microsoft DFS shares. However, Cisco SMB prepositioning does not support Microsoft DFS.
Prepositioning of SMB v3 encrypted traffic is not supported in this release.
Prepositioning is supported on automatically discovered file servers in the SMB accelerator.
When defining a preposition directive, select the Edge WAEs that you want to be prepositioned with content from the file server, and then specify the root directories on the file server to be prepositioned. Initially, the preposition directive is in the unscheduled state. You must create a schedule that determines when and how often the content is prepositioned.
In addition, you can specify time and size limits to prevent a preposition task from consuming too much bandwidth on the WAN or too much space on the Edge WAE cache. We strongly recommend that you use these limits to optimize network efficiency and prevent misuse of this feature.
When the activation time of a preposition directive arrives, a preposition task starts on the Edge WAE. Each preposition task can be monitored in the WAAS Central Manager GUI during and after processing. You can also terminate active preposition tasks, if required.
Prepositioning requires that the username and password needed to access the file server be specified. These items are specified directly in the Creating New Preposition Directive window, as described in Creating a New Preposition Directive.
Note When preposition updates are sent to the Central Manager, if any preposition file server credentials cannot be decrypted, all further preposition updates are not sent from the WAE to the Central Manager, and decryption failure error messages are logged in errorlog/cms_log.current. You must reconfigure the preposition credentials from the CLI.
Prepositioning includes the ability to configure multiple roots. See Creating a New Preposition Directive.
When using prepositioning, both branch and data center WAEs are required (the same as for any other accelerated traffic). The branch WAE retrieves prepositioned files through an optimized connection. Verify that you have connectivity between the following network entities:
- Client to branch WAE
- Branch WAE to data center WAE
- Branch WAE to file server
- Data center WAE to file server
You will need to change any ACLs that might be blocking prepositioning traffic.
Note Although preposition directives can be created and managed by using the CLI, we recommend that you use the Central Manager GUI because you can manage prepositioning for groups of WAEs from the Central Manager. If you mix GUI and CLI configuration, unpredictable results may occur because changes on one device can affect other devices.
Note We recommend that you configure not more than 25 preposition directives per device.
If you want to enable DRE, you will need to select the SMB Preposition DRE settings checkbox, by navigating to the Device> Configure > Acceleration > SMB Preposition Settings. It is disabled by default.
Whenever DRE is enabled for the all prepositioning tasks, files are cached in Object Cache and DRE cache, particularly when the size of the prepositioned files is huge and this could affect the normal traffic. Else the files will be cached only in Object Cache.
The following topics describe how to create and manage a preposition directive:
Creating a New Preposition Directive
To create a preposition directive, follow these steps:
Step 1 From the WAAS Central Manager menu, choose Configure > SMB File Services > Preposition.
The Preposition Directives window appears. This window displays the following information about preposition directives that exist on the system:
- Preposition Directive—Name of the preposition directive.
- Status—Whether the preposition directive is enabled or disabled.
- File Server—Name of the exported file server.
- Schedule Details—Schedule to determine how often content is prepositioned.
From the Preposition Directive window, you can perform the following tasks:
- Edit the configuration of an existing preposition directive by clicking the Edit icon next to the corresponding directive. You can then delete the preposition directive, or modify any of the settings.
- Assign the Device or Device Group (s) to the preposition operation by clicking the Assign Device/DeviceGroup(s) icon and select the appropriate one.
- Collect Preposition Status by clicking the Collect Preposition Status link.
- Add a new preposition directive, as described in the following steps.
Step 2 Click the Create New Preposition icon in the taskbar to create a new preposition directive.
The Creating New Preposition Directive window appears. (Figure 11-3)
Figure 11-3 Creating a New Preposition Directive Window
Step 3 Under Preposition Settings, enter a unique name for the directive. The name cannot contain characters other than letters, numbers, period, hyphen, and underscore; the double quote (") character is not allowed in the name.
Step 4 Click the Enable Preposition check box. This denotes status of preposition. This is unchecked by default. If you disable it, preposition is not possible.
Step 5 (Optional) Define the time and size limitations using the provided fields.
Table 11-3 describes the time and size limitation fields.
Table 11-3 Preposition Time and Size Limitations
|
|
Total Size as % of Cache Volume |
Percentage of the overall Edge WAE cache that prepositioned files can consume. For example, if you do not want this prepositioning directive to consume more than 30 percent of a WAE’s cache, enter 30 in this field. The default value is 5 percent. The percentage of the cache defined for a preposition task defines the maximum size that can be prepositioned in a single iteration of the task regardless of how much is already in the cache. The total size of the files to be prepositioned will always be less than or equal to the total percentage of object cache size specified. Example, if the user had specified max-cache directive as 10% and total object-cache size is 100 GB, then the maximum size of the total files to be prepositioned for the task would be 10 GB(10% of 100 GB). If there are 100 files in the configured shares and first 50 files size up to 10 GB,then the rest of the files would not be prepositioned. When the cache is full, regardless of the reason, prepositioning operates like on-demand caching: an eviction process begins and the files with the oldest time-last-accessed values are removed from the cache. |
Max File Size |
Maximum file size that can be exported. Files that are larger than this value are not exported to the WAE cache. |
Min File Size |
Minimum file size that can be exported. Files that are smaller than this value are not exported to the WAE cache. It is inefficient to preposition files smaller than 20 KB because these files can be retrieved quickly over the WAN through normal WAAS. The default value is 20 KB. |
Duration |
Maximum amount of time it should take WAAS to export the file server. If it takes WAAS longer than this amount of time to export the file server, WAAS stops the exporting 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 field, WAAS takes as much time as needed to export this file server. |
Note If one of these limits is exceeded during a prepositioning task, the task is terminated and a message is sent to the Administrator log. Any remaining files are exported the next time the task is run. If a user requests one of the missing files before this happens, it is fetched over the WAN through WAAS software as usual.
Step 6 Under File Server Settings, check the SMBv2 checkbox to enable prepositioning of this traffic. This is disabled by default.
Step 7 In the File Server field, enter the unique name of a file server to export. The name cannot contain characters other than letters, numbers, period, hyphen, and underscore; the double quote (") or forward slash (/) characters are not allowed in the name.
Step 8 From the Nearest Device drop-down list, choose the device location that will provide browsing services for the file server. Normally, this is the data center WAE. For the best browsing performance, specify a location that is close to the file server. The location is used only for browsing; each edge WAE will retrieve prepositioned files directly from the file server, not from this location. For more information on defining locations, see Working with Device Locations.
Step 9 In the User name, Password, and Confirm Password fields, enter the username and password credentials for the file server. If the username is in a Windows domain, specify the domain name in the Domain name field.
The access credentials that you enter must allow read access to the prepositioned root directories and to their parent directories.
The following characters are not allowed to be used as username ; | && || : \ / * ? < > + =, [ ] “ ` !.
The following characters are not allowed to be used in server names ; | && ||, ~ : ! ` @ # $ % ^ & ‘ { } () _ “
The following characters are not allowed to be used as domain names ; | && || : \ / * ? < > “ ` !
Step 10 Under Content Settings, in the Root Share and Directories field, enter the directories on the file server that you want to export. Use any of the following methods to identify a directory:
- Manually enter one or more directory paths in the following format: protocol :// server / share or server\share, for example, cifs://win12srv/home or win12srv\home. You can enter multiple lines for multiple directories, with each full directory path on its own line. You cannot specify the root directory (/) as a root share. Special characters like ; | && || : * ? < > “ ` ! [ ] + =, are not allowed for top level shares. Additionally, when you create subdirectories inside the shares, the following special characters are not allowed: ; | && || : * ? < > “ ` !
Note Do not use the special character “;“ in files and directory names, else it will throw up errors. Additionally, we do not support extended Unicode characters in files and directories for release 6.2.1 and any such files or directories would be skipped and not prepositioned.
When you define multiple root shares, the preposition sequence that is performed for a single root configuration is repeated for each root serially.
- Click Browse to browse the directories on the file server. To navigate to a directory, click the File Folder icon to the left of the directory name. Check the check box next to the directory that you want to export and then click Select Directory. The browse window allows you to choose multiple directories.
The browse function operates best when you choose the location of the nearest SMB accelerator to the file server, from the Location drop-down list. If you do not choose a location, the browse request is sent to all the devices that have the SMB accelerator enabled, and the request may time out.
- Check the Include Sub Directories check box to include all the subdirectories under the specified root directory. If this option is not selected, only the files in the specified root directory are prepositioned and you cannot select subdirectories when you are browsing.
- Narrow the policy definition to a particular type of file by choosing a pattern operator from the File Name drop-down list and entering the text that describes the pattern in the adjacent text box, for example, enter ends with.doc. Do not use a space or the following special characters:
; | && || : * ? < > \ / “ ` !
Step 11 By default, a Now schedule begins (if the status is enabled) again each time you make a change to the preposition directive page. A new schedule also begins again as soon as an edge device that has been reloaded comes back online. Under Schedule Settings, select the frequency of preposition from the Frequency drop-down list.
– Not-Scheduled- By default this option will be displayed to user.
– Immediate- Prepositioning occurs within a few minutes after click on ok button in schedule dialog.
– Date - Prepositioning occurs at the defined time and date..
– Daily-Prepositioning occurs daily at the defined time.
– Weekly-Prepositioning occurs on the selected days of the week at the defined time.
– Monthly Days-Prepositioning occurs on the selected days of the month at the defined time.
– Monthly WeekDays - Prepositioning occurs on the selected month weekdays at the defined time
Step 12 Specify the preposition start time from the Start Time drop-down list.
The time is expressed in 24-hour format with 00:00 representing midnight. The time refers to the local time of the Edge WAE where the data is to be prepositioned. If there are multiple Edge WAEs in different time zones, the time refers to the local time of the Core WAE.
Step 13 Click OK.
The directive is saved and is added to the preposition directive table.
Assigning Edge Devices to a Preposition Directive
After you create a preposition directive, you need to assign Edge WAEs or device groups to the directive. This task determines which Edge WAEs will store-preposition content in their cache.
Note Prepositioning includes the ability to configure multiple roots. See Creating a New Preposition Directive.
To assign an Edge WAE or device group to a preposition directive, follow these steps:
Step 1 From the WAAS Central Manager menu, choose Configure > SMB File Services > Preposition.
The Preposition Directives window appears, which lists the preposition directives that exist on the system.
Step 2 Select the appropriate Preposition Directive to assign it to the Device /Device Groups and click on Assign Devices/ Device Groups icon. The Assign Device/Device Groups Assignments window appears. The assignments window lets you filter your view of the items in the list. Filtering enables you to find items in the list that match the criteria that you set.
Step 3 Choose the Edge WAEs or device groups to assign to this preposition directive and click Assign. The Assigned Status column changes to Assigned next to the selected Device/Device Groups. You can also un-assign a Device/Device Group by clicking on Unassign. The Assigned Status column changes to Not Assigned accordingly.
Step 4 In case there is a delay in sending the preposition details to the device, the Assigned Status column displays NOTIFY UPDATES IN-PROGRESS for the Device/Device Group. Click on Refresh to see a change in status once the preposition changes have been made on the device.
Note If a device or device group is offline (identified by ), then you cannot assign that device or group to this directive. The preposition directive, when assigned to a device group, is applied only to connected Edge devices in the assigned device group.
When assigning a SMB accelerator preposition directive to a device group, the directive is applied only to those devices enabled for SMB acceleration in the assigned device group.
Step 5 Click OK.
Note If the SMB accelerator is disabled on a WAE, the SMB accelerator preposition task will fail with error that SMB accelerator is not enabled on the WAE.
Creating a New Preposition Schedule
After you create a preposition directive and assign WAEs to the directive, we recommend that you create a schedule that determines when and how often prepositioning occurs.
For example, you may want to schedule prepositioning to occur at night to minimize the amount of traffic during business hours, or, you may want to schedule prepositioning to occur on a recurring basis if the exported data changes often. This will help ensure that the WAEs assigned to this directive have the latest file updates in their cache.
When a preposition task is scheduled to begin at the same time for multiple Edge WAEs that are located in different timezones, the task will begin on the Edge WAEs based on the Core WAE timezone. If the clocks of the Edge WAE and the Core WAE are not synchronized, the task will not start on time.
To create a preposition schedule, follow these steps:
Step 1 From the WAAS Central Manager menu, choose Configure > SMB File Services > Preposition.
The Preposition Directives window appears, which lists the preposition directives that exist on the system.
Step 2 Click the Edit icon next to the preposition directive for which you want to create a schedule.
Step 3 Click the Schedule tab at the top of the window.
The Creating New Preposition Schedule window appears. By default, no schedule is configured.
Step 4 Choose one of the following scheduling options:
- Not Scheduled—Prepositioning is not scheduled at this time.
- Now—Prepositioning occurs within a few minutes after you submit this schedule.
A Now schedule begins again each time you make a change to the preposition directive and click Submit. A Now schedule also begins again as soon as an Edge device that has been reloaded comes back online.
- Daily—Prepositioning occurs daily at the defined time.
- Date—Prepositioning occurs at the defined time and date.
- Weekly—Prepositioning occurs on the selected days of the week at the defined time.
- Monthly Days—Prepositioning occurs on the selected days of the month at the defined time.
- Monthly Weekdays—Prepositioning occurs on the defined day (as opposed to a defined date) and time during the month. For example, you can schedule prepositioning to occur on the second Tuesday of every month.
Step 5 Specify a start time for the prepositioning task.
The time is expressed in 24-hour format with 00:00 representing midnight. The time refers to the local time of the Edge WAE where the data is to be prepositioned. If there are multiple Edge WAEs in different time zones, the time refers to the local time of the Core WAE.
Note You cannot schedule a start time for the Now option.
Step 6 Click Submit.
The message Changes Submitted appears at the bottom of the window confirming that your schedule was saved.
Step 7 Verify that the preposition directive has completed successfully by checking the preposition status. For more information, see Checking the Preposition Status.
Checking the Preposition Status
After you create one or more preposition directives, you can verify the status of all the preposition tasks to ensure that they are completed successfully. If a task does not complete successfully, then some of the prepositioned files may have not been copied to the Edge WAE cache.
To check the status of a prepositioning task, follow these steps:
Step 1 From the WAAS Central Manager menu, choose Configure > SMB File Services > Preposition.
The Preposition Directives window, which lists the preposition directives that exist on the system, appears.
Step 2 Select the SMB preposition directive that you want to check and click the Collect Preposition Status tab at the top of the window.
The Preposition Status window displays the following information:
- WAE—The name of each Edge WAE that received the prepositioned files in its cache.
- Start Time—The time the preposition task started.
- Duration—The amount of time it took the preposition task to be completed.
- Amount Copied—The amount of data copied to the WAE cache, in bytes.
- Status—Whether the preposition task is completed successfully.
- Error Reason—The reason a preposition task failed.
Ensure that the Status column shows Completed.
If this column shows Failure, look in the Reason column for an explanation that can help you troubleshoot why the preposition task failed. After resolving the issue, you can schedule the preposition task to run again now, or wait until the scheduled start time and verify the status again later.
Step 3 Click OK.
You can also export this data and save it to your local machine.
Creating Dynamic Shares for the SMB Accelerator
Many file servers use dynamic shares, which allow multiple users to access the same share but then be automatically mapped to a different directory based on the user’s credentials. Dynamic shares are most commonly used on file servers to set up user home directories. For example, a directory named Home can be set up as a dynamic share on a file server so each user accessing that share is automatically redirected to their own personal directory.
If a file server contains a dynamic share or is using Access Based Enumeration (ABE), you must register that dynamic share with the WAAS Central Manager as described in this section.
Defining a dynamic share in the WAAS Central Manager allows each user to see a different view of the share and allows the operation of ABE if it is configured on the Windows Server.
Note Dynamic share configuration on the WAAS Central Manager overrides any dynamic share configuration set up directly on the WAE device using the CLI.
Before adding a dynamic share, note the following limitations:
- Each dynamic share on a file server must be unique.
- You cannot add a dynamic share if that share has a preposition directive. You must remove the preposition policy before you can add the dynamic share.
- You can use the WAAS Central Manager GUI to define any directory as a dynamic share. However, if a directory is not set up as a dynamic share on the file server, all users will read or write the same content from the same directory and will not be redirected to different directories based on their credentials.
To add a dynamic share for SMB accelerator, follow these steps:
Step 1 From the WAAS Central Manager menu, choose Devices > Configure > SMB File Services > Dynamic Shares.
A list of dynamic shares appears. The Dynamic Shares window shows all the dynamic shares configured. From this window, you can perform the following tasks:
Edit the configuration of an existing dynamic share by clicking the Edit icon next to the share. You can delete the dynamic share, or modify any of the dynamic share settings.
Add a new dynamic share definition, as described in the next steps.
Step 2 Click the Add Dynamic Share icon in the taskbar to add a new dynamic share. The Creating a new Dynamic Share window appears.
Step 3 In the File Server field, enter the name or IP address of the file server with the dynamic share.
If you specify the file server name, the edge WAE resolves it to an IP address.
The registered file servers are displayed in a drop-down list.
Step 4 In the Share name field, specify the location of the dynamic share by doing one of the following tasks:
Enter the name of the dynamic share on the file server. The following characters cannot be used in the share name: \ / : * ? “ < > |
Click Browse next to the Share Name field to navigate to the correct root directory.
Note The Browse button appears only if you have at least one WAE device with the SMB accelerator enabled and registered to the WAAS Central Manager.
Step 5 Click OK to submit the changes.
The specified directory now functions as a dynamic share on the Edge WAE cache.