File Browser

The File Browser application lets you browse and manipulate files and directories in the Hadoop Distributed File System (HDFS) while using Hue. With File Browser, you can:

File Browser Installation and Configuration

File Browser is one of the applications installed as part of Hue. For information about installing and configuring Hue, see Hue Installation.

Starting File Browser

To start the File Browser application, click the File Browser icon ( images/image8.png ) in the navigation bar at the top of the Hue browser page.

Working with Files and Directories

You can use File Browser to view the input and output files of your MapReduce jobs. Typically, you can save your output files in /tmp or in your home directory if your system administrator set one up for you. You must have the proper permissions to manipulate other user's files.

Creating Directories

To create a directory:

  1. In the File Browser window, select New > Directory.
  2. In the Create Directory dialog box, enter a directory name and then click Submit.

Changing Directories

To change to a different directory, do one of the following:

  • Click the directory name or parent directory dots in the File Browser window.
  • Click the (images/image9.png) icon, type a directory name, and press Enter.

To change to your home directory, click Home in the path field at the top of the File Browser window.

  Note:

The Home button is disabled if you do not have a home directory. Ask a Hue administrator to create a home directory for you.

Creating Files

To create a file:

  1. In the File Browser window, select New > File.
  2. In the Create File dialog box, enter a file name and then click Submit.

Uploading Files

You can upload text and binary files to the HDFS.

To upload files:

  1. In the File Browser window, browse to the directory where you want to upload the file.
  2. Select Upload > Files.
  3. In the box that opens, click Upload a File to browse to and select the file(s) you want to upload, and then click Open.

Downloading Files

You can download text and binary files to the HDFS.

To download files:

  1. In the File Browser window, check the checkbox next to the file you want to download.
  2. Click the Download button.

Uploading Zip Archives

You can upload zip archives to the HDFS. The archive is uploaded and extracted to a directory named <archivename>.

To upload a zip archives:

  1. In the File Browser window, browse to the directory where you want to upload the archive.
  2. Select Upload > Zip file.
  3. In the box that opens, click Upload a zip file to browse to and select the archive you want to upload, and then click Open.

Renaming, Moving, and Deleting Files and Directories

To rename a file or directory:

  1. In the File Browser window, check the checkbox next to the file or directory you want to rename.
  2. Click the Rename button.
  3. Enter the new name and then click Submit.

To move a file or directory:

  1. In the File Browser window, check the checkbox next to the file or directory you want to move.
  2. Click the Move button.
  3. In the Move dialog box, browse to or type the new directory, and then click Submit.

To delete a file or directory:

  1. In the File Browser window, check the checkbox next to the file or directory you want to delete. If you select a directory, all of the files and subdirectories contained within that directory are also deleted.
  2. Click the Delete button.
  3. Click Yes to confirm the deletion.

Changing a File's or Directory's Owner, Group, or Permissions

  Note:

Only the Hadoop superuser can change a file's or directory's owner, group, or permissions. The user who starts Hadoop is the Hadoop superuser. The Hadoop superuser account is not necessarily the same as a Hue superuser account. If you create a Hue user (in User Admin) with the same user name and password as the Hadoop superuser, then that Hue user can change a file's or directory's owner, group, or permissions.

To change a file's or directory's owner or group:

  1. In the File Browser window, check the checkbox next to the select the file or directory whose owner or group you want to change.
  2. Choose Change Owner/Group from the Options menu.
  3. In the Change Owner/Group dialog box:
    • Choose the new user from the User drop-down menu.
    • Choose the new group from the Group drop-down menu.
    • Check the Recursive checkbox to propagate the change.
  4. Click Submit to make the changes.

To change a file's or directory's permissions:

  1. In the File Browser window, check the checkbox next to the file or directory whose permissions you want to change.
  2. Click the Change Permissions button.
  3. In the Change Permissions dialog box, select the permissions you want to assign and then click Submit.

Searching for Files and Directories

You can search for files or directories by name using the query search box.

To search for files and directories by name:

  1. Enter the name of the file or directory in the query search box. File Browser lists the files or directories matching the search criteria.

Viewing and Editing Files

You can view and edit files as text or binary.

To view files:

  1. In the File Browser window, click the file you want to view. File Browser displays the first 4,096 bytes of the file in the File Viewer window.
    • If the file is larger than 4,096 bytes, use the Block navigation buttons (First Block, Previous Block, Next Block, Last Block) to scroll through the file block by block. The Viewing Bytes fields show the range of bytes you are currently viewing.
    • To switch the view from text to binary, click View as Binary to view a hexdump.
    • To switch the view from binary to text, click View as Text.

To edit files:

  1. If you are viewing a text file, click Edit File. File Browser displays the contents of the file in the File Editor window.
  2. Edit the file and then click Save or Save As to save the file.

To view the file's location in the HDFS, click View File Location. File Browser displays the file's location in the File Browser window.