Install the NSX Manager Unified Appliance for Enterprise PKS

Page last updated:

This topic provides instructions for installing the NSX Manager VM on vSphere for use with Enterprise PKS.

Prerequisites

Make sure you have completed the Prerequisites for Installing NSX-T for Enterprise PKS.

About the NSX Manager Appliance

The NSX-T Manager VM is provided as an OVA file named the NSX Unified Appliance that you import into your vSphere environment and configure.

For more information, see Install the NSX Manager Unified Appliance in the NSX-T Data Center documentation. See also NSX Manager VM System Requirements.

About the NSX Manager UI

The NSX-T Manager provides the user interface and API for NSX-T Data Center. There are two options to interact with NSX-T Manager:

  1. Simplified UI/API

    • Declarative interface that uses the Declarative API/Data Model (Policy API).
    • The NSX-T Container Plugin (NCP) that is embedded in the Enterprise PKS tile does not support the Policy API.
    • You cannot use the Simplified UI/API to manage NSX-T for use with Enterprise PKS upgrades and new installations.
  2. Advanced UI/API

    • Legacy imperative interface based on the NSX Management API.
    • Provides the user interface to address Enterprise PKS installation and upgrade use cases. Currently NCP only supports the Management API.
    • Will be deprecated over time; all features and use cases will eventually be transfered to the Simplified UI/API.

Enterprise PKS does not support the Simplified UI/API. For Enterprise PKS, you must use the Advanced Networking and Security tab to create, read, update, and delete required network objects. For NSX-T host preparation and configuration, such as deploying NSX-T Managers and Edge Nodes, use the System tab.

NSX-T v2.4 User Interface

Install and Configure the NSX Manager Appliance

Complete the following procedure to deploy the NSX Manager appliance.

  1. Locate the NSX-T Data Center OVA file (nsx-unified-appliance-VERSION.ova) on the VMware download portal and download it to your local machine.

  2. Log in to vCenter using the vSphere Client.

  3. Create a Resource Pool for NSX-T infrastructure, such as infra.

  4. In the vSphere Client, select the Resource Pool where you want to install NSX-T Data Center.

  5. Right-click and select Deploy OVF Template to start the installation wizard.

  6. At the Select an OVF template screen:

    • Select the Local file option
    • Click Choose Files
    • Navigate to where you downloaded the OVA file and select it
    • Click Next
  7. At the Select a name and folder screen:

    • Enter a name for the NSX Manager VM, such as nsx-manager-1
    • Select the Datacenter for the VM deployment
    • Click Next
  8. At the Select a compute resource screen:

    • Select the Resource Pool where the NSX Manager VM will be deployed
    • Click Next
  9. At the Review details screen:

    • Verify the OVF template details
    • Click Next
  10. At the Configuration screen:

    • Select either the Medium size VM or the Large size VM
    • Click Next
  11. At the Select storage screen:

    • Select the vsanDatastore if you are using vSAN, or a dedicated datastore if you are not
    • Click Next
  12. At the Select networks screen:

    • Select Destination Network for the NSX Manager VM
    • Click Next
  13. At the Customize Template screen, configure the following settings:

    • System Root User Password (must comply with password strength restrictions)
    • CLI “admin” User Password (must comply with password strength restrictions)
    • CLI “audit” User Password (must comply with password strength restrictions)
    • Hostname: Enter the hostname for the NSX Manager VM, such as nsx-manager-1
    • Default IPv4 Gateway: Enter the default gateway IPv4 address for the NSX Manager VM
    • Management Network IPv4 Address: Enter the IPv4 address for the first network interface
    • Management Network Netmask: Enter the netmask for the first network interface
    • DNS Server List: Enter one or more DNS servers (space-separated if multiple)
    • NTP Server List: One or more NTP servers (space-separated if multiple)
    • Enable SSH: Select Enable SSH (by default this option is disabled for security reasons)
    • Allow root SSH logins: Enable this option (by default this option is disabled for security reasons)
    • Click Next
  14. At the Ready to complete screen:

    • Verify that the OVF template specification is accurate
    • Click Finish to begin the installation. It will taker approximately 10 minutes to complete.
  15. Expand the Recent Tasks panel at the bottom of the vCenter screen to view the progress of the OVA deployment

Verify NSX-T Manager Installation

See Verify NSX-T VM Deployment for Enterprise PKS.

Next Step

See Deploy Two Additional NSX Manager Nodes and Form an NSX-T Management Cluster.

Installation Instructions

See Installing and Configuring NSX-T for Enterprise PKS.


Please send any feedback you have to pks-feedback@pivotal.io.