Administration Guides

Unlock My files Help Desk Application


Read Me First

Users leave files open and locked.  This requires finding the Isilon node with the open file and issuing a command to break the lock. This is a time consuming process.  This feature is design to allow a help desk to securely find and break locks on files without any permissions on Isilon.

Please read Notes below to understand more about locked files

  1. This feature only displays files that are locked and opened with write permissions.  Applications that open for read only do not place locks on files. example notepad, wordpad do not lock files
  2. NOTE: Very important information about open files, not all applications use persistent file handles and many applications do not lock files ever.   If a file does not show up in the results it likely means the application does not use persistent file handles and does not lock files.   This is application Dependant. 

Known Issues

  1. See Release note entry

The Solution

  1. Unlock my files!  is a new desktop icon with a dedicated permission to allow delegation to a help desk to unlock files for end users.
  2. Search for a file based on name or partial string match
  3. Find the file in the list
  4. Click break lock button
  5. Done.


  1. Requires Onefs 8.x or later.
  2. Latest 2.5.5 build MUST be used. Key updates are only available in the latest build of 2.5.5.  Follow the upgrade guide to get updated.
  3. MANDATORY STEPS BEFORE USE See guide with sudoer permissions changed required

How to add Unlock My Files Icon permission to the admin user role

  1. Login as admin
  2. Open User Roles icon
  3. find the file lock portal permission and enable it.
  4. Save admin role

How to delegate Unlock My Files to the Help Desk

  1. Please read the Full RBAC Guide for trouble shooting and configuring RBAC.
  2. The RBAC feature is required to provide AD login and delegation to a Help desk to unlock files.
  3. Prerequisites
    1. Create an AD group in AD for this role
      1. NOTE: group name cannot have spaces or special characters, the group name should be all lower case.
  4. Open the User Roles icon
    1. Create new role in User roles called "Help desk" with the + sign
    2. Assign the AD group to this role
      1. NOTE: syntax of AD group MUST be DOMAIN\lowercasegroupname  (where domain name is uppercase, and ad group name is lower case)
    3. Add the file lock portal permission to this role and save the role.

How to find Locked files and Break locks

  1. Type the name of the file or partial match of the file.
  2.  NOTE: do not enter zone name, do not enter special characters for the path , only enter text for the path, or exact file name.   
  3. Best Practice: only enter the name of the file, or text of the directory the file is in,  do not enter files with spaces 
    1. example path is /ifs/data/groups/marketing/project123.docx   search for project123.docx  or enter marketing to search for files open in the marketing fodder
  4. Results will return all matching files and directories
    1. NOTE:  Only 100 files are returned, if the file is not listed a more accurate file match search is required.
    2. NOTE: if the file is closed and reopened you must search again since the file handle will change.  If you try to break the lock on a file that is re-opened you may see this error message below which means the file handle has changed since the search was completed.

  5. NOTE: The locked column will shows files with a SMB file lock applied the client application.  If it does not display locked status it means the application did not open the file with a lock request.
  6. Use the show only locked files filter to view only files with lock requests
  7. Click the break lock icon next to the file.  Answer yes to the break lock when prompted.
    1. NOTE: Breaking a lock on an application can lose data if the application has not committed the data to the file.
  8. Verify with user that the file is unlocked and attempt to re-open the file.

Copyright Superna LLC