Skip to main content
Code42 Support

How to use the File Search web app

Available in:

StandardPremiumEnterprise
Small Business
Applies to:

Overview

This tutorial explains how to use the Code42 File Search web app to search backed-up files that have been indexed in your Code42 environment.

Considerations

Before you can use file search, an administrator must enable indexing and grant your user account permissions to search user's files.

Search Limits
  • For a given search query, the results from a single archive are limited to 1,000 files and file versions. Regardless of this limit, all files in each archive are indexed.
  • The File Search web app can display up to 1,000 results. Export the results to CSV to see all matching files.
Viewing Search Results
  • Files and file versions are displayed interchangeably in search results.
  • When searching or filtering by a date or date range, files that were created, edited, or deleted during that period are included in results. Files that existed in the archive during that period but were not created, edited, or deleted during that period are not.
  • When a search query is configured to use filters, exported results may differ from results displayed in the File Search web app. This occurs because the File Search web app normally applies filters after the results return from the Code42 server; when the results are exported, the search query is re-sent to the Code42 server with the configured filters.
  • Search results are not sorted by Filename by default.
  • The File Search web app is available only in English.

Before you begin

Step 1: Sign in to the File Search web app

  1. In a web browser, navigate to the Code42 File Search web app's URL.
    For example: https://authority-server.example.com:4285/search
  2. Sign in with your username and password.
    file search home

Step 2: Run a search query

Use one of the following options to search the backed-up files.

Option A: Search for file contents

  1. Verify that File Contents is selected as the search type.
  2. Enter a search query.
    Make sure to use valid syntax.
  3. Specify the source to search:
    • To search a user's files, select User as the source, then type the user's first or last name. Select the user when he or she appears in the auto complete list.
    • To search a specific device, plan or archive, select the appropriate option as the source, then enter the corresponding GUID.
      You can find GUIDs by viewing file details in the File Search web app or by viewing objects in the administration console.
  4. (Optional) Add filters to further restrict results.

  5. Click Search.

Continue to Step 3 to examine the search results displayed by the File Search web app.

Option B: Search for a file name

  1. Select File Name as the search type.
  2. Enter a search query.
    • To search for the complete filename, type the name in quotes.
      Example: "My File"
    • To search for a fragment of the file name, type the fragment without quotes. The fragment that you enter must match the beginning of the filename.
    • Make sure to use valid syntax.
  3. Specify the source to search:
    • To search a user's files, select User as the source, then type the user's first or last name. Select the user when he or she appears in the auto complete list.
    • To search a specific device, plan or archive, select the appropriate option as the source, then enter the corresponding GUID.
      You can find GUIDs by viewing file details in the File Search web app or by viewing objects in the administration console.
  4. (Optional) Add filters to further restrict the results.
  5. Click Search.

Continue to Step 3 to examine the search results displayed by the File Search web app.

Option C: Search for a file hash

  1. Generate an MD5 hash of the file that you are searching for:
    • Windows: Use the File Checksum Integrity Verifier or another tool to generate the hash.
    • Mac: Run the following command from the Terminal:
      md5 /<path_to_file>/filename
    • Linux: Run the following command from a terminal:
      md5sum /<path_to_file>/filename
  2. Select File Hash as the search type.
  3. Paste the MD5 hash as the search query.
  4. Specify the source to search:
    • To search a user's files, select User as the source, then type the user's first or last name. Select the user when he or she appears in the auto complete list.
    • To search a specific device, plan or archive, select the appropriate option as the source, then enter the corresponding GUID.
      You can find GUIDs by viewing file details in the File Search web app or by viewing objects in the administration console.
  5. (Optional) Add filters to further restrict the results.
  6. Click Search.

Continue to Step 3 to examine the search results displayed by the File Search web app.

Step 3: Explore the search results

Use the File Search web app to explore and refine the search results.

View file details

Click a file in the list of results to view more information about a file, including:

  • File type
  • File extension
  • Path
  • File size
  • Last modified timestamp
  • File hash
  • Source device
  • File owner
Using this information for a new search
You might find it useful to use some of this information to run a new search. For example, you can use the device ID to search files backed up from that device—select Device GUID as the source type and enter the ID as the source.

file details

Download a file

  1. Click the file that you want to download.
  2. From the file details view:
    1. Select the action menu action menu.
    2. Click Download file.

Add filters to examine the results

You can add filters to exclude unwanted files from the results. Filters are submitted and applied with your search query.

  1. Click Add Filter.
    A list of available filters appears.
  2. Select a filter from the list.
  3. Configure the filter as needed.
  4. Click Search.

Export the results to a CSV file

After you have run a search, click Export to save the search results as a comma-separated values (CSV) file. You might want to export the results to CSV to manipulate the results in a spreadsheet application like Microsoft Excel.

Next steps

Try some advanced search queries.

  • Was this article helpful?