Connect a network volume to a dedicated server with Linux OS

Learn more about network disks in the General information about the Network Disks product instructions.

1. Create a SAN network.
2. Connect the network disk to the server.
3. Connect the network disk to the server in the server OS.
4. Configure MPIO.
5. Optional: connect the network disk to another server.
6. Prepare the network disk for operation.

1. Create a SAN network

1. In the control panel, in the top menu, click Products and select Dedicated Servers.

2. Go to the Network section → SAN network tab.

3. Click Add SAN network.

4. Select an availability zone.

5. Enter a subnet address from the private IP range (10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16) or leave the default generated subnet. The subnet size must be /20.
   Make sure that the subnet is not used in your infrastructure.

6. Click Create SAN network.

2. Connect the network volume to the server

1. In the control panel, in the top menu, click Products and select Dedicated servers.

2. Go to Network drives and storage systems → the Network drives tab.

3. Open the drive page → the Connect to server tab.

4. In the Server field, click Select.

5. Select the server to which the network volume will be connected.

6. Click Confirm.

7. If you are connecting a network volume to a server with a private network, configure the network:

   7.1. Select a VLAN.

   7.2. Enter the subnet CIDR from the private address range 10.0.0.0/8, 172.16.0.0/12, or 192.168.0.0/16.
   Make sure that the subnet does not overlap with the SAN network that you created in step 1 and that it is not used in your infrastructure.

   7.3. Enter the Next hop 1 and Next hop 2 addresses from the selected private subnet.

   7.4. Click Configure.

3. Connect the network volume to the server in the server OS

You can connect a network volume to a server manually or by using a ready-made script generated in the control panel. The script can only be used on Ubuntu OS.

Connect manually

You can connect a network volume via a SAN network or through a private network.

The process of connecting a network volume in the server OS through a private subnet depends on the number of ports:

• if the server has only one local port or MC-LAG is configured, use the instructions for a single port;

