Deploying Ops Manager with NSX-T for Tanzu Kubernetes Grid Integrated Edition

Note: As of v1.8, Enterprise PKS has been renamed to VMware Tanzu Kubernetes Grid Integrated Edition. Some screenshots in this documentation do not yet reflect the change.

Page last updated:

This topic provides instructions for deploying Ops Manager on VMware vSphere with NSX-T integration for use with VMware Tanzu Kubernetes Grid Integrated Edition.

Prerequisites

Before deploying Ops Manager with NSX-T for Tanzu Kubernetes Grid Integrated Edition, you must have completed the following tasks:

In addition, review the supported Ops Manager versions for Tanzu Kubernetes Grid Integrated Edition. See VMware Tanzu Network.

Review the known issues for your version of Ops Manager. See one of the following:

Step 1: Generate SSH Key Pair

You cannot deploy Ops Manager without adding a public SSH key in the appropriate field of the Customize Template screen. If you do not add a public SSH key, Ops Manager shuts down automatically because it cannot find a key and may enter a reboot loop. For more information, see Passwords Not Supported for Ops Manager VM on vSphere in the Ops Manager v2.6 release notes.

For instructions on generating the required SSH key pair for installing Ops Manager, refer to the following KB article: Generate an SSH key pair for installing Ops Manager v2.6 on vSphere.

When you add the key value to the Public SSH Key field, you must enter the entire public key similar to the format required for authorized_keys. For example, the format required is similar to the following:

ssh-rsa AAAAB3NzaC1yc2EAAAABJQAAAQEAnZBapWsER/EO1hLYvV/rkZe78mUBueZGHx1kw+ByfNbLoA385Cm72L+6qq40yOIH6R42nHN/bynbeHOD4Ptes4/s2lrLJtTzEWgH9XYnId4sE5f+QTFd2kRtTzZcu8WvFudEIyCIWjO+o9yvPETs05dEl/3KDn+t9uXxiszrG9Ycb2uNNpmDES+ohm9BQQFmpwFnao+UuQbRXLCcQ3SoE3Ai5Z9O+3PBwm0IByx87/dUuqvVISAJ8yGu2hJobx9PPStFERtUsfx5x+WIu9XIkrl5tzxgH9hBDsOS9cVUYJ7kKUUf1yyro6ocHyu6TWHJHSJLt8Z2FULxMPpqdn+8Xw== my-key

Step 2: Deploy Ops Manager for Tanzu Kubernetes Grid Integrated Edition

  1. Before starting, refer to the Tanzu Kubernetes Grid Integrated Edition Release Notes for supported Ops Manager versions for Tanzu Kubernetes Grid Integrated Edition.
  2. Before starting, refer to the known issues in the Ops Manager Release v2.7 Release Notes or the Ops Manager Release v2.8 Release Notes.
  3. Download the Ops Manager for vSphere installation file from the VMware Tanzu Network.

    1. Open a browser to the Ops Manager download page on the VMware Tanzu Network.
    2. Use the dropdown menu to select the supported Ops Manager release.
    3. Select the Ops Manager for vSphere download option. This downloads the Ops Manager for vSphere VM template as an OVA file.
  4. Log into vCenter using the vSphere Client (HTML5) to deploy the Ops Manager OVA.

  5. Select the Resource Pool defined for the Tanzu Kubernetes Grid Integrated Edition Management Plane. See Create Management Plane in Installing and Configuring NSX-T Data Center v3.0 for TKGI if you have not defined the Tanzu Kubernetes Grid Integrated Edition Management Resource Pool.

  6. Right click the Tanzu Kubernetes Grid Integrated Edition Management Plane Resource Pool and select Deploy OVF Template.

  7. At the Select an OVF template screen:

    • Click Browse.
    • Select the Ops Manager OVA file you downloaded and click Open.
    • Click Next. Om install 001
  8. At the Select Name and folder screen, enter a name for the Ops Manager VM (or use the default name), select the Datacenter, and click Next Om install 002

  9. At the Select a compute resource screen, select the Tanzu Kubernetes Grid Integrated Edition Resource Pool or Cluster object and click Next. Om install 003

  10. At the Review details screen, confirm the configuration up to this point and click Next. Om install 004

  11. At the Select Storage screen, select the desired Datastore, and click Next. Om install 005

    Warning: Ops Manager requires a Director VM with at least 8 GB memory. For more information, see Provisioning a Virtual Disk in vSphere.

  12. At the Select Networks screen:

    • If you are using vSphere 6.7, select the Tanzu Kubernetes Grid Integrated Edition Management T1 Logical Switch that you defined when Create Management Plane in Installing and Configuring NSX-T Data Center v3.0 for TKGI , and click Next. Om install 006
    • If you are using vSphere 6.5, see Network Selection for vSphere v6.5.
  13. At the Customize template screen, enter the following information, and click Next.

    • IP Address: The IP address of the Ops Manager network interface, for example 10.0.0.2 (assuming non-routable NAT-mode).
    • Netmask: The network mask for Ops Manager, for example, 255.255.255.0.
    • Default Gateway: The default gateway for Ops Manager to use, for example 10.0.0.1 (assuming non-routable NAT-mode).
    • DNS: One or more DNS servers for the Ops Manager VM to use, for example 10.14.7.1.
    • NTP Servers: The IP address of one or more NTP servers for Ops Manager, for example 10.113.60.176.
    • Public SSH Key: (Required) Enter the public SSH key to allow SSH access to the Ops Manager VM. You must enter the entire the public SSH key in the expected format. See Step 1: Generate SSH Key Pair.
    • Custom hostname: The hostname for the Ops Manager VM, for example ops-manager. Om install 007a Om install 007b
  14. At the Ready to complete screen, review the configuration settings and click Finish. This action begins the OVA import and deployment process. Om install 008

  15. Use the Recent Tasks panel at the bottom of the vCenter dashboard to check the progress of the OVA import and deployment. If the import or deployment is unsuccessful, check the configuration for errors. Om install 100

  16. Right-click the Ops Manager VM and click Power On. Om install 009

