How do I change the IP address of the server with the platform?

Question

How to change the IP address on a VMmanager 6 server?

Ответ

To change the IP address:

1. Connect to the server with the platform via SSH using its current IP address. For more information about connecting via SSH, see Workstation setup.

2. Stop VMmanager:

   sudo vm stop

   Wait for all containers and services to shut down completely.

3. Replace the IP address in the network interface configuration. Choose the option that matches the network manager your server's OS uses. Run:

   systemctl is-active NetworkManager

   If the output is active, use option 1 (NetworkManager).

   Option 1 (NetworkManager) is recommended for AlmaLinux 9 and newer.

   If the output is inactive or unknown, use option 2 (ifcfg config files).

   Note

   The location of network config files may vary depending on your OS and its version.
   Expand option 1 (NetworkManager)

   Option 1. NetworkManager

   To change the IP address:

   1. List current IP addresses and interfaces:
      

      ip -4 addr show

      Example output

      1: lo: <LOOPBACK,UP,LOWER_UP> mtu 65536 qdisc noqueue state UNKNOWN group default qlen 1000
          inet 127.0.0.1/8 scope host lo
             valid_lft forever preferred_lft forever
      
      2: eth0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc pfifo_fast state UP group default qlen 1000
          inet 192.168.1.100/24 brd 192.168.1.255 scope global eth0
             valid_lft forever preferred_lft forever
      
      3: ens3: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc fq_codel state UP group default qlen 1000
          inet 10.0.0.25/16 brd 10.0.255.255 scope global ens3
             valid_lft forever preferred_lft forever

   2. Identify the interface that has the current IP address (e.g., ens3 in the example output).
   3. Find the active connection name:
      
      1. Run:

         nmcli connection show --active

         Example output

         NAME                UUID                                  TYPE      DEVICE
         System eth0         5fb06bd0-0bb0-7ffb-45f1-d6edd65f3e03  ethernet  eth0
         ens3                7c4f9d5e-2a8c-4c3a-9f1b-3e8d5c7e9a1b  ethernet  ens3
         Wired connection 1  a1b2c3d4-e5f6-7890-1234-567890abcdef  ethernet  eth0

      2. In the DEVICE column, find the interface name from the previous step (e.g., ens3). Then take the corresponding NAME from the same row. In the example above, the connection name for interface ens3 is also ens3.
   4. Run the following commands:
      Note

      If the gateway or DNS servers remain the same, skip the corresponding commands.

      sudo nmcli con mod "<connection_name>" ipv4.addresses <new_IP/mask>
      sudo nmcli con mod "<connection_name>" ipv4.gateway <new_gateway>
      sudo nmcli con mod "<connection_name>" ipv4.dns "<DNS>"
      sudo nmcli con mod "<connection_name>" ipv4.method manual

      Comment:

      • <connection name> — obtained in step "c".
      Example command

      sudo nmcli con mod "ens3" ipv4.addresses 10.0.0.50/24
      sudo nmcli con mod "ens3" ipv4.gateway 10.0.0.1
      sudo nmcli con mod "ens3" ipv4.dns "8.8.8.8"
      sudo nmcli con mod "ens3" ipv4.method manual

   5. Apply the changes:
      
      Important

      Your SSH session will drop. Reconnect using the new IP address.

      sudo nmcli con up "<connection_name>"
      

      Comment:
      • <connection_name> — obtained in step "c".
   Expand Option 2 (ifcfg config files)

   Option 2. ifcfg configuration files

   File location depends on the OS:

   Operating System	Configuration File
   Astra Linux, Ubuntu	/etc/network/interfaces
   AlmaLinux	/etc/sysconfig/network-scripts/ifcfg-<interface>

   Warning

   Before changing network configurations, back up the files. For details, see the article Creating platform backups.

   To replace the IP address in the network interface configuration:

   1. Open the file /etc/network/interfaces (or the appropriate file for your OS) in an editor.
   2. Find the section for the target network interface and change the parameters:
      
      • if the subnet is changing: address, netmask, gateway;
      • if the subnet is not changing: only the address value;
        If necessary, add or update DNS servers (parameter dns-nameservers).
        
        Example of a modified network interface section

        auto ens18
        iface ens18 inet static
            address 10.0.0.50
            netmask 255.255.255.0
            gateway 10.0.0.1
            dns-nameservers 8.8.8.8

   3. Apply the changes:
      
      Important

      The SSH session will drop. Reconnect using the new IP address.
      Astra Linux, Ubuntu

      sudo systemctl restart networking

      AlmaLinux

      sudo systemctl restart network

4. Update the VMmanager 6 config file:
   
   1. Open /opt/ispsystem/vm/config.json in an editor.
   2. Find the DomainName parameter. Depending on its value, do the following:
      
      • if the old IP address is specified, replace it with the new one;
      • if a domain name is specified, skip this step.
   3. Save the changes.

5. If necessary, update the DNS record for the domain. If the platform was accessible via a domain name, that name must point to the new IP address. Contact the service where you manage your domain's DNS zone (hosting provider, domain registrar, or your own DNS server) and change the A record to the server's new IP address.

   Note

   After changing the record, it may take some time for the change to propagate through DNS caches.
6. Start VMmanager:
   

   sudo vm start
   

Perform the following checks depending on your scenario:

• new subnet. If the new IP address is from a different subnet:
  
  • verify that the default gateway is correctly set for the new network;
  • ensure that routes to the previous subnet do not conflict with the new settings.
• DNS servers. Verify that the DNS server addresses in /etc/resolv.conf are up to date and reachable from the new network;
• connectivity with nodes. If cluster nodes are unreachable after changing the platform's IP address, check network connectivity to them;
• access to external resources. From the new IP address, verify access to external resources that the platform requires to function. For details, see the Server requirements.