• if the server has two local ports, use the instructions for two ports.

  SAN network

  1. Connect to the server via SSH or via the KVM console.

  2. Open the netplan utility configuration file using the vi text editor:

     vi /etc/netplan/50-cloud-init.yaml

  3. Add IP addresses to the network interfaces connected to the SAN switch and configure routes to gain access to the iSCSI targets:

         <eth_name_1>:
                 addresses:
                 - <ip_address_1>
                 routes:
                 - to: <destination_subnet_1>
                 via: <next_hop_1>
         <eth_name_2>:
                 addresses:
                 - <ip_address_2>
                 routes:
                 - to: <destination_subnet_2>
                 via: <next_hop_2>

     Specify:

     • <eth_name_1> — name of the first network interface; it is configured on the first NIC port;
     • <ip_address_1> — IP address of the first NIC port. You can view it in the Control Panel: in the top menu, click Products → Dedicated Servers → Network Disks and Storage section → Network Disks tab → disk page → Network Interface Configuration section → Port IP Address column;
     • <destination_subnet_1> — destination subnet for the first NIC port. You can view it in the Control Panel: in the top menu, click Products → Dedicated Servers → Network Disks and Storage section → Network Disks tab → disk page → Network Interface Configuration section → Destination Subnet column;
     • <next_hop_1> — gateway for the first NIC port. You can view it in the Control Panel: in the top menu, click Products → Dedicated Servers → Network Disks and Storage section → Network Disks tab → disk page → Network Interface Configuration section → Next hop (gateway) column;
     • <eth_name_2> — name of the second network interface; it is configured on the second NIC port;
     • <ip_address_2> — IP address of the second NIC port. You can view it in the Control Panel: in the top menu, click Products → Dedicated Servers → Network Disks and Storage section → Network Disks tab → disk page → Network Interface Configuration section → Port IP Address column;
     • <destination_subnet_2> — destination subnet for the second NIC port. You can view it in the Control Panel: in the top menu, click Products → Dedicated Servers → Network Disks and Storage section → Network Disks tab → disk page → Network Interface Configuration section → Destination Subnet column;
     • <next_hop_2> — gateway for the second NIC port. You can view it in the Control Panel: in the top menu, click Products → Dedicated Servers → Network Disks and Storage section → Network Disks tab → disk page → Network Interface Configuration section → Next hop (gateway) column.

  4. Exit the vi text editor saving the changes:

     :wq

  5. Apply the configuration:

     netplan apply

  6. Display information about the network interfaces and check that they are configured correctly:

     ip a

  7. Optional: reboot the server.

  8. Check that the operating speed of each interface is at least 10 Gbps:

     ethtool <eth_name_1> | grep -i speed
     ethtool <eth_name_2> | grep -i speed

     Specify <eth_name_1> and <eth_name_2> — the names of the network interfaces you configured in step 3.

  9. If the speed is below 10 Gbps, submit a ticket.

  10. Check that the iSCSI target is accessible:

      ping -c5 <iscsi_target_ip_address_1>
      ping -c5 <iscsi_target_ip_address_2>

      Specify:

      • <iscsi_target_ip_address_1> — IP address of the first iSCSI target. You can view it in the Control Panel: in the top menu, click Products → Dedicated Servers → Network Disks and Storage section → Network Disks tab → disk page → iSCSI Connection Configuration section → iSCSI Target 1 IP Address field;
      • <iscsi_target_ip_address_2> — IP address of the second iSCSI target. You can view it in the Control Panel: in the top menu, click Products → Dedicated Servers → Network Disks and Storage section → Network Disks tab → disk page → iSCSI Connection Configuration section → iSCSI Target 2 IP Address field.

  11. Enter the iSCSI initiator name:

      vi /etc/iscsi/initiatorname.iscsi
      InitiatorName= <initiator_name>

      Specify <initiator_name> – iSCSI initiator name. You can view it in the Control Panel: in the top menu, click Products → Dedicated Servers → Network Disks and Storage section → Network Disks tab → disk page → iSCSI Connection Configuration section → Initiator name field.

  12. Restart iSCSI:

      systemctl restart iscsid.service
      systemctl restart multipathd.service

  13. Create iSCSI interfaces:

      iscsiadm -m iface -I <iscsi_eth_name_1> --op new
      iscsiadm -m iface -I <iscsi_eth_name_2> --op new

      Specify:

      • <iscsi_eth_name_1> — name of the first iSCSI interface;
      • <iscsi_eth_name_2> — name of the second iSCSI interface.

      iSCSI interface names must not match the names of existing network interfaces. You can view the list of existing network interfaces using the ip a command.

  14. Bind the iSCSI interfaces to the network interfaces:

      iscsiadm -m iface --interface <iscsi_eth_name_1> --op update -n iface.net_ifacename -v <eth_name_1>
      iscsiadm -m iface --interface <iscsi_eth_name_2> --op update -n iface.net_ifacename -v <eth_name_2>

      Specify:

      • <iscsi_eth_name_1> — name of the first iSCSI interface you created in step 13;
      • <eth_name_1> — name of the first network interface you configured in step 3;
      • <iscsi_eth_name_2> — name of the second iSCSI interface you created in step 13;
      • <eth_name_2> — name of the second network interface you configured in step 3.

  15. Check the accessibility of the iSCSI target via the iSCSI interfaces:

      iscsiadm -m discovery -t sendtargets -p <iscsi_target_ip_address_1> --interface <iscsi_eth_name_1>
      iscsiadm -m discovery -t sendtargets -p <iscsi_target_ip_address_2> --interface <iscsi_eth_name_2>

      Specify:

      • <iscsi_target_ip_address_1> — IP address of the first iSCSI target. You can view it in the Control Panel: in the top menu, click Products → Dedicated Servers → Network Disks and Storage section → Network Disks tab → disk page → iSCSI Connection Configuration section → iSCSI Target 1 IP Address field;
      • <iscsi_eth_name_1> — name of the first iSCSI interface you created in step 13;
      • <iscsi_target_ip_address_2> — IP address of the second iSCSI target. You can view it in the Control Panel: in the top menu, click Products → Dedicated Servers → Network Disks and Storage section → Network Disks tab → disk page → iSCSI Connection Configuration section → iSCSI Target 2 IP Address field;
      • <iscsi_eth_name_2> — name of the second iSCSI interface you created in step 13.

      A list of iSCSI targets will appear in the output. For example:

      10.100.1.2:3260,1 iqn.2003-01.com.redhat.iscsi-gw:workshop-target
      10.100.1.6:3260,2 iqn.2003-01.com.redhat.iscsi-gw:workshop-target

      Where:

      • 10.100.1.2:3260 — IP address of the first iSCSI target;
      • iqn.2003-01.com.redhat.iscsi-gw:workshop-target — IQN of the first iSCSI target. IQN (iSCSI Qualified Name) is a globally unique identifier for an iSCSI device;
      • 10.100.1.6:3260 — IP address of the second iSCSI target;
      • iqn.2003-01.com.redhat.iscsi-gw:workshop-target — IQN of the second iSCSI target.

  16. Configure CHAP authentication on the iSCSI Initiator:

      iscsiadm --mode node -T <iqn> -p <iscsi_target_ip_address_1> --op update -n node.session.auth.authmethod --value CHAP
      
      iscsiadm --mode node -T <iqn> -p <iscsi_target_ip_address_2> --op update -n node.session.auth.authmethod --value CHAP
      
      iscsiadm --mode node -T <iqn> --op update -n node.session.auth.username --value <username>
      
      iscsiadm --mode node -T <iqn> -p <iscsi_target_ip_address_1> --op update -n node.session.auth.password --value <password>
      
      iscsiadm --mode node -T <iqn> -p <iscsi_target_ip_address_2> --op update -n node.session.auth.password --value <password>

      Specify:

      • <iqn> — IQN of the first and second iSCSI targets. You can view it in the Control Panel: in the top menu, click Products → Dedicated Servers → Network Disks and Storage section → Network Disks tab → disk page → iSCSI Connection Configuration section → Target name field;
      • <iscsi_target_ip_address_1> — IP address of the first iSCSI target. You can view it in the Control Panel: in the top menu, click Products → Dedicated Servers → Network Disks and Storage section → Network Disks tab → disk page → iSCSI Connection Configuration section → iSCSI Target 1 IP Address field;
      • <iscsi_target_ip_address_2> — IP address of the second iSCSI target. You can view it in the Control Panel: in the top menu, click Products → Dedicated Servers → Network Disks and Storage section → Network Disks tab → disk page → iSCSI Connection Configuration section → iSCSI Target 2 IP Address field;
      • <username> — username for iSCSI initiator authentication. You can view it in the Control Panel: in the top menu, click Products → Dedicated Servers → Network Disks and Storage section → Network Disks tab → disk page → iSCSI Connection Configuration section → Username field;
      • <password> — password for iSCSI initiator authentication. You can view it in the Control Panel: in the top menu, click Products → Dedicated Servers → Network Disks and Storage section → Network Disks tab → disk page → iSCSI Connection Configuration section → Password field.

  17. Authorize on the iSCSI target via the iSCSI interfaces:

      iscsiadm --mode node -T <iqn> -p <iscsi_target_ip_address_1> --login --interface <iscsi_eth_name_1>
      iscsiadm --mode node -T <iqn> -p <iscsi_target_ip_address_2> --login --interface <iscsi_eth_name_2>

      Specify:

      • <iqn> — IQN of the first and second iSCSI targets. You can view it in the Control Panel: in the top menu, click Products → Dedicated Servers → Network Disks and Storage section → Network Disks tab → disk page → iSCSI Connection Configuration section → Target name field;
      • <iscsi_target_ip_address_1> — IP address of the first iSCSI target. You can view it in the Control Panel: in the top menu, click Products → Dedicated Servers → Network Disks and Storage section → Network Disks tab → disk page → iSCSI Connection Configuration section → iSCSI Target 2 IP Address field;
      • <iscsi_eth_name_1> — name of the first iSCSI interface you created in step 13;
      • <iscsi_target_ip_address_2> — IP address of the second iSCSI target. You can view it in the Control Panel: in the top menu, click Products → Dedicated Servers → Network Disks and Storage section → Network Disks tab → disk page → iSCSI Connection Configuration section → iSCSI Target 2 IP Address field;
      • <iscsi_eth_name_2> — name of the second iSCSI interface you created in step 13.

  18. Check that the iSCSI session has started for each iSCSI target:

      iscsiadm -m session

      Two active iSCSI sessions will appear in the output. For example:

      tcp: [1] 10.100.1.2:3260,1 iqn.2003-01.com.redhat.iscsi-gw:workshop-target (non-flash)
      tcp: [3] 10.100.1.6:3260,2 iqn.2003-01.com.redhat.iscsi-gw:workshop-target (non-flash)

      Here, [1] and [3] are iSCSI session numbers.

  19. Enable automatic disk connection upon server reboot by setting the node.startup parameter to automatic:

      iscsiadm --mode node -T <iqn> -p <iscsi_target_ip_address_1> --op update -n node.startup -v automatic
      iscsiadm --mode node -T <iqn> -p <iscsi_target_ip_address_2> --op update -n node.startup -v automatic
      systemctl enable iscsid.service
      systemctl restart iscsid.service

      Specify:

      • <iqn> — IQN of the first and second iSCSI targets. You can view it in the Control Panel: in the top menu, click Products → Dedicated Servers → Network Disks and Storage section → Network Disks tab → disk page → iSCSI Connection Configuration section → Target name field;
      • <iscsi_target_ip_address_1> — IP address of the first iSCSI target. You can view it in the Control Panel: in the top menu, click Products → Dedicated Servers → Network Disks and Storage section → Network Disks tab → disk page → iSCSI Connection Configuration section → iSCSI Target 1 IP Address field;
      • <iscsi_target_ip_address_2> — IP address of the second iSCSI target. You can view it in the Control Panel: in the top menu, click Products → Dedicated Servers → Network Disks and Storage section → Network Disks tab → disk page → iSCSI Connection Configuration section → iSCSI Target 1 IP Address.

  20. Optional: reboot the server.

  Private network: single port

  1. Connect to the server via SSH or via the KVM console.

  2. Open the netplan utility configuration file using the vi text editor:

     vi /etc/netplan/50-cloud-init.yaml

  3. Add an IP address to the local port network interface and configure routes to gain access to the iSCSI targets:

         <eth_name>:
             addresses:
             - <ip_address>
             routes:
             - to: <destination_subnet_1>
             via: <next_hop_1>
             - to: <destination_subnet_2>
             via: <next_hop_2>

     Specify:

     • <eth_name> — name of the private network interface; it is configured on the local NIC port;
     • <ip_address> — an available IP address for the local NIC port from the private subnet you configured when attaching the network disk to the server in step 7;
     • <destination_subnet_1> — first destination subnet on the local NIC port. You can view it in the Control Panel: in the top menu, click Products → Dedicated Servers → Network Disks and Storage section → Network Disks tab → disk page → Network Interface Configuration section → Destination Subnet column;
     • <next_hop_1> — first gateway on the local NIC port that you configured when attaching the network disk to the server in step 6. You can view it in the Control Panel: in the top menu, click Products → Dedicated Servers → Network Disks and Storage section → Network Disks tab → disk page → Network Interface Configuration section → Next hop (gateway) column;
     • <destination_subnet_2> — second destination subnet on the local NIC port. You can view it in the Control Panel: in the top menu, click Products → Dedicated Servers → Network Disks and Storage section → Network Disks tab → disk page → Network Interface Configuration section → Destination Subnet column;
     • <next_hop_2> — second gateway on the local NIC port that you configured when attaching the network disk to the server in step 6. You can view it in the Control Panel: in the top menu, click Products → Dedicated Servers → Network Disks and Storage section → Network Disks tab → disk page → Network Interface Configuration section → Next hop (gateway) column.

  4. Exit the vi text editor saving the changes:

     :wq

  5. Apply the configuration:

     netplan apply

  6. Display information about the network interfaces and check that they are configured correctly:

     ip a

  7. Optional: reboot the server.

  8. Check that the iSCSI targets are accessible:

     ping -c5 <iscsi_target_ip_address_1>
     ping -c5 <iscsi_target_ip_address_2>

     Specify:

     • <iscsi_target_ip_address_1> — IP address of the first iSCSI target. You can view it in the Control Panel: in the top menu, click Products → Dedicated Servers → Network Disks and Storage section → Network Disks tab → disk page → iSCSI Connection Configuration section → iSCSI Target 1 IP Address field;
     • <iscsi_target_ip_address_2> — IP address of the second iSCSI target. You can view it in the Control Panel: in the top menu, click Products → Dedicated Servers → Network Disks and Storage section → Network Disks tab → disk page → iSCSI Connection Configuration section → iSCSI Target 2 IP Address field.

  9. Enter the iSCSI initiator name:

     vi /etc/iscsi/initiatorname.iscsi
     InitiatorName= <initiator_name>

     Specify <initiator_name> – iSCSI initiator name. You can view it in the Control Panel: in the top menu, click Products → Dedicated Servers → Network Disks and Storage section → Network Disks tab → disk page → iSCSI Connection Configuration section → Initiator name field.

  10. Restart iSCSI:

      systemctl restart iscsid.service
      systemctl restart multipathd.service

  11. Create an iSCSI interface:

      iscsiadm -m iface -I <iscsi_eth_name> --op new

      Specify <iscsi_eth_name> — the iSCSI interface name. The iSCSI interface name must not match the name of an existing network interface. You can view the list of existing network interfaces using the ip a command.

  12. Bind the iSCSI interface to the network interface that you configured in step 3:

      iscsiadm -m iface --interface <iscsi_eth_name> --op update -n iface.net_ifacename -v <eth_name>

      Specify:

      • <iscsi_eth_name> — name of the iSCSI interface you created in step 11;
      • <eth_name> — name of the private network interface you configured in step 3.

  13. Check the accessibility of the iSCSI targets via the iSCSI interface:

      iscsiadm -m discovery -t sendtargets -p <iscsi_target_ip_address_1> --interface <iscsi_eth_name>
      iscsiadm -m discovery -t sendtargets -p <iscsi_target_ip_address_2> --interface <iscsi_eth_name>

      Specify:

      • <iscsi_target_ip_address_1> — IP address of the first iSCSI target. You can view it in the Control Panel: in the top menu, click Products → Dedicated Servers → Network Disks and Storage section → Network Disks tab → disk page → iSCSI Connection Configuration section → iSCSI Target 1 IP Address field;
      • <iscsi_target_ip_address_2> — IP address of the second iSCSI target. You can view it in the Control Panel: in the top menu, click Products → Dedicated Servers → Network Disks and Storage section → Network Disks tab → disk page → iSCSI Connection Configuration section → iSCSI Target 2 IP Address field;
      • <iscsi_eth_name> — name of the iSCSI interface you created in step 11.

      A list of iSCSI targets will appear in the output. For example:

      10.100.1.2:3260,1 iqn.2003-01.com.redhat.iscsi-gw:workshop-target
      10.100.1.6:3260,2 iqn.2003-01.com.redhat.iscsi-gw:workshop-target

      Where:

      • 10.100.1.2:3260 — IP address of the first iSCSI target;
      • iqn.2003-01.com.redhat.iscsi-gw:workshop-target — IQN of the first iSCSI target. IQN (iSCSI Qualified Name) is a globally unique identifier for an iSCSI device;
      • 10.100.1.6:3260 — IP address of the second iSCSI target;
      • iqn.2003-01.com.redhat.iscsi-gw:workshop-target — IQN of the second iSCSI target.

  14. Configure CHAP authentication on the iSCSI Initiator:

      iscsiadm --mode node -T <iqn> -p <iscsi_target_ip_address_1> --op update -n node.session.auth.authmethod --value CHAP
      
      iscsiadm --mode node -T <iqn> -p <iscsi_target_ip_address_2> --op update -n node.session.auth.authmethod --value CHAP
      
      iscsiadm --mode node -T <iqn> --op update -n node.session.auth.username --value <username>
      
      iscsiadm --mode node -T <iqn> -p <iscsi_target_ip_address_1> --op update -n node.session.auth.password --value <password>
      
      iscsiadm --mode node -T <iqn> -p <iscsi_target_ip_address_2> --op update -n node.session.auth.password --value <password>

      Specify:

      • <iqn> — IQN of the first and second iSCSI targets. You can view it in the Control Panel: in the top menu, click Products → Dedicated Servers → Network Disks and Storage section → Network Disks tab → disk page → iSCSI Connection Configuration section → Target name field;
      • <iscsi_target_ip_address_1> — IP address of the first iSCSI target. You can view it in the Control Panel: in the top menu, click Products → Dedicated Servers → Network Disks and Storage section → Network Disks tab → disk page → iSCSI Connection Configuration section → IP address of the iSCSI target 1;
      • <iscsi_target_ip_address_2> — IP address of the second iSCSI target. You can view it in the Control Panel: in the top menu, click Products → Dedicated Servers → Network Disks and Storage section → Network Disks tab → disk page → iSCSI Connection Configuration section → IP address of the iSCSI target 2;
      • <username> — username for iSCSI initiator authentication. You can view it in the Control Panel: in the top menu, click Products → Dedicated Servers → Network Disks and Storage section → Network Disks tab → disk page → iSCSI Connection Configuration section → Username;
      • <password> — password for iSCSI initiator authentication. You can view it in the Control Panel: in the top menu, click Products → Dedicated Servers → Network Disks and Storage section → Network Disks tab → disk page → iSCSI Connection Configuration section → Password.

  15. Authorize on the iSCSI target via the iSCSI interface:

      iscsiadm --mode node -T <iqn> -p <iscsi_target_ip_address_1> --login --interface <iscsi_eth_name>
      iscsiadm --mode node -T <iqn> -p <iscsi_target_ip_address_2> --login --interface <iscsi_eth_name>

      Specify:

      • <iqn> — IQN of the first and second iSCSI targets. You can view it in the Control Panel: in the top menu, click Products → Dedicated Servers → Network Disks and Storage section → Network Disks tab → disk page → iSCSI Connection Configuration section → Target name;
      • <iscsi_target_ip_address_1> — IP address of the first iSCSI target. You can view it in the Control Panel: in the top menu, click Products → Dedicated Servers → Network Disks and Storage section → Network Disks tab → disk page → iSCSI Connection Configuration section → iSCSI Target 1 IP Address;
      • <iscsi_target_ip_address_2> — IP address of the second iSCSI target. You can view it in the Control Panel: in the top menu, click Products → Dedicated Servers → Network Disks and Storage section → Network Disks tab → disk page → iSCSI Connection Configuration section → iSCSI Target 2 IP Address;
      • <iscsi_eth_name> — name of the iSCSI interface you created in step 11.

  16. Check that the iSCSI session has started for each iSCSI target:

      iscsiadm -m session

      Two active iSCSI sessions will appear in the output. For example:

      tcp: [1] 10.100.1.2:3260,1 iqn.2003-01.com.redhat.iscsi-gw:workshop-target (non-flash)
      tcp: [3] 10.100.1.6:3260,2 iqn.2003-01.com.redhat.iscsi-gw:workshop-target (non-flash)

      Here, [1] and [3] are iSCSI session numbers.

  17. Enable automatic disk connection upon server reboot by setting the node.startup parameter to automatic:

      iscsiadm --mode node -T <iqn> -p <iscsi_target_ip_address_1> --op update -n node.startup -v automatic
      iscsiadm --mode node -T <iqn> -p <iscsi_target_ip_address_2> --op update -n node.startup -v automatic
      systemctl enable iscsid.service
      systemctl restart iscsid.service

      Specify:

      • <iqn> — IQN of the first and second iSCSI targets;
      • <iscsi_target_ip_address_1> — IP address of the first iSCSI target;
      • <iscsi_target_ip_address_2> — IP address of the second iSCSI target.

  18. Optional: reboot the server.

  Private network: two ports

  1. Connect to the server via SSH or via the KVM console.

  2. Open the netplan utility configuration file using the vi text editor:

     vi /etc/netplan/50-cloud-init.yaml

  3. Add IP addresses to the local port network interfaces and configure routes to gain access to the iSCSI targets:

         <eth_name_1>:
                 addresses:
                 - <ip_address_1>
                 routes:
                 - to: <destination_subnet_1>
                 via: <next_hop_1>
         <eth_name_2>:
                 addresses:
                 - <ip_address_2>
                 routes:
                 - to: <destination_subnet_2>
                 via: <next_hop_2>

     Specify:

     • <eth_name_1> — name of the first network interface; it is configured on the first local NIC port;
     • <ip_address_1> — an available IP address for the first NIC port from the private subnet you configured when attaching the network disk to the server in step 7;
     • <destination_subnet_1> — destination subnet for the first NIC port. You can view it in the Control Panel: in the top menu, click Products → Dedicated Servers → Network Disks and Storage section → Network Disks tab → disk page → Network Interface Configuration section → Destination Subnet column;
     • <next_hop_1> — gateway for the first NIC port. You can view it in the Control Panel: in the top menu, click Products → Dedicated Servers → Network Disks and Storage section → Network Disks tab → disk page → Network Interface Configuration section → Next hop (gateway) column;
     • <eth_name_2> — name of the second network interface; it is configured on the second local NIC port;
     • <ip_address_2> — an available IP address for the second NIC port from the private subnet you configured when attaching the network disk to the server in step 7;
     • <destination_subnet_2> — destination subnet for the second NIC port. You can view it in the Control Panel: in the top menu, click Products → Dedicated Servers → Network Disks and Storage section → Network Disks tab → disk page → Network Interface Configuration section → Destination Subnet column;
     • <next_hop_2> — gateway for the second NIC port. You can view it in the Control Panel: in the top menu, click Products → Dedicated Servers → Network Disks and Storage section → Network Disks tab → disk page → Network Interface Configuration section → Next hop (gateway) column.

  4. Exit the vi text editor saving the changes:

     :wq

  5. Apply the configuration:

     netplan apply

  6. Display information about the network interfaces and check that they are configured correctly:

     ip a

  7. Optional: reboot the server.

  8. Check that the iSCSI target is accessible:

     ping -c5 <iscsi_target_ip_address_1>
     ping -c5 <iscsi_target_ip_address_2>

     Specify:

     • <iscsi_target_ip_address_1> — IP address of the first iSCSI target. You can view it in the Control Panel: in the top menu, click Products → Dedicated Servers → Network Disks and Storage section → Network Disks tab → disk page → iSCSI Connection Configuration section → iSCSI Target 1 IP Address field;
     • <iscsi_target_ip_address_2> — IP address of the second iSCSI target. You can view it in the Control Panel: in the top menu, click Products → Dedicated Servers → Network Disks and Storage section → Network Disks tab → disk page → iSCSI Connection Configuration section → iSCSI Target 2 IP Address field.

  9. Enter the iSCSI initiator name:

     vi /etc/iscsi/initiatorname.iscsi
     InitiatorName= <initiator_name>

     Specify <initiator_name> – iSCSI initiator name. You can view it in the Control Panel: in the top menu, click Products → Dedicated Servers → Network Disks and Storage section → Network Disks tab → disk page → iSCSI Connection Configuration section → Initiator name field.

  10. Restart iSCSI:

      systemctl restart iscsid.service
      systemctl restart multipathd.service

  11. Create iSCSI interfaces:

      iscsiadm -m iface -I <iscsi_eth_name_1> --op new
      iscsiadm -m iface -I <iscsi_eth_name_2> --op new

      Specify:

      • <iscsi_eth_name_1> — name of the first iSCSI interface;
      • <iscsi_eth_name_2> — name of the second iSCSI interface.

      iSCSI interface names must not match the names of existing network interfaces. You can view the list of existing network interfaces using the ip a command.

  12. Bind the iSCSI interfaces to the network interfaces:

      iscsiadm -m iface --interface <iscsi_eth_name_1> --op update -n iface.net_ifacename -v <eth_name_1>
      iscsiadm -m iface --interface <iscsi_eth_name_2> --op update -n iface.net_ifacename -v <eth_name_2>

      Specify:

      • <iscsi_eth_name_1> — name of the first iSCSI interface you created in step 11;
      • <eth_name_1> — name of the first network interface you configured in step 3;
      • <iscsi_eth_name_2> — name of the second iSCSI interface you created in step 11;
      • <eth_name_2> — name of the second network interface you configured in step 3.

  13. Check the accessibility of the iSCSI target via the iSCSI interfaces:

      iscsiadm -m discovery -t sendtargets -p <iscsi_target_ip_address_1> --interface <iscsi_eth_name_1>
      iscsiadm -m discovery -t sendtargets -p <iscsi_target_ip_address_2> --interface <iscsi_eth_name_2>

      Specify:

      • <iscsi_target_ip_address_1> — IP address of the first iSCSI target. You can view it in the Control Panel: in the top menu, click Products → Dedicated Servers → Network Disks and Storage section → Network Disks tab → disk page → iSCSI Connection Configuration section → iSCSI Target 1 IP Address field;
      • <iscsi_eth_name_1> — name of the first iSCSI interface you created in step 11;
      • <iscsi_target_ip_address_2> — IP address of the second iSCSI target. You can view it in the Control Panel: in the top menu, click Products → Dedicated Servers → Network Disks and Storage section → Network Disks tab → disk page → iSCSI Connection Configuration section → iSCSI Target 2 IP Address field;
      • <iscsi_eth_name_2> — name of the second iSCSI interface you created in step 11.

      A list of iSCSI targets will appear in the output. For example:

      10.100.1.2:3260,1 iqn.2003-01.com.redhat.iscsi-gw:workshop-target
      10.100.1.6:3260,2 iqn.2003-01.com.redhat.iscsi-gw:workshop-target

      Where:

      • 10.100.1.2:3260 — IP address of the first iSCSI target;
      • iqn.2003-01.com.redhat.iscsi-gw:workshop-target — IQN of the first iSCSI target. IQN (iSCSI Qualified Name) is a globally unique identifier for an iSCSI device;
      • 10.100.1.6:3260 — IP address of the second iSCSI target;
      • iqn.2003-01.com.redhat.iscsi-gw:workshop-target — IQN of the second iSCSI target.

  14. Configure CHAP authentication on the iSCSI Initiator:

      iscsiadm --mode node -T <iqn> -p <iscsi_target_ip_address_1> --op update -n node.session.auth.authmethod --value CHAP
      
      iscsiadm --mode node -T <iqn> -p <iscsi_target_ip_address_2> --op update -n node.session.auth.authmethod --value CHAP
      
      iscsiadm --mode node -T <iqn> --op update -n node.session.auth.username --value <username>
      
      iscsiadm --mode node -T <iqn> -p <iscsi_target_ip_address_1> --op update -n node.session.auth.password --value <password>
      
      iscsiadm --mode node -T <iqn> -p <iscsi_target_ip_address_2> --op update -n node.session.auth.password --value <password>

      Specify:

      • <iscsi_target_ip_address_1> — IP address of the first iSCSI target. You can view it in the Control Panel: in the top menu, click Products → Dedicated Servers → Network Disks and Storage section → Network Disks tab → disk page → iSCSI Connection Configuration section → iSCSI Target 1 IP Address field;
      • <iqn> — IQN of the first and second iSCSI targets. You can view it in the Control Panel: in the top menu, click Products → Dedicated Servers → Network Disks and Storage section → Network Disks tab → disk page → iSCSI Connection Configuration section → Target name field;
      • <iscsi_target_ip_address_2> — IP address of the second iSCSI target. You can view it in the Control Panel: in the top menu, click Products → Dedicated Servers → Network Disks and Storage section → Network Disks tab → disk page → iSCSI Connection Configuration section → iSCSI Target 2 IP Address field;
      • <username> — username for iSCSI initiator authentication. You can view it in the Control Panel: in the top menu, click Products → Dedicated Servers → Network Disks and Storage section → Network Disks tab → disk page → iSCSI Connection Configuration section → Username field;
      • <password> — password for iSCSI initiator authentication. You can view it in the Control Panel: in the top menu, click Products → Dedicated Servers → Network Disks and Storage section → Network Disks tab → disk page → iSCSI Connection Configuration section → Password field.

  15. Authorize on the iSCSI target via the iSCSI interfaces:

      iscsiadm --mode node -T <iqn> -p <iscsi_target_ip_address_1> --login --interface <iscsi_eth_name_1>
      iscsiadm --mode node -T <iqn> -p <iscsi_target_ip_address_2> --login --interface <iscsi_eth_name_2>

      Specify:

      • <iqn> — IQN of the first and second iSCSI targets. You can view it in the Control Panel: in the top menu, click Products → Dedicated Servers → Network Disks and Storage section → Network Disks tab → disk page → iSCSI Connection Configuration section → Target name;
      • <iscsi_target_ip_address_1> — IP address of the first iSCSI target. You can view it in the Control Panel: in the top menu, click Products → Dedicated Servers → Network Disks and Storage section → Network Disks tab → disk page → iSCSI Connection Configuration section → iSCSI Target 1 IP Address;
      • <iscsi_eth_name_1> — name of the first iSCSI interface you created in step 11;
      • <iscsi_target_ip_address_2> — IP address of the second iSCSI target. You can view it in the Control Panel: in the top menu, click Products → Dedicated Servers → Network Disks and Storage section → Network Disks tab → disk page → iSCSI Connection Configuration section → iSCSI Target 2 IP Address;
      • <iscsi_eth_name_2> — name of the second iSCSI interface you created in step 11.

  16. Check that the iSCSI session has started for each iSCSI target:

      iscsiadm -m session

      Two active iSCSI sessions will appear in the output. For example:

      tcp: [1] 10.100.1.2:3260,1 iqn.2003-01.com.redhat.iscsi-gw:workshop-target (non-flash)
      tcp: [3] 10.100.1.6:3260,2 iqn.2003-01.com.redhat.iscsi-gw:workshop-target (non-flash)

      Here, [1] and [3] are iSCSI session numbers.

  17. Enable automatic disk connection upon server reboot by setting the node.startup parameter to automatic:

      iscsiadm --mode node -T <iqn> -p <iscsi_target_ip_address_1> --op update -n node.startup -v automatic
      iscsiadm --mode node -T <iqn> -p <iscsi_target_ip_address_2> --op update -n node.startup -v automatic
      systemctl enable iscsid.service
      systemctl restart iscsid.service

      Specify:

      • <iqn> — IQN of the first and second iSCSI targets;
      • <iscsi_target_ip_address_1> — IP address of the first iSCSI target;
      • <iscsi_target_ip_address_2> — IP address of the second iSCSI target.

  18. Optional: reboot the server.

