11On-Prem Upgrade Guide
22=========================
33
4- **Upgrade Path: ** EMF On-Prem v3.1.3 → v2025.2 .0
4+ **Upgrade Path: ** EMF On-Prem v2025.2.0 → v2026.0 .0
55
66**Document Version: ** 1.0
77
88Overview
99--------
1010
1111This document provides step-by-step instructions to upgrade
12- On-Prem Edge Manageability Framework (EMF) from version v3.1.3 to v2025.2.0.
12+ On-Prem Edge Manageability Framework (EMF) from version v2025.2.0 to v2026.0.0
1313
1414Prerequisites
1515-------------
1616
1717System Requirements
1818~~~~~~~~~~~~~~~~~~~
1919
20- - Current EMF On-Prem installation version 3.1.3 or later
20+ - Current EMF On-Prem installation version v2025.2.0 or later
2121- Root/sudo privileges on orchestrator node
2222- PostgreSQL service running and accessible
2323- Sufficient disk space for backups (~200GB minimum)
@@ -53,7 +53,7 @@ Step 1: Download the Latest On-Prem Upgrade Script
5353 REGISTRY_URL='registry-rs.edgeorchestration.intel.com'
5454 RS_PATH='edge-orch/common/files/on-prem'
5555 ORAS_VERSION='1.1.0'
56- ORCH_VERSION='v2025.2 .0'
56+ ORCH_VERSION='v2026.0 .0'
5757
5858 # Install oras if not already installed
5959 if ! command -v oras &> /dev/null; then
@@ -135,7 +135,10 @@ Core Deployment Configuration
135135 - ``registry-rs.edgeorchestration.intel.com``
136136 * - ``DEPLOY_VERSION``
137137 - Version of Edge Orchestrator to deploy
138- - ``v2025.2.0``
138+ - ``v2026.0.0``
139+ * - ``DEPLOY_REPO_BRANCH``
140+ - Git tag or branch for edge-manageability-framework deployment repository
141+ - ``v2026.0.0``
139142 * - ``ORCH_INSTALLER_PROFILE``
140143 - Deployment profile for Edge Orchestrator
141144 - ``onprem``
@@ -176,10 +179,14 @@ Network Configuration
176179 * - ``TRAEFIK_IP``
177180 - MetalLB IP address for Traefik
178181 - (empty)
179- * - ``NGINX_IP ``
180- - MetalLB IP address for NGINX
182+ * - ``HAPROXY_IP ``
183+ - MetalLB IP address for HAProxy
181184 - (empty)
182185
186+ .. note::
187+ In **v2026.0.0 (latest release)**, the ingress controller was **replaced from NGINX to HAProxy**.
188+ Please check whether the DNS entry for HAProxy is present after installation .
189+
183190Container Registry Configuration
184191~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
185192
@@ -335,6 +342,7 @@ Update the following sections:
335342- **CORE DEPLOYMENT CONFIGURATION:**
336343 - RELEASE_SERVICE_URL
337344 - DEPLOY_VERSION
345+ - DEPLOY_REPO_BRANCH
338346 - ORCH_INSTALLER_PROFILE
339347
340348- **AUTHENTICATION & SECURITY:**
@@ -343,7 +351,7 @@ Update the following sections:
343351
344352- **NETWORK CONFIGURATION:**
345353 - CLUSTER_DOMAIN
346- - ARGO_IP, TRAEFIK_IP, NGINX_IP
354+ - ARGO_IP, TRAEFIK_IP, HAPROXY_IP
347355
348356- **CONTAINER REGISTRY:**
349357 - GITEA_IMAGE_REGISTRY
@@ -367,8 +375,10 @@ Update the following sections:
367375 kubectl get svc traefik -n orch-gateway
368376 kubectl get svc ingress-nginx-controller -n orch-boots
369377
370- # Set deployment version (replace with your actual upgrade version tag)
371- export DEPLOY_VERSION=v2025.2.0
378+ # Set deployment version (replace with your actual upgrade version tag)
379+ export DEPLOY_VERSION=v2026.0.0
380+ #Set the deploy repo release tag/branch (Gitea commit/tag/branch from EMF repo)
381+ export DEPLOY_REPO_BRANCH=v2026.0.0
372382
373383 # Set non-interactive mode to true to skip prompts
374384 export PROCEED=true
@@ -427,7 +437,7 @@ Before confirming in Terminal 1, open **Terminal 2** and update configurations:
427437 # Check current LoadBalancer IPs
428438 kubectl get svc argocd-server -n argocd
429439 kubectl get svc traefik -n orch-gateway
430- kubectl get svc ingress-nginx-controller -n orch-boots
440+ kubectl get svc ingress-haproxy-kubernetes-ingress -n orch-boots
431441
432442 # Verify LB IP configurations are updated
433443 nano repo_archives/tmp/edge-manageability-framework/orch-configs/clusters/onprem.yaml
@@ -451,7 +461,7 @@ Step 7: Monitor Upgrade Progress
451461
452462The upgrade process includes:
453463
454- - Upgrade RKE2 to 1.34.1 versions
464+ - Upgrade RKE2 to 1.34.4 versions
455465- OS Configuration upgrade
456466- Gitea upgrade
457467- ArgoCD upgrade
@@ -575,8 +585,8 @@ Verify that the ``signed_ipxe.efi`` image is downloaded using the freshly downlo
575585 # Delete both files before downloading
576586 rm -rf Full_server.crt signed_ipxe.efi
577587 export CLUSTER_DOMAIN=cluster.onprem
578- wget https://tinkerbell-nginx .$CLUSTER_DOMAIN/tink-stack/keys/Full_server.crt --no-check-certificate --no-proxy -q -O Full_server.crt
579- wget --ca-certificate=Full_server.crt https://tinkerbell-nginx .$CLUSTER_DOMAIN/tink-stack/signed_ipxe.efi -q -O signed_ipxe.efi
588+ wget https://tinkerbell-haproxy .$CLUSTER_DOMAIN/tink-stack/keys/Full_server.crt --no-check-certificate --no-proxy -q -O Full_server.crt
589+ wget --ca-certificate=Full_server.crt https://tinkerbell-haproxy .$CLUSTER_DOMAIN/tink-stack/signed_ipxe.efi -q -O signed_ipxe.efi
580590
581591 Once the above steps are successful, the orchestrator (Orch) is ready for onboarding new Edge Nodes (EN).
582592
0 commit comments