.. _auto_hpc_server_delete:

*HPC SERVER DELETE*
===================

Safely deletes or disables an HPC server (admin-only). Default: refuse if the server is referenced by existing jobs/simulations/configs (no DB cascade exists). Offers soft-disable (hide via options) and hard delete only with force=true. Undetermined reference scans block rather than risk a silent delete.

When to use
-----------

Tagged: ``hpc``, ``hpc_server``, ``server``, ``delete``, ``disable``, ``job_submission``, ``admin``.

Inputs
------

.. list-table::
   :header-rows: 1
   :widths: 20 20 20 20 20 20

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - HPC Server Id
     - hpcserver_id
     - text
     - —
     - ✓
     - Numeric id of the HPC server to delete or disable.
   * - Force Hard Delete
     - force
     - bool
     - False
     - 
     - If true, hard-delete even when references exist (orphans those rows — no FK cascade). Use with care.
   * - Soft Disable
     - soft_disable
     - bool
     - False
     - 
     - If true, hide/disable the server (via options visibility/admin_only) instead of deleting. The recommended safe alternative.

Outputs
-------

.. list-table::
   :header-rows: 1
   :widths: 20 20 20 20

   * - Label
     - ID
     - Type
     - Description
   * - Result
     - result
     - text
     - One of: disabled, deleted, refused.
   * - References
     - references
     - object
     - Per-table reference counts (hpcjobs, solverresultsets, preferences_active_user); -1 means the scan could not be determined (treated as blocking).
   * - Status Message
     - status_message
     - text
     - Human-readable outcome and reference summary.

Disciplines
-----------

- platform.hpc_server

.. raw:: html

   <hr style="margin-top:2em">
   <p style="font-size:11px;color:#888">
   Auto-generated from <code>platform</code> schema. Worker id: <code>hpc_server_delete</code>. Schema hash: <code>919a3671b57c</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>