Preparing the CentOS Host to Install vMX
To prepare the host system running CentOS for installing vMX:
- Meet the minimum software and OS requirements described in Minimum Software Requirements for CentOS.
- Enable hyperthreading and VT-d in BIOS.
If you are using SR-IOV, enable SR-IOV in BIOS.
We recommend that you verify the process with the vendor because different systems have different methods to access and change BIOS settings.
- During the OS installation, select the Virtualization
Host and Virtualization Platform software collections.
If you did not select these software collections during the GUI installation, use the following commands to install them:yum groupinstall "virtualization host"yum groupinstall "virtualization platform"
- Enable the appropriate repositories.yum install -y "http://www.elrepo.org/elrepo-release-7.0-2.el7.elrepo.noarch.rpm"yum install centos-release-scl
- Update currently installed packages.yum upgrade
- Install the required packages.yum install python27-python-pip python27-python-devel numactl-libs libpciaccess-devel parted-devel yajl-devel libxml2-devel glib2-devel libnl-devel libxslt-devel libyaml-devel numactl-devel redhat-lsb kmod-ixgbe libvirt-daemon-kvm numactl telnet net-tools
- (Optional) If you are using SR-IOV, you must install these
packages and enable SR-IOV capability.yum install kernel-devel gccgrubby --args="intel_iommu=on" --update-kernel=ALL
Reboot and log in again.
- Link the
qemu-kvmbinary to the
qemu-system-x86_64file.ln -s /usr/libexec/qemu-kvm /usr/bin/qemu-system-x86_64
- Set up the path for the correct Python release and install
the PyYAML library.PATH=/opt/rh/python27/root/usr/bin:$PATHexport PATHpip install netifaces pyyaml
In case of error with installation, use the following workaround:# yum install python27-python-pip# scl enable python27 bash# source scl_source enable python27# export LD_LIBRARY_PATH=/opt/rh/python27/root/usr/lib64# pip install -upgrade pip# pip install netifaces pyyaml
- Stop and disable Network Manager.systemctl disable NetworkManagersystemctl stop NetworkManager
If you cannot stop Network Manager, you can prevent
resolv.conffrom being overwritten with the chattr +I /etc/resolv.conf command.
- Ensure that the build directory is readable by the QEMU
user.chmod -R o+r,o+x build-directory-pathname
As an alternative, you can configure QEMU to run as the root user by setting the
/etc/libvirt/qemu.conffile to user=root.
- Add this line to the end of the
You can now install vMX.
When you install vMX with the sh vmx.sh -lv --install command, you might see a kernel version mismatch warning. You can ignore this warning.