[dts] [PATCH v2] vhost-user live migration script and plan update
Qian Xu
qian.q.xu at intel.com
Fri Aug 5 10:53:45 CEST 2016
Update vhost-user live migration script based on testpmd as vhost
backend application and some minor changes.
1. Update the backend application from vhost-switch sample to testpmd since
some switch will block VLAN packets. The command line and the output check
has been updated according to testpmd application.
2. Remove VLAN tag in the traffic settings.
3. Check if the migration is failed or not.
4. Update the qemu monitor quit check part in qemu_kvm.py to avoid timeout
issue on new kernel(e.g: 4.6.4).
Update vhost-user live migration test plan and config file
1. Add more details about nfs settings.
2. Change the vhost-user backend application to testpmd and the launch
step.
3. Add more details about VM access, such as telnet, ssh, scp.
4. Add the qemu path setting in the config file.
---------------------
v2:
1. add the qemu-kvm.py change.
2. remove qemu path from the vhost-user live migration script and put it to config
file.
3. add the config file.
Signed-off-by: Qian Xu <qian.q.xu at intel.com>
diff --git a/conf/vhost_user_live_migration.cfg b/conf/vhost_user_live_migration.cfg
index 74e3b54..ddb8d52 100644
--- a/conf/vhost_user_live_migration.cfg
+++ b/conf/vhost_user_live_migration.cfg
@@ -98,8 +98,10 @@ cpu =
model=host,number=4,cpupin=5 6 7 8;
mem =
size=2048,hugepage=yes;
+qemu =
+ path=/home/qxu10/qemu-2.6.0/x86_64-softmmu/qemu-system-x86_64
disk =
- file=/home/vm-image/vm0.img;
+ file=/home/qxu10/img/vm1.img;
login =
user=root,password=tester;
qga =
@@ -110,11 +112,13 @@ serial_port =
enable=yes;
[backup]
cpu =
- model=host,number=4,cpupin=5 6 7 8;
+ model=host,number=4,cpupin=9 10 11 12;
mem =
size=2048,hugepage=yes;
+qemu =
+ path=/home/qxu10/qemu-2.6.0/x86_64-softmmu/qemu-system-x86_64
disk =
- file=/mnt/nfs/vm0.img;
+ file=/mnt/nfs/vm1.img;
login =
user=root,password=tester;
qga =
diff --git a/framework/qemu_kvm.py b/framework/qemu_kvm.py
index 96923e9..69082a3 100644
--- a/framework/qemu_kvm.py
+++ b/framework/qemu_kvm.py
@@ -1124,7 +1124,8 @@ class QEMUKvm(VirtBase):
# after quit command, qemu will exit
if 'quit' in cmd:
- out = self.host_session.send_expect('%s' % cmd, '# ')
+ self.host_session.send_command('%s' % cmd)
+ out = self.host_session.send_expect(' ', '#')
else:
out = self.host_session.send_expect('%s' % cmd, '(qemu)')
self.host_session.send_expect('^C', "# ")
diff --git a/test_plans/vhost_user_live_migration_test_plan.rst b/test_plans/vhost_user_live_migration_test_plan.rst
index 8d4b5c9..41053e9 100644
--- a/test_plans/vhost_user_live_migration_test_plan.rst
+++ b/test_plans/vhost_user_live_migration_test_plan.rst
@@ -33,122 +33,174 @@
==============================
DPDK vhost user live migration
==============================
-This feature is to make sure vhost user live migration works based on vhost-switch.
+This feature is to make sure vhost user live migration works based on testpmd.
Prerequisites
-------------
-Connect three ports to one switch, these three ports are from Host, Backup
-host and tester.
+HW setup
-Start nfs service and export nfs to backup host IP:
+1. Connect three ports to one switch, these three ports are from Host, Backup
+host and tester. Ensure the tester can send packets out, then host/backup server ports
+can receive these packets.
+2. Better to have 2 similar machine with the same OS.
+
+NFS configuration
+1. Make sure host nfsd module updated to v4 version(v2 not support file > 4G)
+
+2. Start nfs service and export nfs to backup host IP:
host# service rpcbind start
- host# service nfs start
- host# cat /etc/exports
+ host# service nfs-server start
+ host# service nfs-mountd start
+ host# systemctrl stop firewalld.service
+ host# vim /etc/exports
host# /home/vm-image backup-host-ip(rw,sync,no_root_squash)
+
+3. Mount host nfs folder on backup host:
+ backup# mount -t nfs -o nolock,vers=4 host-ip:/home/vm-image /mnt/nfs
-Make sure host nfsd module updated to v4 version(v2 not support file > 4G)
+On host server side:
-Create enough hugepages for vhost-switch and qemu backend memory.
+1. Create enough hugepages for vhost-switch and qemu backend memory.
host# echo 4096 > /sys/kernel/mm/hugepages/hugepages-2048kB/nr_hugepages
host# mount -t hugetlbfs hugetlbfs /mnt/huge
-Bind host port to igb_uio and start vhost switch:
- host# vhost-switch -c f -n 4 --socket-mem 1024 -- -p 0x1
-
-Start host qemu process:
- host# qemu-system-x86_64 -name host -enable-kvm -m 2048 \
- -drive file=/home/vm-image/vm0.img,format=raw \
- -serial telnet:localhost:5556,server,nowait \
- -cpu host -smp 4 \
- -net nic,model=e1000 \
- -net user,hostfwd=tcp:127.0.0.1:5555-:22 \
- -chardev socket,id=char1,path=/root/dpdk_org/vhost-net \
- -netdev type=vhost-user,id=mynet1,chardev=char1,vhostforce \
- -device virtio-net-pci,mac=00:00:00:00:00:01,netdev=mynet1 \
- -object memory-backend-file,id=mem,size=2048M,mem-path=/mnt/huge,share=on \
- -numa node,memdev=mem -mem-prealloc \
- -monitor unix:/tmp/host.sock,server,nowait \
- -daemonize
-
-Wait for virtual machine start up and up virtIO interface:
- host-vm# ifconfig eth1 up
-
-Check vhost-switch connected and send packet with mac+vlan can received by
-virtIO interface in VM:
- VHOST_DATA: (0) mac 00:00:00:00:00:01 and vlan 1000 registered
-
-Mount host nfs folder on backup host:
- backup# mount -t nfs -o nolock,vers=4 host-ip:/home/vm-image /mnt/nfs
-
-Create enough hugepages for vhost-switch and qemu backend memory.
- backup# echo 4096 > /sys/kernel/mm/hugepages/hugepages-2048kB/nr_hugepages
- backup# mount -t hugetlbfs hugetlbfs /mnt/huge
-
-Bind backup host port to igb_uio and start vhost switch:
- backup# vhost-switch -c f -n 4 --socket-mem 1024 -- -p 0x1
-
-Start backup host qemu with additional parameter:
- -incoming tcp:0:4444
-
-Test Case 1: migrate with kernel driver
-=======================================
+2. Bind host port to igb_uio and start testpmd with vhost port:
+ #./tools/dpdk-devbind.py -b igb_uio 83:00.1
+ #./x86_64-native-linuxapp-gcc/app/testpmd -c 0xc0000 -n 4 --vdev 'eth_vhost0,iface=./vhost-net,queues=1' --socket-mem 1024,1024 -- -i
+ testpmd>start
+
+3. Start VM on host, here we set 5432 as the serial port, 3333 as the qemu monitor port, 5555 as the SSH port.
+ taskset -c 22-23 /home/qxu10/qemu-2.6.0/x86_64-softmmu/qemu-system-x86_64 -name vm1host \
+ -enable-kvm -m 2048 -object memory-backend-file,id=mem,size=2048M,mem-path=/mnt/huge,share=on \
+ -numa node,memdev=mem -mem-prealloc -smp 2 -cpu host -drive file=/home/qxu10/img/vm1.img \
+ -net nic,model=e1000,addr=1f -net user,hostfwd=tcp:127.0.0.1:5555-:22 \
+ -chardev socket,id=char0,path=./vhost-net \
+ -netdev type=vhost-user,id=netdev0,chardev=char0,vhostforce \
+ -device virtio-net-pci,netdev=netdev0,mac=52:54:00:00:00:01 \
+ -monitor telnet::3333,server,nowait \
+ -serial telnet:localhost:5432,server,nowait \
+ -daemonize
+
+On the backup server, run the vhost testpmd on the host and launch VM:
+
+4. Set huge page, bind one port to igb_uio and run testpmd on the backup server, the command is very similar to host:
+ backup server# echo 4096 > /sys/kernel/mm/hugepages/hugepages-2048kB/nr_hugepages
+ backup server# mount -t hugetlbfs hugetlbfs /mnt/huge
+ backup server#./tools/dpdk-devbind.py -b igb_uio 81:00.1
+ backup server#./x86_64-native-linuxapp-gcc/app/testpmd -c 0xc0000 -n 4 --vdev 'eth_vhost0,iface=./vhost-net,queues=1' --socket-mem 1024,1024 -- -i
+ testpmd>start
+
+5. Launch VM on the backup server, and the script is similar to host, but note the 2 differences:
+ 1. need add " -incoming tcp:0:4444 " for live migration.
+ 2. need make sure the VM image is the NFS mounted folder, VM image is the exact one on host server.
+
+ Backup server #
+ /home/qxu10/qemu-2.6.0/x86_64-softmmu/qemu-system-x86_64 -name vm2 \
+ -enable-kvm -m 2048 -object memory-backend-file,id=mem,size=2048M,mem-path=/mnt/huge,share=on \
+ -numa node,memdev=mem -mem-prealloc -smp 4 -cpu host -drive file=/mnt/nfs/vm1.img \
+ -net nic,model=e1000,addr=1f -net user,hostfwd=tcp:127.0.0.1:5555-:22 \
+ -chardev socket,id=char0,path=./vhost-net \
+ -netdev type=vhost-user,id=netdev0,chardev=char0,vhostforce \
+ -device virtio-net-pci,netdev=netdev0,mac=52:54:00:00:00:01 \
+ -monitor telnet::3333,server,nowait \
+ -serial telnet:localhost:5432,server,nowait \
+ -incoming tcp:0:4444 \
+ -daemonize
+
+
+Test Case 1: migrate with virtio-pmd
+====================================
Make sure all Prerequisites has been done
-1. Login into host virtual machine and capture incoming packets.
- host# telnet localhost 5556
- host vm# ifconfig eth1 up
-2. Send continous packets with mac(00:00:00:00:00:01) and vlan(1000)
+6. SSH to VM and scp the DPDK folder from host to VM:
+ host # ssh -p 5555 localhost, then input password to log in.
+ host # scp -P 5555 -r <dpdk_folder>/ localhost:/root, then input password to let the file transfer.
+
+7. Telnet the serial port and run testpmd in VM:
+
+ host # telnet localhost 5432
+ Input Enter, then log in to VM
+ If need leave the session, input "CTRL" + "]", then quit the telnet session.
+ On the Host server VM, run below commands to launch testpmd
+ host vm #
+ cd /root/dpdk
+ modprobe uio
+ insmod ./x86_64-native-linuxapp-gcc/kmod/igb_uio.ko
+ ./tools/dpdk_nic_bind.py --bind=igb_uio 00:03.0
+ echo 1024 > /sys/kernel/mm/hugepages/hugepages-2048kB/nr_hugepages
+ ./x86_64-native-linuxapp-gcc/app/testpmd -c 0x3 -n 4 -- -i
+ >set fwd rxonly
+ >set verbose 1
+ >start tx_first
+
+8. Check host vhost pmd connect with VM’s virtio device:
+ testpmd> host testpmd message for connection
+
+9. Send continuous packets with the physical port's mac(e.g: 90:E2:BA:69:C9:C9)
from tester port:
tester# scapy
- tester# p = Ether(dst="00:00:00:00:00:01")/Dot1Q(vlan=1000)/IP()/UDP()/
+ tester# p = Ether(dst="90:E2:BA:69:C9:C9")/IP()/UDP()/
Raw('x'*20)
tester# sendp(p, iface="p5p1", inter=1, loop=1)
-
-3. Check packet normally recevied by virtIO interface
- host vm# tcpdump -i eth1 -xxx
-
-4. Connect to qemu monitor session and start migration
- host# nc -U /tmp/host.sock
- host# (qemu)migrate -d tcp:backup host ip:4444
-
-5. Check host vm can receive packet before migration done
-
-6. Query stats of migrate in monitor, check status of migration
+
+ Then check the host VM can receive the packet:
+ host VM# testpmd> port 0/queue 0: received 1 packets
+
+10. Start Live migration, ensure the traffic is continuous at the HOST VM side:
+ host server # telnet localhost 3333
+ (qemu)migrate -d tcp:backup server:4444
+ e.g: migrate -d tcp:10.239.129.176:4444
+ (qemu)info migrate
+ Check if the migrate is active and not failed.
+
+11. Check host vm can receive packet before migration done
+
+12. Query stats of migrate in monitor, check status of migration, when the status is completed, then the migration is done.
host# (qemu)info migrate
- host# after finished:
-
-7. After migartion done, login into backup vm and re-enable virtIO interface
- backup vm# ifconfig eth1 down
- backup vm# ifconfig eth1 up
-
-8. Check backup host reconnected and packet normally recevied
-
-Test Case 2: migrate with dpdk
-==============================
-Make sure all Prerequisites has been done
-1. Send continous packets with mac(00:00:00:00:00:01) and vlan(1000)
+ host# (qemu)
+ Migration status: completed
+
+13. After live migration, go to the backup server and check if the virtio-pmd can continue to receive packets.
+ Backup server # telnet localhost 5432
+ log in then see the same screen from the host server, and check if the virtio-pmd can continue receive the packets.
+
+Test Case 2: migrate with virtio-net
+====================================
+Make sure all Prerequisites has been done.
+6. Telnet the serial port and run testpmd in VM:
+
+ host # telnet localhost 5432
+ Input Enter, then log in to VM
+ If need leave the session, input "CTRL" + "]", then quit the telnet session.
+
+7. Let the virtio-net link up:
+ host vm # ifconfig eth1 up
+
+8. Send continuous packets with the physical port's mac(e.g: 90:E2:BA:69:C9:C9)
+ from tester port:
tester# scapy
- tester# p = Ether(dst="00:00:00:00:00:01")/Dot1Q(vlan=1000)/IP()/UDP()/
+ tester# p = Ether(dst="90:E2:BA:69:C9:C9")/IP()/UDP()/
Raw('x'*20)
tester# sendp(p, iface="p5p1", inter=1, loop=1)
-
-2. bind virtIO interface to igb_uio and start testpmd
- host vm# testpmd -c 0x7 -n 4
-
-3. Check packet normally recevied by testpmd:
- host vm# testpmd> set fwd rxonly
- host vm# testpmd> set verbose 1
- host vm# testpmd> port 0/queue 0: received 1 packets
-
-4. Connect to qemu monitor session and start migration
- host# nc -U /tmp/host.sock
- host# (qemu)migrate -d tcp:backup host ip:4444
-
-5. Check host vm can receive packet before migration done
-
-6. Query stats of migrate in monitor, check status of migration
+
+9. Check the host VM can receive the packet:
+ host VM# tcpdump -i eth1
+
+10. Start Live migration, ensure the traffic is continuous at the HOST VM side:
+ host server # telnet localhost 3333
+ (qemu)migrate -d tcp:backup server:4444
+ e.g: migrate -d tcp:10.239.129.176:4444
+ (qemu)info migrate
+ Check if the migrate is active and not failed.
+
+11. Check host vm can receive packet before migration done
+
+12. Query stats of migrate in monitor, check status of migration, when the status is completed, then the migration is done.
host# (qemu)info migrate
- host# after finished:
+ host# (qemu)
+ Migration status: completed
+
+13. After live migration, go to the backup server and check if the virtio-pmd can continue to receive packets.
+ Backup server # telnet localhost 5432
+ log in then see the same screen from the host server, and check if the virtio-net can continue receive the packets.
-7. After migartion done, login into backup vm and check packets recevied
- backup vm# testpmd> port 0/queue 0: received 1 packets
\ No newline at end of file
diff --git a/tests/TestSuite_vhost_user_live_migration.py b/tests/TestSuite_vhost_user_live_migration.py
index 95e2fb3..d4da38c 100644
--- a/tests/TestSuite_vhost_user_live_migration.py
+++ b/tests/TestSuite_vhost_user_live_migration.py
@@ -33,19 +33,11 @@ class TestVhostUserLiveMigration(TestCase):
self.backup_tport = self.tester.get_local_port_bydut(self.backup_port, self.backup_dutip)
self.backup_tintf = self.tester.get_interface(self.backup_tport)
- # build backup vhost-switch
- out = self.duts[0].send_expect("make -C examples/vhost", "# ")
- self.verify("Error" not in out, "compilation error 1")
- self.verify("No such file" not in out, "compilation error 2")
-
- # build backup vhost-switch
- out = self.duts[1].send_expect("make -C examples/vhost", "# ")
- self.verify("Error" not in out, "compilation error 1")
- self.verify("No such file" not in out, "compilation error 2")
-
- self.vhost = "./examples/vhost/build/app/vhost-switch"
+ # Use testpmd as vhost-user application on host/backup server
+ self.vhost = "./x86_64-native-linuxapp-gcc/app/testpmd"
self.vm_testpmd = "./%s/app/testpmd -c 0x3 -n 4 -- -i" % self.target
- self.virio_mac = "00:00:00:00:00:01"
+ self.virio_mac = "52:54:00:00:00:01"
+
# flag for environment
self.env_done = False
@@ -86,14 +78,15 @@ class TestVhostUserLiveMigration(TestCase):
if self.env_done:
return
- # start vhost-switch on host and backup machines
+ # start vhost application on host and backup machines
self.logger.info("Start vhost on host and backup host")
for crb in self.duts[:2]:
self.bind_nic_driver(crb, [crb.get_ports()[0]], driver="igb_uio")
- # start vhost-switch, predict hugepage on both sockets
+ # start vhost app: testpmd, predict hugepage on both sockets
base_dir = crb.base_dir.replace('~', '/root')
crb.send_expect("rm -f %s/vhost-net" % base_dir, "# ")
- crb.send_expect("%s -c f -n 4 --socket-mem 1024 -- -p 0x1" % self.vhost, "bind to vhost-net")
+ crb.send_expect("%s -c f -n 4 --socket-mem 512,512 --vdev 'eth_vhost0,iface=./vhost-net,queues=1' -- -i" % self.vhost, "testpmd> ",60)
+ crb.send_expect("start", "testpmd> ")
try:
# set up host virtual machine
@@ -156,7 +149,7 @@ class TestVhostUserLiveMigration(TestCase):
if self.backup_serial is not None and self.backup_vm is not None:
self.backup_vm.close_serial_port()
- self.logger.info("Stop virtual machine on host")
+
if getattr(self, 'vm_host', None):
if self.vm_host is not None:
self.host_vm.stop()
@@ -176,7 +169,7 @@ class TestVhostUserLiveMigration(TestCase):
self.backup_vm.stop()
self.backup_vm = None
- # after vm stopped, stop vhost-switch
+ # after vm stopped, stop vhost testpmd
for crb in self.duts[:2]:
crb.kill_all()
@@ -189,7 +182,7 @@ class TestVhostUserLiveMigration(TestCase):
"""
send packet from tester
"""
- sendp_fmt = "sendp([Ether(dst='%(DMAC)s')/Dot1Q(vlan=1000)/IP()/UDP()/Raw('x'*18)], iface='%(INTF)s', count=%(COUNT)d)"
+ sendp_fmt = "sendp([Ether(dst='%(DMAC)s')/IP()/UDP()/Raw('x'*18)], iface='%(INTF)s', count=%(COUNT)d)"
sendp_cmd = sendp_fmt % {'DMAC': self.virio_mac, 'INTF': intf, 'COUNT': number}
self.tester.scapy_append(sendp_cmd)
self.tester.scapy_execute()
@@ -216,8 +209,8 @@ class TestVhostUserLiveMigration(TestCase):
else:
num_received = 0
- self.verify(num_received >= num_pkts, "Not receive packets as expected!!!")
self.logger.info("Verified %s packets recevied" % num_received)
+ self.verify(num_received >= num_pkts, "Not receive packets as expected!!!")
def verify_kernel(self, tester_port, vm_dut):
"""
@@ -240,8 +233,8 @@ class TestVhostUserLiveMigration(TestCase):
out = vm_dut.get_session_output(timeout=1)
vm_dut.send_expect("^C", "# ")
num = out.count('UDP')
- self.verify(num == num_pkts, "Not receive packets as expected!!!")
self.logger.info("Verified %s packets recevied" % num_pkts)
+ self.verify(num == num_pkts, "Not receive packets as expected!!!")
def test_migrate_with_kernel(self):
"""
@@ -255,7 +248,8 @@ class TestVhostUserLiveMigration(TestCase):
self.logger.info("Migrate host VM to backup host")
# start live migration
- self.host_vm.start_migration(self.backup_dutip, self.backup_vm.migrate_port)
+ ret = self.host_vm.start_migration(self.backup_dutip, self.backup_vm.migrate_port)
+ self.verify(ret, "Failed to migration, please check VM and qemu version")
# make sure still can receive packets in migration process
self.verify_kernel(self.host_tport, self.vm_host)
@@ -264,13 +258,13 @@ class TestVhostUserLiveMigration(TestCase):
# wait live migration done
self.host_vm.wait_migration_done()
- # check vhost-switch log after migration
+ # check vhost testpmd log after migration
out = self.duts[0].get_session_output(timeout=1)
- self.verify("device has been removed" in out, "Device not removed for host")
+ self.verify("closed" in out, "Vhost Connection NOT closed on host")
out = self.duts[1].get_session_output(timeout=1)
- self.verify("virtio is now ready" in out, "Device not ready on backup host")
+ self.verify("established" in out, "Device not ready on backup host")
- self.logger.info("Migration process done, init backup VM")
+ self.logger.info("Migration process done, then go to backup VM")
# connected backup VM
self.vm_backup = self.backup_vm.migrated_start()
@@ -291,8 +285,10 @@ class TestVhostUserLiveMigration(TestCase):
self.logger.info("Migrate host VM to backup host")
# start live migration
- self.host_vm.start_migration(self.backup_dutip, self.backup_vm.migrate_port)
-
+
+ ret = self.host_vm.start_migration(self.backup_dutip, self.backup_vm.migrate_port)
+ self.verify(ret, "Failed to migration, please check VM and qemu version")
+
# make sure still can receive packets in migration process
self.verify_dpdk(self.host_tport, self.host_serial)
@@ -300,13 +296,13 @@ class TestVhostUserLiveMigration(TestCase):
# wait live migration done
self.host_vm.wait_migration_done()
- # check vhost-switch log after migration
+ # check vhost testpmd log after migration
out = self.duts[0].get_session_output(timeout=1)
- self.verify("device has been removed" in out, "Device not removed for host")
+ self.verify("closed" in out, "Vhost Connection NOT closed on host")
out = self.duts[1].get_session_output(timeout=1)
- self.verify("virtio is now ready" in out, "Device not ready on backup host")
+ self.verify("established" in out, "Device not ready on backup host")
- self.logger.info("Migration process done, init backup VM")
+ self.logger.info("Migration process done, then go to backup VM")
time.sleep(5)
# make sure still can receive packets
--
2.5.5
More information about the dts
mailing list