---
title: Migration 22.x to 25.x
slug: ps/help/en_us/ics/25x/mig/migration-22x-to-25x
createdAt: 2026-08-02T14:26:48.080Z
---

On the existing 22.x ICS. Log in to the standalone device or the primary node of the cluster (where the cluster was first formed) and export its binary configs (system.cfg and user.cfg), and the XML Network settings configurations.

:::hint{type="info"}
Refer to [Prerequisites for Migration](https://docs.ivanti.com/ps/help/en_us/ics/25x/mig/prerequisites-for-migration#configuration_392048201_1015645) and Supported [Configuration Migration Path](https://docs.ivanti.com/ps/help/en_us/ics/25x/mig/prerequisites-for-migration#Configur) before starting the migration.
:::

:::hint{type="info"}
Migration procedure explained in this document applies to both ISA and ISA-V Appliance.
:::

## Exporting Configurations

:::hint{type="info"}
Ivanti recommends that you export the System and User binary config and the entire XML configuration. This provides you with the greatest possibilities for restoring or migrating the configuration. However, using the binary exports in the first instance is recommended when importing.
:::

To export the binary configurations from the 22.x:

1. From the 22.x Admin UI, select **Maintenance > Import/Export > Configuration**.
2. Under Export, enter a password if you’d like to password-protect the configuration file.
3. Click **Save Config As** to save the file. The default filename is *system.cfg*.

::Image[]{src="https://api.archbee.com/api/optimize/wxZG1KsS4xNkVZYoiu_o9/1IyInvZAgLxdSGjYaKG75_exp1.png" position="flex-start" size="80" width="818" height="358" initialPath="../image/exp1.png" githubPath="HTML5/image/exp1.png" darkWidth="818" darkHeight="358" showCaption="false" indent="1"}

4. Select **Maintenance > Import/Export > User Accounts**.
5. Under **Export**, enter a password if you would like to password-protect the configuration file.

- If you choose to password-protect the file, ensure that the password is stored in a long-term sustainable location. There is no way to recover the password or decrypt the file if the password is lost.

6. Click **Save Config As** to save the file. The default filename is *users.cfg*.

::Image[]{src="https://api.archbee.com/api/optimize/wxZG1KsS4xNkVZYoiu_o9/6wQyHlU-GFwVhMS59mS2v_exp2.png" position="flex-start" size="80" width="827" height="338" initialPath="../image/exp2.png" githubPath="HTML5/image/exp2.png" darkWidth="827" darkHeight="338" showCaption="false" indent="1"}

To export the XML Network configuration:

1. Select **Maintenance > Import/Export > XML Import/Export**.
2. Under **Export**, expand **System Settings** and select **Select All System Settings**.
3. Click **Export** and save the XML file.

:::Paragraph{indent="1"}
:inlineImage[]{src="https://api.archbee.com/api/optimize/wxZG1KsS4xNkVZYoiu_o9/AKYZlHWITHaxFQaAyv7Hh_exp3.png" alt caption size="39" width="391" height="465"} :inlineImage[]{src="https://api.archbee.com/api/optimize/wxZG1KsS4xNkVZYoiu_o9/DNe4SD7MMuVILy6jZbCui_exp4.png" alt caption size="28" width="276" height="296"}
:::

:::Paragraph{indent="2"}
Make notes of all the local settings for both nodes (if not yet done during preparation stage): IP information, clustering, virtual ports, VLANs, hosts, routes, DNS settings, SNMP (if configured) and Syslog settings.
:::

### Configuring Devices

1. Configure the new devices with the network settings identified in the [Prerequisites](https://docs.ivanti.com/ps/help/en_us/ics/25x/mig/prerequisites-for-migration#configuration_392048201_1015645) section.

:::Paragraph{indent="1"}
The settings to configure are:
:::

:::Paragraph{listStyleType="disc" indent="2"}
Internal Virtual Ports
:::

:::Paragraph{listStyleType="disc" indent="2"}
External Virtual Ports
:::

:::Paragraph{listStyleType="disc" indent="2"}
Management Ports
:::

:::Paragraph{listStyleType="disc" indent="2"}
VLANs
:::

:::Paragraph{listStyleType="disc" indent="2"}
Static Routes
:::

:::Paragraph{listStyleType="disc" indent="2"}
Port settings
:::

2. Apply the entitled/purchased licenses to the individual GW or Cluster or connect to the license server through Gateway licensing Mode.

:::hint{type="info"}
If you are migrating a non-clustered device, skip next 4 steps and proceed.
:::

3. In the new ISA device (first device), manually create a new cluster and ensure that this does not conflict in settings or naming with your existing production cluster.

::Image[]{src="https://api.archbee.com/api/optimize/wxZG1KsS4xNkVZYoiu_o9/WupcRnCYGKfxDa2uPhKyz_clust1.png" position="flex-start" size="80" width="823" height="379" initialPath="../image/clust1.png" githubPath="HTML5/image/clust1.png" darkWidth="823" darkHeight="379" showCaption="false" indent="1"}

::Image[]{src="https://api.archbee.com/api/optimize/wxZG1KsS4xNkVZYoiu_o9/PCDLAAzyRFxA37ddT7xjX_clust2.png" position="flex-start" size="77" width="768" height="225" initialPath="../image/clust2.png" githubPath="HTML5/image/clust2.png" darkWidth="768" darkHeight="225" showCaption="false" indent="1"}

4. Add the second device to the cluster in the primary node cluster configuration and save the settings.

:::Paragraph{indent="1"}
a. Click **Add Members** to add a member.
:::

::Image[]{src="https://api.archbee.com/api/optimize/wxZG1KsS4xNkVZYoiu_o9/FV-F8F797LBX5ZdL5ZEqM_clust3.png" position="flex-start" size="80" width="1386" height="468" initialPath="../image/clust3.png" githubPath="HTML5/image/clust3.png" darkWidth="1386" darkHeight="468" showCaption="false" indent="1"}

:::Paragraph{indent="1"}
b. Enter member node name and IP and check netmask and gateway, then click **Add**.
:::

:::Paragraph{indent="1"}
c. Click **Save Changes**.
:::

::Image[]{src="https://api.archbee.com/api/optimize/wxZG1KsS4xNkVZYoiu_o9/fPhbzA1zMH33AnltT4PKn_clust4.png" position="flex-start" size="80" width="1394" height="345" initialPath="../image/clust4.png" githubPath="HTML5/image/clust4.png" darkWidth="1394" darkHeight="345" showCaption="false" indent="1"}

:::Paragraph{indent="1"}
d. Check cluster **status.**
:::

:::Paragraph{indent="1"}
The status turns **transitioning** for short period, then the first node becomes enabled, and the status turns as **Leader**. The second node remains **Enabled**, **Unreachable** until it joins the cluster.
:::

::Image[]{src="https://api.archbee.com/api/optimize/wxZG1KsS4xNkVZYoiu_o9/tRGwnU7EkEH8QZfozZ4F1_clust5.png" position="flex-start" size="80" width="1398" height="559" initialPath="../image/clust5.png" githubPath="HTML5/image/clust5.png" darkWidth="1398" darkHeight="559" showCaption="false" indent="1"}

:::hint{type="info"}
For full clustering guidance, please refer to the [Clustering Configuration Guide](https://help.ivanti.com/ps/help/en_US/ICS/22.x/clcg/landingpage.htm) which handles this topic in-depth.
:::

5. If the XML config is exported from an **Active/Passive** Cluster, following needs to be done prior to XML Import:

:::Paragraph{indent="1"}
a. Configure External Port for the Cluster Members (if external ports are configured in cluster).
:::

:::Paragraph{indent="1"}
b. Go to **Clustering > Cluster Properties** page. Change the Cluster Type from **Active/Active** to **Active/Passive** and add the cluster VIP address/es (the example here does not use external port
:::

::Image[]{src="https://api.archbee.com/api/optimize/wxZG1KsS4xNkVZYoiu_o9/6GduhQU5DPE3jY2ElSb3u_clust6.png" position="flex-start" size="80" width="1000" height="735" initialPath="../image/clust6.png" githubPath="HTML5/image/clust6.png" darkWidth="1000" darkHeight="735" showCaption="false" indent="1"}

:::Paragraph{indent="1"}
c. Save the cluster configuration settings.
:::

::Image[]{src="https://api.archbee.com/api/optimize/wxZG1KsS4xNkVZYoiu_o9/ToS67sTKyG6nnMV6SpXWW_clust7.png" position="flex-start" size="49" width="489" height="215" initialPath="../image/clust7.png" githubPath="HTML5/image/clust7.png" darkWidth="489" darkHeight="215" showCaption="false" indent="1"}

:::Paragraph{indent="1"}
d. Change confirmation will appear confirming change from **Active/Active** to **Active/Passive**.
:::

::Image[]{src="https://api.archbee.com/api/optimize/wxZG1KsS4xNkVZYoiu_o9/RPOWV8bP1owwbPWv0TzPy_clust8.png" position="flex-start" size="62" width="621" height="704" initialPath="../image/clust8.png" githubPath="HTML5/image/clust8.png" darkWidth="621" darkHeight="704" showCaption="false" indent="1"}

:::Paragraph{indent="1"}
e. Log in to the second device and join this node to the cluster by **Clustering > Join Cluster**.
:::

::Image[]{src="https://api.archbee.com/api/optimize/wxZG1KsS4xNkVZYoiu_o9/7-A0NN9cZ5VsSA1OJ9ASs_clust9.png" position="flex-start" size="80" width="1000" height="499" initialPath="../image/clust9.png" githubPath="HTML5/image/clust9.png" darkWidth="1000" darkHeight="499" showCaption="false" indent="1"}

:::Paragraph{indent="1"}
f. Click **Join**.
:::

::Image[]{src="https://api.archbee.com/api/optimize/wxZG1KsS4xNkVZYoiu_o9/4TeOHVi54sw9d31vXAJUv_clust10.png" position="flex-start" size="80" width="1042" height="223" initialPath="../image/clust10.png" githubPath="HTML5/image/clust10.png" darkWidth="1042" darkHeight="223" showCaption="false" indent="1"}

6. Log in to primary node and check cluster status and it should stabilize in a few minutes.

::Image[]{src="https://api.archbee.com/api/optimize/wxZG1KsS4xNkVZYoiu_o9/6Hy5hCqng4r4qj0BSFFDF_clust11.png" position="flex-start" size="80" width="1019" height="405" initialPath="../image/clust11.png" githubPath="HTML5/image/clust11.png" showCaption="false" indent="1"}

## Importing existing ISA configurations

To import the ISA configurations:

1. From the ISA Appliance Admin UI, select **Maintenance > Import/Export > Configuration**.
2. Select **Import Everything except network settings, cluster settings, and licenses** to import all configurations except network, cluster and license settings.
3. Browse to the configuration file, system.cfg. Enter the password if specified.
4. Click **Import Config**.

::Image[]{src="https://api.archbee.com/api/optimize/wxZG1KsS4xNkVZYoiu_o9/u-0OgMj6M_rFH9nZgA44a_imp1.png" position="flex-start" size="80" width="885" height="812" initialPath="../image/imp1.png" githubPath="HTML5/image/imp1.png" darkWidth="885" darkHeight="812" showCaption="false" indent="1"}

5. Select **Maintenance > Import/Export > User Accounts** and browse to the users.cfg file.
6. Click **Import Config**.

::Image[]{src="https://api.archbee.com/api/optimize/wxZG1KsS4xNkVZYoiu_o9/7sHenefGyGT1LNJqQxX7L_imp2.png" position="flex-start" size="78" width="779" height="384" initialPath="../image/imp2.png" githubPath="HTML5/image/imp2.png" darkWidth="779" darkHeight="384" showCaption="false" indent="1"}

::Image[]{src="https://api.archbee.com/api/optimize/wxZG1KsS4xNkVZYoiu_o9/E_ob809sOpH3S5daUaKpy_imp3.png" position="flex-start" size="60" width="595" height="342" initialPath="../image/imp3.png" githubPath="HTML5/image/imp3.png" darkWidth="595" darkHeight="342" showCaption="false" indent="1"}

7. Check cluster status (if clustered) and test operation by logging in to the cluster VIPs (or the standalone device IP).

::Image[]{src="https://api.archbee.com/api/optimize/wxZG1KsS4xNkVZYoiu_o9/6l0p4OGV9vZC5R4anfD67_imp5.png" position="flex-start" size="80" width="1079" height="369" initialPath="../image/imp5.png" githubPath="HTML5/image/imp5.png" darkWidth="1079" darkHeight="369" showCaption="false" indent="1"}

