Managing oplocks

Setting a system-wide oplock

There is a system-wide oplock setting on the filer. If you enable this oplock setting, you can enable or disable oplocks for individual qtrees.

To set the system-wide oplock setting, complete the following step.

Step	Action
1	Enter the following command: options cifs.oplocks.enable [ on \| off ] Result If the `cifs.oplocks.enable` option is set to On, the oplock setting per qtree takes effect. Otherwise, the oplocks for all qtrees are disabled regardless of the per-qtree oplock setting.

Setting an oplock for each qtree

To enable or disable an oplock for an individual qtree, complete the following step.

Step	Action
1	Enter the following command: *qtree oplocks qtree_name* [ enable \| disable ]** qtree_name is the name of the qtree. Result If the `cifs.oplocks.enable` option is set to On, the `qtree oplocks` command for a qtree takes effect immediately. If the `cifs.oplocks.enable` option is Off, the `qtree oplocks` command does not take effect until the option is changed to On.

Step

Action

Enter the following command:

qtree oplocks qtree_name [ enable | disable ]

qtree_name is the name of the qtree.

Result

If the cifs.oplocks.enable option is set to On, the qtree oplocks command for a qtree takes effect immediately. If the cifs.oplocks.enable option is Off, the qtree oplocks command does not take effect until the option is changed to On.

About the delay time for sending oplock breaks

If a client sends a request to open a file at the same time the filer needs to send an oplock break to that client, the filer delays sending an oplock break according to the delay time value set by the command options cifs.oplocks.opendelta. This delay is necessary to work around a race condition that exists in some CIFS clients. The default delay time is 8 milliseconds. This means that after the filer receives or responds to a request to open a file, the filer will make sure that 8 milliseconds have elapsed before sending an oplock break.

Changing the delay time for sending oplock breaks

You can change the default delay time for sending oplock breaks. For example, you might want to increase the delay time if you issue the cifs stat command and the output shows a non-zero value for the OpLkBkNoBreakAck field.

You may also see syslog messages similar to the following example and want to increase the delay time for sending oplock breaks.

Example

Mon Jan 21 15:18:38 PST [CIFSAdmin:warning]: oplock break timed out 
to station JOHN-PC for file \\FILER\share\subdir\file.txt

Changing the delay time for sending oplock breaks

To change the delay time for sending oplock breaks, complete the following step.

Step	Action
1	Enter the following command: options cifs.oplocks.opendelta time time is the delay time in milliseconds. Note Changing the delay time value delays the response to all file-open requests. Do not set this number higher than 35 without first consulting Network Appliance Technical Support.