Connect using a script

SAN network

1. In the Control Panel, in the top menu, click Products and select Dedicated Servers.

2. Go to the Network Disks and Storage section → Network Disks tab.

3. Open the network volume page.

4. In the Network Interface Configuration block, open the Ready configuration file tab.

5. Copy the parameters for the netplan utility configuration file.

6. In the iSCSI Connection Configuration block, open the Ready script tab.

7. Copy the iSCSI connection setup script.

8. Connect to the server via SSH or via the KVM console.

9. Open the netplan utility configuration file using the vi text editor:

   vi /etc/netplan/50-cloud-init.yaml

10. Paste the parameters you copied in step 5. Specify:

    • <eth_name_1> — name of the first network interface; it is configured on the first NIC port;
    • <eth_name_2> — name of the second network interface; it is configured on the second NIC port.

11. Exit the vi text editor saving the changes:

    :wq

12. Apply the configuration:

    netplan apply

13. Create a script file using the vi text editor:

    vi <file_name>

    Specify <file_name> — filename in the .sh format.

14. Switch to insert mode by pressing i.

15. Paste the script text you copied in step 7 into the file.

16. Press Esc.

17. Exit the vi text editor saving the changes:

    :wq

18. Make the script executable:

    chmod +x <file_name>

    Specify <file_name> — name of the script file you specified in step 13.

