Administration Guides

Search & Recover & Golden Copy Archiving Solution


Solution Overview - How to use an Archive Staging Area With Search & Recover and Golden Copy

This work flow requires both products to use this work flow to provide an archive solution with S3 or Azure blob storage.    This work flow would require users to request access to data that has been archived and a recall job created to return data to the cluster.  This solution is a bulk archive solution aimed at doing large clean up every few months.  

Deprecation Notice

  1. As of 1.1.4 the search & recover csv format will be deprecated with a 1.1.4 build to support a format of CSV import that uses only an absolute path of /ifs/... to a file to be copied. This will allow customer scripts or command builder feature in Search & Recover to generate a simple csv or flat file with only path to files to be copied by Golden copy.
  2. Required 1.1.4 build > 21124

How to locate aging data for Archive With Search and Recover 

  1. Typically files age based on modified or last access are common criteria to locate data
  2. Login to search
  3. Open Quick reports and What's Growing old?
  5. Move the results to Archive Staging Area.
    1. Create /ifs/archivestaging
    2. Use this Guide to move data from the search result list to archive staging area.  Use the target path above to replace the examples used here
  6. Repeat the above steps when you want to clean up data and move to an S3 bucket.  The example script copy above has the option to move data to the staging area.  This solution will also retain the original path of the file under the staging folder base path.  example /ifs/archivestaging/ifs/data/moveddata 

How to move the files to the Archive Staging Area

  1. On the Golden Copy VM at the /ifs/archivestaging  to an archived folder definition.  See quick start examples here
  2. Configure the folder for copy mode
  3. Run the copy job
  4. Verify all data was successfully copied by viewing the job report or the running job.
    1. searchctl job view --id  <job name > --follow
    2. searchctl archivedfolders export --id <job name >
  5. Delete the data under  /ifs/archivestaging 

How Recall data for Users

  1. If a user request to recall data comes is received you can view the S3 bucket with Any S3 browser tool to locate the path of the files.
  2. Start a recall job on Golden Copy vm to recall the data back into the staging area.  Example
    1. searchctl archivedfolders recall --id <folder id> --subdir /ifs/archivestaging/ifs/path-to-user-data 
  3. Once the recall job finishes you can create an SMB share on top of the recalled data to provide access to the recalled data.
  4. Summary:
    1. This keeps the data in the original location that the user last had access to it
    2. The staging area moves data into an area that is easily copied and managed seperate from the file system.
    3. Users must request data back and this allows monitoring of data access requests.

Solution Overview - How to archive data in place with Search & Recover and Golden Copy

This solution keeps the data in place , meaning it does not use a staging area to copy or move data to the archive.    Data can be recalled back using Golden Copy recall feature. NOTE: Recall will not place the data into the same location it was archived from.  The data will be recalled to the staging area but the relative file path will be preserved.  


  1. Search & Recover
  2. Golden Copy
  3. S3 Target Storage

How to locate aging data for Archive With Search and Recover

  1. Typically files age based on modified or last access are common criteria to locate data
  2. Login to search
  3. Open Quick reports and What's Growing old?
  5. The resulting table will show the month and year with data that meets the age search criteria.  NOTE: You may enter a path to narrow the search to a specific path in the file system as well as using other search criteria in the Advanced window of the What's Growing Old? Quick Report.
  6. Select the months or rows in the table and select the menu option "Show me the files"

Copy Search results file to Golden Copy for Archive

  1. From the files results list you will need to save the files to a CSV file that can be used with Golden Copy to archive the files in the search list.  NOTE:  You may edit the CSV to delete files that should not be archived.  
  2. Due to depreciation notice the CSV file must be edited and delete all columns except the file path /ifs/.... this new simpler format will be the only format supported.  Command builder feature allows export a search result to a file with path to file one per row file with a carriage return after each row in the file.
  4. Using winscp to copy the saved csv file from Search to Golden Copy node 1 and save the file in /opt/superna/var/csvimport
  5. Authenticate as the ecaadmin user.
  6. Run an archive job and specify the csv file
    1. searchctl archivedfolders archive --id 3fc3795a731daef8 --uploads-file /opt/superna/var/csvimport/igls_search_1606924303.csv
  7. Monitor the copy job progress as normal
  8. Done

Delete the Data Using Search & Recover

  1. OPTIONAL - If the objective is to delete the aged files from the file system follow this steps.
    1. Login as an admin user to get the command builder UI option in the UI when running the steps above.
    2. Use the script builder icon and enter rm ssh command into the box one and then log the delete to a file in the second box  as per screenshot.   This will create a bash script with each file in the file to delete the files in the results.
    4. Copy this bash script to the Isilon, any location is ok.
      1. Make the file executable chmod 777
      2. Make sure you are logged in as a user with permissions to delete files regardless of the ACL's example root.
      3. Execute the script command store the log somewhere as a record of the deletion.
    5. NOTE:  The data copied will have the same path in the object store as existed on the cluster file system.

Recalling Archived Data

The data that was archived will not be required in most cases.  If the recall of the data is required.  The Golden copy recall feature can recall the archived data based on path only to the recall staging area.  The data can be shared from this location or copied back into the original file location.  The recall staging area retains the absolute file path when it is recalled.

See the recall instructions here.

© Superna Inc