.. _auto_hpc_server_create:

*HPC SERVER CREATE*
===================

Creates a new HPC server record (admin-only). Clone a known-good baseline server (recommended) and/or supply flat fields; the model auto-sorts DB columns vs the options blob and runs the standard after-create setup (admin dir + LUCY config). Warns about practically-required fields that are missing.

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

Tagged: ``hpc``, ``hpc_server``, ``server``, ``create``, ``clone``, ``job_submission``, ``admin``.

Inputs
------

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

   * - Label
     - ID
     - Type
     - Default
     - Required
     - Description
   * - Server Name
     - name
     - text
     - —
     - ✓
     - Unique name for the new HPC server. Rejected if a server with this name already exists.
   * - Baseline Server (clone source)
     - baseline_server
     - text
     - —
     - 
     - Optional id or name of a known-good server to clone (deep-copies its options as the starting point). Strongly recommended given the large options surface.
   * - Description
     - description
     - text
     - —
     - 
     - Optional description.
   * - Server Type
     - type
     - text
     - —
     - 
     - Server type (e.g. batch, local, cloud). Defaults to batch when building from scratch.
   * - Connection Type
     - connection_type
     - text
     - —
     - 
     - Connection type (e.g. ssh, local, http).
   * - Submission Type
     - submission_type
     - text
     - —
     - 
     - Submission type (e.g. lucy, native). Defaults to lucy when building from scratch.
   * - Scheduler Type
     - scheduler_type
     - text
     - —
     - 
     - Scheduler type (e.g. pbs, slurm).
   * - Hostname
     - hostname
     - text
     - —
     - 
     - Server hostname.
   * - IP Address
     - ipaddress
     - text
     - —
     - 
     - Server IP address.
   * - Default Username
     - default_username
     - text
     - —
     - 
     - Default username for connections/submission identity.
   * - Override Key/Values
     - keyvalue_overrides
     - keyvalue
     - —
     - 
     - Optional flat key-value object for the long tail of fields (any DB column or options key). Protected/auto-managed fields are stripped.

Outputs
-------

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

   * - Label
     - ID
     - Type
     - Description
   * - Created HPC Server
     - created_server
     - object
     - The created HPC server record.
   * - Status Message
     - status_message
     - text
     - Summary of the created server plus any usability warnings (missing solvers/queue/submit_command/host/scheduler).

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_create</code>. Schema hash: <code>cb87063cda4b</code>. Hand-curated docs in <code>workerexamples/</code> override this page when present.
   </p>