19. Run the script with arguments:

    ./<script_name> <eth_name_1> <eth_name_2>

    • <file_name> — name of the script file you specified in step 13;
    • <eth_name_1> — name of the first network interface on the first NIC port that you specified in step 10;
    • <eth_name_2> — name of the second network interface on the second NIC port that you specified in step 10.

Private network: one port

1. In the Control Panel, in the top menu, click Products and select Dedicated Servers.

2. Go to the Network Disks and Storage section → Network Disks tab.

3. Open the network volume page.

4. In the Network Interface Configuration block, open the Ready configuration file tab.

5. Copy the parameters for the netplan utility configuration file.

6. In the iSCSI Connection Configuration block, open the Ready script tab.

7. Copy the iSCSI connection setup script.

8. Connect to the server via SSH or via the KVM console.

9. Open the netplan utility configuration file using the vi text editor:

   vi /etc/netplan/50-cloud-init.yaml

10. Paste the parameters you copied in step 5. Specify:

    • <eth_name> — name of the private network interface; it is configured on the local NIC port;
    • <ip_address> — an available IP address for the local NIC port from the private subnet you configured when attaching the network disk to the server in step 7.

11. Exit the vi text editor saving the changes:

    :wq

12. Apply the configuration:

    netplan apply

13. Create a script file using the vi text editor:

    vi <file_name>

    Specify <file_name> — the file name in the .sh format.

