Workspaces/Advanced Features/ws release: Difference between revisions

From bwHPC Wiki
Jump to navigation Jump to search
(Created page with "= ws_release - Release (Delete) Workspace = Release a workspace when you no longer need it. == Syntax == <tt>ws_release [options] workspace_name</tt> == What Happens When You Release == * The workspace ID can be reused immediately * The directory becomes inaccessible to the user * The data is '''not deleted immediately''' - it is moved to a deleted area * '''Released workspaces:''' Can be recovered using <tt>ws_restore</tt> until the next cleanup cycle (typically ru...")
 
mNo edit summary
 
Line 13: Line 13:
* The data is '''not deleted immediately''' - it is moved to a deleted area
* The data is '''not deleted immediately''' - it is moved to a deleted area
* '''Released workspaces:''' Can be recovered using <tt>ws_restore</tt> until the next cleanup cycle (typically runs during nighttime)
* '''Released workspaces:''' Can be recovered using <tt>ws_restore</tt> until the next cleanup cycle (typically runs during nighttime)
* '''Expired workspaces:''' Can be recovered for a longer period (see [[Workspaces/Advanced_Features/ws_restore#Cluster-Specific_Information|grace periods and cluster-specific deletion times]])
* Final deletion happens automatically during cleanup runs
* '''Important:''' Released workspace data may still count toward your quota until final deletion occurs
* '''Important:''' Released workspace data may still count toward your quota until final deletion occurs


Line 31: Line 29:
|-
|-
|<tt>--delete-data</tt>
|<tt>--delete-data</tt>
|Delete all data immediately. '''WARNING: Workspace can NOT BE RECOVERED'''
|Delete all data immediately (may not be available on all clusters).
'''WARNING: Workspace can NOT BE RECOVERED'''
|}
|}

== Immediate Deletion (Free Quota Instantly) ==

{| class="wikitable"
|-
!style="width:40%" | Works on cluster
!style="width:10%" | bwUC 3.0
!style="width:10%" | BinAC2
!style="width:10%" | Helix
!style="width:10%" | JUSTUS 2
!style="width:10%" | NEMO2
|-
|<tt>ws_release --delete-data</tt> (immediate deletion)
|style="background-color:#90EE90; text-align:center;" | ✓
| style="text-align:center;" |
| style="text-align:center;" |
| style="text-align:center;" |
|style="background-color:#90EE90; text-align:center;" | ✓
|}

If you need to free quota immediately instead of waiting for the grace period, you have two options:

'''Use --delete-data flag''' (recommended if available on your cluster):

$ ws_release --delete-data myWs

'''Availability:''' Check if this flag is available on your cluster with <tt>ws_release -h</tt>.

=== When to use immediate deletion ===

* ✓ You're certain you don't need the data anymore
* ✓ You've already backed up important results to permanent storage
* ✓ You're hitting quota limits and need space immediately
* ✗ Don't use if there's any chance you might need the data
* ✗ Don't use if you haven't verified your backup worked

'''Best practice:''' Use regular <tt>ws_release myWs</tt> (without immediate deletion) as your default. Only use immediate deletion when you're absolutely certain and need immediate quota relief.


For more information: <tt>$ ws_release -h</tt> or <tt>man ws_release</tt>
For more information: <tt>$ ws_release -h</tt> or <tt>man ws_release</tt>

Latest revision as of 16:47, 2 December 2025

ws_release - Release (Delete) Workspace

Release a workspace when you no longer need it.

Syntax

ws_release [options] workspace_name

What Happens When You Release

  • The workspace ID can be reused immediately
  • The directory becomes inaccessible to the user
  • The data is not deleted immediately - it is moved to a deleted area
  • Released workspaces: Can be recovered using ws_restore until the next cleanup cycle (typically runs during nighttime)
  • Important: Released workspace data may still count toward your quota until final deletion occurs

Options

Option Description
-n <name> Workspace name (alternative to positional argument)
-F <filesystem> Specify filesystem where the workspace is located
--delete-data Delete all data immediately (may not be available on all clusters).

WARNING: Workspace can NOT BE RECOVERED

For more information: $ ws_release -h or man ws_release