Support Questions

Find answers, ask questions, and share your expertise

What does fsck -delete do ?

New Contributor

Hi all,


We currently have corrupted files (missing blocks) on our cluster. The active namenode is finding 2 out of 3 replicas on most of those files.


It seems the hdfs service is not replicating on its own, so we went through existing commands to attempt to fix things manually, and we found the hdfs "fsck" command here:


From the documentation alone, I don't understand what the "-delete" option does. Does it delete all blocks of the file ? Does it delete the missing blocks (their metadata) ? I'm a bit confused.


Does anyone have experience with this command and could help me clarify what it does?




Cloudera Employee



fsck -delete, deletes the corrupted files, and the blocks related to that file.



Before you decide whether the cluster has corrupt files can you check the replication factor? If it's set to 2 then that normal 

The help option will give you a full list of sub commands

$ hdfs fsck / ?                                                                                                                                                              fsck: can only operate on one path at a time '?' 

The list of sub command options

                                                                                                                                                           $ fsck <path> [-list-corruptfileblocks | [-move | -delete | -openforwrite] [-files [-blocks [-locations | -racks | -replicaDetails | -upgradedomains]]]] [-includeSnapshots] [-showprogress] [-storagepolicies] 
[-maintenance] [-blockId <blk_Id>]                                                                                                                                                                          
start checking from this path                                                                                                                                                                      
-move   move corrupted files to /lost+found                                                                                                                                                                
-delete delete corrupted files                                                                                                                                                                             
-files  print out files being checked                                                                                                                                                                      
-openforwrite   print out files opened for write                                                                                                                                                           
-includeSnapshots include snapshot data of a snapshottable directory                     
-list-corruptfileblocks print out list of missing blocks and files they belong to                                                                                                                          
-files -blocks  print out block report                                                                                                                                                                     
-files -blocks -locations       print out locations for every block                                                                                                                                        
-files -blocks -racks   print out network topology for data-node locations                                                                                                                                 
-files -blocks -replicaDetails  print out each replica details                                                                                                                                             
-files -blocks -upgradedomains  print out upgrade domains for every block                                                                                                                                  
-storagepolicies print out storage policy summary for the blocks                                                                                                                                    
-maintenance    print out maintenance state node details                                                                                                                                                   
-showprogress   show progress in output. Default is OFF (no progress)                                                                                                                                      
-blockId        print out which file this blockId belongs to, locations (nodes, racks)    


It would be good to first check for corrupt files and then run the delete 


$ hdfs fsck / -list-corruptfileblocks                                                                                                                                                          
Connecting to namenode via 
The filesystem under path '/' has 0 CORRUPT files  

A simple demo here my replication factor is 1  see above screenshot when I create a new file in hdfs the default repélication factor is set to 1

$ hdfs dfs -touch /user/tester.txt

Now to check the replication fact  see the number 1 before the group:user hdfs:hdfs

$ hdfs dfs -ls /user/tester.txt 
-rw-r--r-- 1 hdfs hdfs 0 2020-10-18 10:21 /user/tester.txt


Hope that helps 






Take a Tour of the Community
Don't have an account?
Your experience may be limited. Sign in to explore more.