14. Switch to insert mode by pressing i.

15. Paste the script text you copied in step 7 into the file.

16. Press Esc.

17. Exit the vi text editor and save your changes:

    :wq

18. Make the script executable:

    chmod +x <file_name>

    Specify <file_name> — the script file name that you specified in step 13.

19. Run the script with arguments:

    ./<script_name> <eth_name>

    • <file_name> — the script file name that you specified in step 13;
    • <eth_name> — name of the network interface on the local NIC port that you specified in step 10.

4. Configure MPIO

MultiPath-IO (MPIO) is multi-path I/O to improve the fault tolerance of data transfer to a network volume.

In Ubuntu OS, MPIO is configured by default; check the settings.

1. Open the Device Mapper Multipath utility configuration file using the vi text editor:

   vi /etc/multipath.conf

2. Make sure that the /etc/multipath.conf file contains only the following lines:

   defaults {
       user_friendly_names yes
   }

3. Make sure that the bindings file contains information about the WWID of the block device:

   cat /etc/multipath/bindings

   The response will display information about the WWID of the block device. For example:

   # Format:
   # alias wwid
   #
   mpatha 3600140530fab7e779fa41038a0a08f8e

4. Make sure that the wwids file contains information about the WWID of the block device:

   cat /etc/multipath/wwids

   The response will display information about the WWID of the block device. For example:

   # Valid WWIDs:
   /3600140530fab7e779fa41038a0a08f8e/

