NSX Manager can be installed as a virtual appliance on a KVM host.
The QCOW2 installation procedure uses guestfish, a Linux command-line tool to write virtual machine settings into the QCOW2 file.
- Download the NSX Manager QCOW2 image and then copy it to the KVM machine that will run the NSX Manager using SCP or sync.
- (Ubuntu only) Add the currently logged in user as a libvirtd user:
adduser $USER libvirtd
- In the same directory where you saved the QCOW2 image, create a file called guestinfo (with no file extension) and populate it with the NSX Manager VM's properties.
<?xml version="1.0" encoding="UTF-8"?> <Environment xmlns="http://schemas.dmtf.org/ovf/environment/1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:oe="http://schemas.dmtf.org/ovf/environment/1"> <PropertySection> <Property oe:key="nsx_role" oe:value="nsx-manager"/> <Property oe:key="nsx_allowSSHRootLogin" oe:value="True"/> <Property oe:key="nsx_cli_passwd_0" oe:value="<password>"/> <Property oe:key="nsx_dns1_0" oe:value="192.168.110.10"/> <Property oe:key="nsx_domain_0" oe:value="corp.local"/> <Property oe:key="nsx_gateway_0" oe:value="192.168.110.1"/> <Property oe:key="nsx_hostname" oe:value="nsx-manager1"/> <Property oe:key="nsx_ip_0" oe:value="192.168.110.19"/> <Property oe:key="nsx_isSSHEnabled" oe:value="True"/> <Property oe:key="nsx_netmask_0" oe:value="255.255.255.0"/> <Property oe:key="nsx_ntp_0" oe:value="192.168.110.10"/> <Property oe:key="nsx_passwd_0" oe:value="<password>"/> </PropertySection> </Environment>
In the example, nsx_isSSHEnabled and nsx_allowSSHRootLogin are both enabled. When they are disabled, you cannot SSH or log in to the NSX Manager command line. If you enable nsx_isSSHEnabled but not nsx_allowSSHRootLogin, you can SSH to NSX Manager but you cannot log in as root.
- Use guestfish to write the guestinfo file into the QCOW2 image.
After the guestinfo information is written into a QCOW2 image, the information cannot be overwritten.
sudo guestfish --rw -i -a nsx-manager1-build.qcow2 upload guestinfo /config/guestinfo
- Deploy the QCOW2 image with the virt-install command.
user@ubuntu1604:/var/lib/libvirt/images$ sudo virt-install --import --name nsx-manager1 --ram 16348 --vcpus 4 --network=bridge:br0,model=e1000 --disk path=/var/lib/libvirt/images/nsx-manager-188.8.131.52.0.4446302.qcow2,format=qcow2 --nographics Starting install... Creating domain... | 0 B 00:01 Connected to domain nsx-manager1 Escape character is ^] nsx-manager1 login:
After the NSX Manager boots up, the NSX Manager console appears.
- (Optional) For optimal performance, reserve memory for the NSX-T Data Center component.
A memory reservation is a guaranteed lower bound on the amount of physical memory that the host reserves for a virtual machine, even when memory is overcommitted. Set the reservation to a level that ensures the NSX-T Data Center component has sufficient memory to run efficiently. See System Requirements.
- Open the console of the NSX-T Data Center component to track the boot process.
- After the NSX-T Data Center component boots, log in to the CLI as admin and run the get interface eth0 command to verify that the IP address was applied as expected.
nsx-component> get interface eth0 Interface: eth0 Address: 192.168.110.25/24 MAC address: 00:50:56:86:7b:1b MTU: 1500 Default gateway: 192.168.110.1 Broadcast address: 192.168.110.255 ...
- Verify that your NSX-T Data Center component has the required connectivity.
Make sure that you can perform the following tasks.
Ping your NSX-T Data Center component from another machine.
The NSX-T Data Center component can ping its default gateway.
The NSX-T Data Center component can ping the hypervisor hosts that are in the same network as the NSX-T Data Center component using the management interface.
The NSX-T Data Center component can ping its DNS server and its NTP server.
If you enabled SSH, make sure that you can SSH to your NSX-T Data Center component.
If connectivity is not established, make sure the network adapter of the virtual appliance is in the proper network or VLAN.
- Exit the KVM console.
What to do next
Connect to the NSX Manager GUI by from a supported web browser.
The URL is https://<IP address of NSX Manager>. For example, https://10.16.176.10.
You must use HTTPS. HTTP is not supported.