Skip to content

Installation & Enrollment

SchemaDock installation has two distinct lifecycle paths:

  • New Installation for a Dock that has not enrolled yet
  • Update / Reinstall for a Dock that already has a persistent identity

New installation flow

Register Dock in SchemAlign Administration
    -> choose Windows or Linux
    -> download the new-install bundle
    -> install SchemaDock
    -> bootstrap is consumed once
    -> persistent identity is created
    -> SchemaDock connects to the gateway
    -> Dock becomes Online

A new-install bundle contains the platform installer/package plus Dock-specific enrollment material.

The bootstrap has a shape similar to:

{
  "format_version": 1,
  "gateway_url": "https://<customer-instance>.schemalign.com/schemadock",
  "schema_dock_id": "<dock-registration-id>",
  "enrollment_token": "<one-time-token>"
}

Treat bootstrap.json as sensitive temporary enrollment material. It contains a one-time enrollment token and should not be published or stored in a shared software repository.

After enrollment

After successful enrollment:

  • the one-time bootstrap is no longer needed for normal operation
  • the agent uses its persistent local identity
  • upgrades preserve the identity
  • the existing Dock registration remains the same

Do not download or create another bootstrap merely to update an enrolled agent.

Choose a platform

Update or replacement

For an existing installation, see Upgrade, Reinstall & Replacement.