5. Check the network drive connection and make sure that the policy parameter is set to service-time 0:

   multipath -ll

   The response will display information about the devices, paths, and current policy. For example:

   mpatha (3600140530fab7e779fa41038a0a08f8e) dm-0 LIO-ORG,TCMU device
   size=20G features='0' hwhandler='1 alua' wp=rw
   |-+- policy='service-time 0' prio=10 status=active
   | `- 8:0:0:0 sdc 8:32 active ready running
   `-+- policy='service-time 0' prio=10 status=enabled
   `- 9:0:0:0 sdd 8:48 active ready running

5. Optional: connect the network volume to another server

1. Connect the network drive to the server in the control panel.
2. Connect the network drive to the server in the server OS.
3. Configure MPIO.

6. Prepare the network volume for use

To share access among multiple servers, we recommend using cluster file systems.

The network volume that you connected to the server can be formatted into the required file system:

• a cluster file system (Cluster File System, CFS) — a file system that allows multiple servers (nodes) to work simultaneously with the same data on shared storage. Examples of cluster file systems:

  • GFS2 (Global File System 2); for details, see the GFS2 Overview article in the official Red Hat documentation;
  • OCFS2 (Oracle Cluster File System 2); for details, see the official Oracle Linux documentation.

• Logical Volume Manager (LVM) is storage virtualization software designed for flexible management of physical storage devices. For details, see the Configuring and managing logical volumes guide in the official Red Hat documentation;

• standard file system, for example, ext4 or XFS. Note that in read-write mode, a standard file system can only be used on one server at a time to prevent data corruption. To speed up the formatting process when creating a file system, use the -K option, which disables zero initialization (discard) of disk blocks.

  Example command to format the file system:

  mkfs -t <filesystem> -K /dev/mapper/<block_storage_name>

  Specify:

  • <filesystem> — file system type, for example, ext4 or xfs;
  • <block_storage_name> — name of the network drive, can be viewed using the command multipath -ll.

• VMFS (VMware File System) is a cluster file system used by VMware ESXi to store virtual machine files. It supports shared storage access by multiple ESXi hosts. VMFS automatically manages locks, preventing concurrent modification of virtual machine files to ensure data integrity. For details, see the VMware vSphere VMFS guide in the official VMware Storage documentation.