Network Selection for vSphere v6.5

With VMware vCenter Server 6.5, when initially deploying the Ops Manager OVA, you cannot connect to an NSX-T logical switch. You must first connect to a vSphere Standard (vSS) or vSphere Distributed Switch (vDS). After the OVA deployment is complete, before powering on the Ops Manager VM, connect the network interface to the NSX-T logical switch. The instructions below describe how to do this. This issue is resolved in VMware vCenter Server 6.7. For more information about this issue, see the VMware Knowledge Base.

If you are using vSphere 6.5, at the Select Networks screen, select a vSS or vDS port-group such as the standard VM Network, and click Next.

Complete the remaining deployment steps as described above.

After the OVA deployment completes successfully, right-click the Ops Manager VM and select Edit Settings. Change the vNIC connection to use the nsx.LogicalSwitch that is defined for the TKGI Management Plane, for example LS-MGMT-TKGI. Deploy om 15

Step 3: Configure Ops Manager for Tanzu Kubernetes Grid Integrated Edition

The first time you start Ops Manager, you are required select an authentication system. These instructions use Internal Authentication. See Set Up Ops Manager in the Ops Manager documentation for configuration details for the SAML and LDAP options.

  1. If you are using the NAT deployment topology, create a DNAT rule that maps the Ops Manager private IP to a routable IP. See Create Management Plane in Installing and Configuring NSX-T Data Center v3.0 for TKGI for instructions.

  2. If you are using the No-NAT deployment topology, create a DNS entry for the routable IP address that you set for Ops Manager. Use FQDN to log into Ops Manager.

    Note: Ops Manager security features require you to create a fully qualified domain name to access Ops Manager. See Installing Ops Manager on vSphere.

  3. Navigate to the IP address (NAT mode) or FQDN (No-NAT mode) of your Ops Manager VM in a web browser. The “Welcome to Ops Manager” page should appear.

    Note: It is normal to experience a brief delay before the interface is accessible while the web server and VM start up.

    Om install 10

  4. Select Internal Authentication and provide the following information:

    • Username, Password, and Password confirmation to create a user with administrative privileges.
    • Decryption passphrase and the Decryption passphrase confirmation. This passphrase encrypts the Ops Manager datastore, and is not recoverable.
    • HTTP proxy or HTTPS proxy, follow the instructions in Configuring Proxy Settings for the BOSH CPI.
  5. Read the End User License Agreement, and select the checkbox to accept the terms.

  6. Click Setup Authentication. It takes a few minutes to initialize the database. Deploy om 19

  7. Log in to Ops Manager with the username and password that you created. Deploy om 20

  8. Verify success. You should be able to log in, and you should see the BOSH Director tile is present and ready for configuration, indicated by the orange color. Om install 11

Next Step

After you complete this procedure, follow the instructions in Generate and Register the NSX-T Management SSL Certificate and Private Key in Installing and Configuring NSX-T Data Center v3.0 for TKGI.


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