To install NSX Tools on your Linux workload VMs, follow these instructions.

See Currently Supported Operating Systems for Workload VMs for a list of Linux distributions currently supported.

Note: To verify the checksum of this script, go to VMware Downloads > Drivers & Tools > NSX Cloud Scripts.

Prerequisites

You need the following commands to run the NSX Tools installation script:

  • wget
  • nslookup
  • dmidecode

Procedure

  1. Log in to CSM and go to your public cloud:
    1. If using AWS, go to Clouds > AWS > VPCs. Click a Transit or Compute VPC.
    2. If using Microsoft Azure, go to Clouds > Azure > VNets. Click the VNet on which one or a pair of PCGs is deployed and running.
    Note: Transit VPC/VNet is where one or a pair of PCGs is deployed and running. Compute VPC/VNet is the one linked to a Transit and can use the PCG instances deployed there.
  2. From the NSX Tools Download & Installation section of the screen, make a note of the Download Location and the Installation Command under Linux.
    Note: For VNets, the DNS Suffix in the Installation Command is dynamically generated to match the DNS settings you select when deploying PCG. For Transit VNets, the -dnsServer <dns-server-ip> parameter is optional. For Compute VNets, you must provide the DNS Forwarder IP address to complete this command.
  3. Log in to the Linux workload VM with superuser privileges.
  4. Use wget or equivalent to download the installation script on your Linux VM from the Download Location you noted from CSM. The installation script is downloaded in the directory where you run the wget command.
    Note: To verify the checksum of this script, go to VMware Downloads > Drivers & Tools > NSX Cloud Scripts.
  5. Change permissions on the installation script to make it executable if necessary, and run it: 
    $ chmod +x install_nsx_vm_agent.sh && sudo ./install_nsx_vm_agent.sh
    Note: On Red Hat Enterprise Linux and its derivatives, SELinux is not supported. To install NSX Tools, disable SELinux.
  6. You lose connectivity with your Linux VM after installation of NSX Tools begins. Messages such as the following appear on your screen: Installation completed!!! Starting NSX Agent service. SSH connection will now be lost.. To complete the onboarding process, log in to your VM again.

Results

NSX Tools are installed on your workload VM.

Note:
  • After NSX Tools are successfully installed, port 8888 shows as open on the workload VM but it is blocked for VMs in the underlay mode and must be used only when required for advanced troubleshooting. You can access workload VMs over port 8888 using a jumphost if the jumphost is also in the same VPC as the workload VMs that you want to access.
  • The script uses eth0 as the default interface.

What to do next

Managing VMs in the NSX Enforced Mode