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.