---
title: "How To Move VMS to a Different CNode"
slug: "how-to-move-vms-to-a-different-cnode"
description: "Easily move a VMS from one CNode to another by deactivating the source node and activating the destination node. Quick guide with CLI commands included."
updated: 2026-10-27T19:37:32Z
published: 2026-10-28T18:28:29Z
canonical: "docs.vastdata.com/how-to-move-vms-to-a-different-cnode"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vastdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# How To Move VMS to a Different CNode

## Summary

The VAST Management Service runs in a dedicated Docker container on a single CNode in the VAST Cluster. By default, it can run on any enabled CNode. In some cases, it may become desirable or necessary to move VMS. There are two ways to move the VMS instance to a new CNode.

## Prerequisites

1. Determine which node VMS is running on
  - From the UI, go to **Infrastructure -> cnodes**
  - The **VMS** column will indicate which CNode currently has VMS:

![The image displays an Infrastructure panel in a management interface, focusing on Cnodes listed with various details such as IP address, OS version, BMC build, and VMS status. The highlighted 'VMS' column indicates whether Virtual Machines Service is enabled or not, crucial for system monitoring and configuration.](https://cdn.us.document360.io/89b91113-5dc6-49db-86ec-57b16dc8ce56/Images/Documentation/c2372014-4ba3-4d3b-b6d1-b63d709aa94f.png?sv=2026-02-06&spr=https&st=2026-11-08T09%3A06%3A33Z&se=2026-11-08T10%3A06%3A33Z&sr=c&sp=r&sig=qCzjxtQKvYatrhMqHo9JHjE1Ev0S9ZsFZInIyVGnZVg%3D)

VMS will indicate current CNode

- From the CLI run the command **clush -g cnodes docker ps | grep vms.** This will return an IP address from the CNode that has VMS:

```plaintext
vastdata@cnode-3-13 ~:$ clush -g cnodes docker ps | grep vms
172.16.3.11: 95a5407f6efb vastdata.registry.local:5000/dev/orion:release-4.2.0-sp-active-606303-vms "/usr/bin/dumb-init …" 19 minutes ago Up 19 minutes vast_vms
```

## Moving VMS

### Deactivate the CNode

The easiest way to move VMS is to deactivate the CNode on which it is running, thereby forcing it to move. You can then re-activate the CNode once VMS has moved. To do this, simply click on the three dots under the **Actions** column on the same page as above, and click on **Deactivate**

![In this Infrastructure dashboard, administrators can manage various CNodes listed under their respective details such as Name, Hostname, Management IP, Operating System (OS), BMC version, and more. The Actions dropdown provides options like Activate or Deactivate nodes, among others, allowing users to control node statuses dynamically.

---

The image depicts an Infrastructure management interface where users can oversee and manipulate CNodes through detailed parameters including names, hostnames, management IPs, OS versions, BMCs, states, and enabling/disabling actions via the 'Actions' menu.](https://cdn.us.document360.io/89b91113-5dc6-49db-86ec-57b16dc8ce56/Images/Documentation/f9c096b8-d595-4551-9489-83a664adaff6.png?sv=2026-02-06&spr=https&st=2026-11-08T09%3A06%3A33Z&se=2026-11-08T10%3A06%3A33Z&sr=c&sp=r&sig=qCzjxtQKvYatrhMqHo9JHjE1Ev0S9ZsFZInIyVGnZVg%3D)

Deactivate the current CNode where VMS is running

### Moving VMS without deactivating the CNode - Using VIP

Beginning with VAST version 4.2, it is possible to indicate a **VMS preferred** status in a VIP pool. In order to move VMS without deactivating a CNode, you can temporarily create a dummy VIP pool with all the CNodes and then disable the CNode it is currently on.

1. Go to **Network Access -> VIP Pools** in the UI

![In the network configuration interface, under the "Infrastructure" section and within the "Network Access" category, there users can manage virtual IP pools to allocate dynamic IP addresses for their network elements.](https://cdn.us.document360.io/89b91113-5dc6-49db-86ec-57b16dc8ce56/Images/Documentation/875eb429-b8b8-411b-aad6-cab88f2fcfca.png?sv=2026-02-06&spr=https&st=2026-11-08T09%3A06%3A33Z&se=2026-11-08T10%3A06%3A33Z&sr=c&sp=r&sig=qCzjxtQKvYatrhMqHo9JHjE1Ev0S9ZsFZInIyVGnZVg%3D)

Virtual IP Pools

1. Click on "Create VIP Pool"

![The image shows the "Network Access" section in a configuration interface with tabs for Virtual IP Pools, Virtual IPs, and DNS management. The "Create New VIP pool" button is highlighted by an arrow, indicating where users can create new virtual IP pools.](https://cdn.us.document360.io/89b91113-5dc6-49db-86ec-57b16dc8ce56/Images/Documentation/c3969565-f900-4b5e-be64-7f091db4f610.png?sv=2026-02-06&spr=https&st=2026-11-08T09%3A06%3A33Z&se=2026-11-08T10%3A06%3A33Z&sr=c&sp=r&sig=qCzjxtQKvYatrhMqHo9JHjE1Ev0S9ZsFZInIyVGnZVg%3D)

Create VIP Pool

1. In the **Add Virtual IP Pool** window, use a dummy IP range, ensure all of your CNodes are in the pool, and toggle **VMS Preferred** on.

![The image shows a configuration interface for updating a VIP pool, with fields to specify the name, subnet CIDR, CNodes included in the pool (cnode-3-11, cnode-2-12, cnoade-313), and an IP range from 192.168.50.54 to 182.58.](https://cdn.us.document360.io/89b91113-5dc6-49db-86ec-57b16dc8ce56/Images/Documentation/2bc09a78-34a6-492b-b0db-6adbf3a61274.png?sv=2026-02-06&spr=https&st=2026-11-08T09%3A06%3A33Z&se=2026-11-08T10%3A06%3A33Z&sr=c&sp=r&sig=qCzjxtQKvYatrhMqHo9JHjE1Ev0S9ZsFZInIyVGnZVg%3D)

toggle VMS Preferred

1. Click **Update**. This will activate the VIP Pool
2. Now edit that VIP Pool by clicking the three dots under the **Actions** column to reopen the same window.

![The image displays an interface element where users can select their preference for using Virtual Machines (VMS) and edit or remove their choice through the options provided in the drop-down menu below 'Actions'.](https://cdn.us.document360.io/89b91113-5dc6-49db-86ec-57b16dc8ce56/Images/Documentation/c13a6273-6186-4149-b673-b0fe37de35e3.png?sv=2026-02-06&spr=https&st=2026-11-08T09%3A06%3A33Z&se=2026-11-08T10%3A06%3A33Z&sr=c&sp=r&sig=qCzjxtQKvYatrhMqHo9JHjE1Ev0S9ZsFZInIyVGnZVg%3D)

Edit VIP Pool

1. Uncheck the CNode that currently has VMS (found in the prerequisite section)

![The screenshot displays a dropdown list titled "CNodes," listing nodes labeled as cnode-3-11, cnode3- 12, and cnode_3- -13, with "cnode- 3-ll" highlighted in red to indicate selection or.](https://cdn.us.document360.io/89b91113-5dc6-49db-86ec-57b16dc8ce56/Images/Documentation/d335dccb-eb23-4346-8d9b-83a7cbe8066c.png?sv=2026-02-06&spr=https&st=2026-11-08T09%3A06%3A33Z&se=2026-11-08T10%3A06%3A33Z&sr=c&sp=r&sig=qCzjxtQKvYatrhMqHo9JHjE1Ev0S9ZsFZInIyVGnZVg%3D)

Uncheck the current CNode

1. Click **Update** at the bottom of the **Update Vip Pool** page. VMS will then move to a new CNode.
2. The VIP Pool can then be deleted using the three-dot menu under **Actions** and selecting **Remove**

![The image displays an interface option with options for selecting 'VMS preferred'. The red arrows point to an "Edit" and "Remove" button, indicating functionalities available in this section for modifying or deleting selections within the VMS configuration.](https://cdn.us.document360.io/89b91113-5dc6-49db-86ec-57b16dc8ce56/Images/Documentation/50893755-97ef-4c60-b529-fea8909ea094.png?sv=2026-02-06&spr=https&st=2026-11-08T09%3A06%3A33Z&se=2026-11-08T10%3A06%3A33Z&sr=c&sp=r&sig=qCzjxtQKvYatrhMqHo9JHjE1Ev0S9ZsFZInIyVGnZVg%3D)

Remove VIP pool

### Moving VMS without deactivating the CNode - Using VMS Settings

1. Connect via vCLI with the admin user
2. Execute `vms list` and check which node is the VMS

```plaintext
vcli: admin> vms list
+------+---------------------+------------+--------------------------------+---------------------+------------+-----------+----------------+-------------+---------------------+------------------+--------------+-----------------------+------------------------+---------------+----------------------------+
| Name | Created             | SW-Version | Build                          | Auto-Logout-Timeout | IP1        | IP2       | MGMT-VIP       | Mgmt-CNode  | Performance-base-10 | Capacity-base-10 | Login-banner | Access-token-lifetime | Refresh-token-lifetime | MGMT-VIP-IPv6 | Perf-debug-metrics-enabled |
+------+---------------------+------------+--------------------------------+---------------------+------------+-----------+----------------+-------------+---------------------+------------------+--------------+-----------------------+------------------------+---------------+----------------------------+
| VMS  | 2024-12-12 17:04:29 | 5.1.0.200  | release-5-1-0-sp45-1560629-vms | 600                 | 10.10.64.1 | 10.10.0.1 | 10.141.200.132 | cnode-128-1 | True                | True             | None         | 01:00:00              | 1 00:00:00             | UNKNOWN       | N/A                        |
+------+---------------------+------------+--------------------------------+---------------------+------------+-----------+----------------+-------------+---------------------+------------------+--------------+-----------------------+------------------------+---------------+----------------------------+
```
  1. **Mgmt-CNode** is **cnode-128-1**
3. Run the following command to change the VMS to a different node

```plaintext
vms modify --preferred-cnode-ids 2
```
4. Check after a few minutes that VMS moved to cnode ID 2

```plaintext
vcli: admin> vms list
+------+---------------------+------------+--------------------------------+---------------------+------------+-----------+----------------+-------------+---------------------+------------------+--------------+-----------------------+------------------------+---------------+----------------------------+
| Name | Created             | SW-Version | Build                          | Auto-Logout-Timeout | IP1        | IP2       | MGMT-VIP       | Mgmt-CNode  | Performance-base-10 | Capacity-base-10 | Login-banner | Access-token-lifetime | Refresh-token-lifetime | MGMT-VIP-IPv6 | Perf-debug-metrics-enabled |
+------+---------------------+------------+--------------------------------+---------------------+------------+-----------+----------------+-------------+---------------------+------------------+--------------+-----------------------+------------------------+---------------+----------------------------+
| VMS  | 2024-12-12 17:04:29 | 5.1.0.200  | release-5-1-0-sp45-1560629-vms | 600                 | 10.10.64.2 | 10.10.0.2 | 10.141.200.132 | cnode-128-2 | True                | True             | None         | 01:00:00              | 1 00:00:00             | UNKNOWN       | N/A                        |
+------+---------------------+------------+--------------------------------+---------------------+------------+-----------+----------------+-------------+---------------------+------------------+--------------+-----------------------+------------------------+---------------+----------------------------+
```