Migrating to v3.8.0
Greenfield release: v3.8.0
There is no in-place upgrade from v3.7 or v1.6.x field deployments. You need a new Controller database, Edgelet v1.0.0+ on every node, and potctl v3.8.0.
Before you start
- Export application YAML you need to keep.
- Inventory Edgelet nodes and plan downtime.
- Read the field rename cheat sheet below.
Migration steps
- Export application YAML from the v3.7 Controller.
- Uninstall legacy operator and v3.7 CRDs, including the Application CRD.
- Deploy v3.8 Control Plane with embedded OIDC (see Platform Deployment).
- Provision Edgelet v1.0.0+ on every node. Do not reuse Java iofog-agent or v3.7 field agents.
- Re-import or redeploy applications on the new Controller.
Legacy documentation
Agent Management, ECN Viewer, and Keycloak-first deployment guides live in the v3.7.3 snapshot. For the deprecated Java Agent runtime, see Legacy Agent (v3.7).
Field rename cheat sheet
| v3.7 field | v3.8 field |
|---|---|
dockerUrl | containerEngineUrl |
dockerPruningFrequency | pruningFrequency |
fogType / fogTypeId | arch / archId |
viewerUrl | consoleUrl |
VIEWER_* env vars | CONSOLE_* |
SSL_* env vars | TLS_* |