Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision 		Previous revision
rdms:best [2024/03/27 15:35]
burcu [Bundling of Data Sets] 		rdms:best [2024/03/28 15:22] (current)
burcu [Best Practices]
Line 5: Line 5:
 The section will be gradually updated with new usage examples and tips. The section will be gradually updated with new usage examples and tips.
  
-If you believe that important information should be added to this section, please feel free to contact [[rdms-support@rug.nl|RDMS support]] with your request!+If you believe that important information should be added to this section, please contact [[rdms-support@rug.nl|RDMS support]] with your request!
  
 ===== Naming Folders/Files ===== ===== Naming Folders/Files =====
Line 76: Line 76:
 ===== Locked Files (HIERARCHY_ERROR) ===== ===== Locked Files (HIERARCHY_ERROR) =====
  
-In rare cases, it can happen that data arrives in a non-finalized form in the RDMS. These usually happens if a data transfer suddenly drops out, for example due to connection problems, while the system did not finalize it properly. +In rare cases, data may arrive in an incomplete form in the RDMS. This usually happens if a data transfer abruptly interrupted, for example due to connection problems, whithout proper finalization. 
  
-Restarting the data transfer can solve this issue, but it can also happen that the already transferred data is kept in a locked state which results in problems when the transfer is restarted as those files cannot be overwritten directly. +Restarting the data transfer may solve this issue. However, it is possible that the already transferred data remains in a locked state, causing problems when the transfer is restarted as those files cannot be overwritten directly. 
  
-If you experience these issues, it is normally recommended to contact [[rdms-support@rug.nl|RDMS-Support]].+If you experience these issues, it is recommended to contact [[rdms-support@rug.nl|RDMS-Support]].
  
-Users of the command-line tool [[rdms:access:linux:icommands|iCommands]] have furthermore the possibility to detect such locked files directly via an appropriate CLI command. +Users of the command-line tool [[rdms:access:linux:icommands|iCommands]] have furthermore the possibility to detect such locked files directly using an appropriate CLI command. 
  
-In general, these issues manifest in ''HIERARCHY_ERRORs'' when a data transfer to the RDMS (e.g. via ''iput'' or ''irsync'') is tried via CLI. +In general, these issues manifest in ''HIERARCHY_ERRORs'' when a data transfer to the RDMS (e.g. via ''iput'' or ''irsync'') is attempted via CLI. 
  
 To check all files at a RDMS location ''/rug/home/path/to/folder'' including all its subfolders, and to detect just those files that are marked as locked, the following command can be executed: To check all files at a RDMS location ''/rug/home/path/to/folder'' including all its subfolders, and to detect just those files that are marked as locked, the following command can be executed:
Line 98: Line 98:
 </code> </code>
  
-==== Removal of locked Files ====+==== Removal of Locked Files ====
  
-While the locked files cannot be directly removed, they can still be moved first to another location in the your home/team location, for example a separate folder for locked files. Afterwards, the data transfer can be restarted. +While the locked files cannot be directly removed, they can still be moved first to another location in your home/team location, for example as a separate folder for locked files. Afterwards, the data transfer can be restarted. 
  
-So the best practice for handling locked files and resolving the ''HIERARCH_ERROR'' is:+Best practices to handle locked files and resolve the ''HIERARCH_ERROR'' are:
  
-  - Create a new folder in your home or team drive that will contain all locked files. +  - Create a new folder in your home or team drive to contain all locked files. 
-  - Move the locked files that were found via ''iquest'' to that location. CLI users can use ''imv'' for that. +  - Use the 'iquest' command to identify locked files and move them to the newly created location. CLI users can utilize 'imv' for this purpose. 
-  - Now, restart the data transfer. The ''HIERARCHY_ERROR'' should be gone.+  - Restart the data transfer. The ''HIERARCHY_ERROR'' should be resolved.
   - If you accumulated multiple locked files in your folder which you cannot delete, please contact [[rdms-support@rug.nl|RDMS-Support]] and we will help you remove these.    - If you accumulated multiple locked files in your folder which you cannot delete, please contact [[rdms-support@rug.nl|RDMS-Support]] and we will help you remove these. 
  
-**Note:** It is recommended not to message RDMS support for every locked file, but instead first try to resolve it like described above. In cases where a lot of locked files are detected, RDMS support can be also contacted directly. +**Note:** It is recommended not to contact RDMS support for every locked file, but instead first try to resolve it as described above. However, if numerous locked files are detected, you can directly contact RDMS support.