Skip to content

Commit 2beb293

Browse files
committed
Migration 1.1LTS to 1.4LTS
1 parent 52917d2 commit 2beb293

File tree

1 file changed

+43
-2
lines changed

1 file changed

+43
-2
lines changed

articles/iot-edge/iot-edge-for-linux-on-windows-updates.md

Lines changed: 43 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,7 @@ EFLOW updates are sequential and you'll require to update to every version in or
3131
To find the latest version of Azure IoT Edge for Linux on Windows, see [EFLOW releases](https://aka.ms/AzEFLOW-Releases).
3232

3333
<!-- iotedge-2020-11 -->
34-
:::moniker range=">=iotedge-2020-11"
34+
:::moniker range="iotedge-2020-11"
3535

3636
>[!IMPORTANT]
3737
>This is a Public Preview version of [Azure IoT Edge for Linux on Windows continuous release (EFLOW CR)](./version-history.md), not intended for production use. A clean install may be required for production use once the final General Availability (GA) release is available.
@@ -118,7 +118,48 @@ Update [1.1.2110.0311](https://github.com/Azure/iotedge-eflow/releases/tag/1.1.2
118118
119119
## Migrations between EFLOW LTS and EFLOW CR trains
120120
121-
IoT Edge for Linux on Windows doesn't support migrations between the different release trains. If you want to move from the 1.1LTS or 1.4LTS version to the Continuous Release (CR) version or viceversa, you'll have to uninstall the current version and install the new desired version. To migrate between EFLOW 1.1LTS to EFLOW 1.4LTS, check [EFLOW LTS migration](https://aka.ms/AzEFLOW-LTS-Migration).
121+
IoT Edge for Linux on Windows doesn't support migrations between the different release trains. If you want to move from the 1.1LTS or 1.4LTS version to the Continuous Release (CR) version or viceversa, you'll have to uninstall the current version and install the new desired version.
122+
123+
Migration between EFLOW 1.1LTS to EFLOW 1.4LTS is available. This migration will handle the VM migration from 1.1LTS version to 1.4LTS version, including the following:
124+
- IoT Edge runtime
125+
- Containers
126+
- Networking and VM configuration
127+
- Stored files.
128+
129+
To migrate between EFLOW 1.1LTS to EFLOW 1.4LTS, use the following steps.
130+
131+
1. Get the latest Azure EFLOW 1.1LTS [(1.1.2112.1212.1)](https://aka.ms/AzEFLOWMSI-1_1_2212_12122) update. If you're using Windows Update, *Check Updates* to get the latest EFLOW update.
132+
1. For auto-download migration (needs Internet connection), skip this step. If the EFLOW VM has limited/no internet access, download the necessary files before starting the migration.
133+
1. [1.4.2.12122 Standalone MSI](https://aka.ms/AzEFLOW-Update-1_1-to-1_4_SA)
134+
1. [1.4.2.12122 Update MIS](https://aka.ms/AzEFLOW-Update-1_1-to-1_4_Update)
135+
1. Open an elevated PowerShell session
136+
1. Start the EFLOW migration
137+
138+
>[!NOTE]
139+
>You can migrate with one single cmdlet by using the `-autoConfirm` flag. If specified Confirm-EflowMigration doesnt needs to be called to proceed with 1.4 migration.
140+
141+
1. If you're using the auto-download migration option run the following cmdlet
142+
```powershell
143+
Start-EflowMigration
144+
```
145+
1. If you download the MSI on **Step 2**, use the downloaded files to apply the migration
146+
```powershell
147+
Start-EflowMigration -standaloneMsiPath "<path-to-folder>\AzureIoTEdge_LTS_1.4.2.12122-Standalone-X64.msi"
148+
```
149+
1. Confirm the EFLOW migration
150+
1. If you're using the auto-download migration option run the following cmdlet
151+
```powershell
152+
Confirm-EflowMigration
153+
```
154+
1. If you download the MSI on **Step 2**, use the downloaded files to apply the migration
155+
```powershell
156+
Confirm-EflowMigration -updateMsiPath "<path-to-folder>\AzureIoTEdge_LTS_1.4.2.12122-Update-X64.msi"
157+
```
158+
159+
If for any reason the migration fails, the EFLOW VM will be restored to it's original 1.1 version.
160+
If you want to cancel the migration, you can use the following cmdlets `Start-EflowMigration` and then `Restore-EflowPriorToMigration`
161+
162+
For more information, check [EFLOW LTS migration](https://aka.ms/AzEFLOW-LTS-Migration).
122163
123164
124165
## Next steps

0 commit comments

Comments
 (0)