The Search Files and Manage Directories page lets you search the file system using various search criteria. The default is File or Directory Name but you can also search for large files, directories with quotas, watched directories, or by custom search criteria such as filename, owner, file size, and so on. The file and directory listings are taken from the fsimage stored on the NameNode, so the listings will be only as current as the last checkpoint. Typically the checkpoint interval is (by default) once per hour, but if checkpoints are not being performed as frequently, the listings may not be up to date.

To search the file system:

1. Select Reports > Search Files and Manage Directories.
2. Click the to the right of Search and do one of the following:
   • Select a predefined query. Depending on what you select, you may be presented with different fields to fill in or different views of the file system. For example, selecting Large Files will provide fields where you provide size to be used as the search criteria.
   • Select Custom. A Choose... drop-down is added.
     1. Select a property in the Choose... drop-down.
     2. Select an operator.
     3. Specify a value.
     4. Click to add another criteria (all of which must be satisfied for a file to be considered a match) and repeat the preceding steps.
3. Click the Search button to execute the search.

If you search within a directory, only files within that directory will be found. For example, if you browse /user and do a search, you might find /user/foo/file, but you will not find /bar/baz.

1. Select Reports > Search Files and Manage Directories.
2. Browse the file system to find the directory for which you want to set quotas.
3. Click the Manage Quota button at the right of the row for the directory you want. A Manage Quota pop-up displays, where you can set file count or disk space limits for the directory you have selected.
4. When you have set the limits you want, click OK.

About file count limits

• The file count quota is a limit on the number of file and directory names in the directory configured.
• A directory counts against its own quota, so a quota of 1 forces the directory to remain empty.
• File counts are based on the intended replication factor for the files; changing the replication factor for a file will credit or debit quotas.

About disk space limits

• The space quota is a hard limit on the number of bytes used by files in the tree rooted at the directory being configured.
• Each replica of a block counts against the quota.
• The disk space quota calculation takes replication into account, so it uses the replicated size of each file, not the user-facing size.
• The disk space quota calculation includes open files (files presently being written), as well as files already written.
• Block allocations for files being written will fail if the quota would not allow a full block to be written.

1. To add or remove directories from the directory-based usage reports, do one of the following:
   • Select Reports > Search Files and Manage Directories.
   • Click Reports, click the Current Disk Usage By Directory or Historical Disk Usage By Directory link, and click the Search Files and Manage Directories button.
2. Navigate through the file system to see the directory you want to add - you can include a directory at any level without needing to include its parent.
3. Toggle the Star icon () at the left of the directories to watch. When the icon is in the activated form (), the directory appears in the usage reports. To stop watching a directory, deactivate the Star icon.