Install Tanzu Application Platform on a Cluster

Use Tanzu Mission Control to install Tanzu Application Platform (commonly called TAP) on a managed cluster.

Prerequisites

Make sure you have the appropriate permissions.

To install Tanzu Application Platform (TAP) on a cluster, you must be associated with the cluster.edit role.

Make sure your cluster's configuration meets the TAP system requirements specified in Prerequisites for installing Tanzu Application Platform in the VMware Tanzu Application Platform Documentation.

Note:

If you have already enabled continuous delivery (CD) or Helm for a cluster, the latest verified version of FluxCD is deployed to the cluster. Because TAP uses an earlier version of FluxCD, and is therefore incompatible with the deployed version, you must first disable CD/Helm on the cluster before attempting to install TAP. If you attempt to install TAP on a cluster where CD/Helm is already enabled, you see an error that looks something like this:
```
Solution cannot be installed due to incompatible Continuous Delivery feature components on cluster(s)
```
This applies to individual clusters on which you enable CD or Helm, as well as clusters that belong to a cluster group on which you enable CD or Helm. Therefore, if you have enabled CD/Helm for a cluster group that contains one or more clusters on which you want to install TAP, then you must disable CD/Helm for the cluster group before attempting to install TAP on clusters in that cluster group.
In addition to disabling CD/Helm, you must make sure that the FluxCD package install resources are removed from all clusters, as described in Disable Continuous Delivery.
If you install TAP prior to enabling CD/Helm, TMC uses the version of FluxCD installed by TAP.
Tanzu Mission Control does not deploy TAP on the cluster if TAP packages are already present on the cluster. If you deploy TAP on a cluster through Tanzu Mission Control and then subsequently detach and re-attach the cluster, you must manually remove TAP packages on the cluster before installing TAP again from the Tanzu Mission Control console.
There is a known issue related to Tanzu Application Platform TAP-GUI version 1.7.7/1.7.6 where installation fails on Openshift as part of the View profile.
There is a known issue that when installing Tanzu Application Platform version 1.7.1 using Tanzu Mission Control on a multi-cluster environment, TAP does not receive ingress location values (secrets with authentication and CA data, and the ingress URL).
Use the Tanzu Mission Control console to update the build cluster configuration to point to the synced secrets and endpoint location found in the namespace `metadata-store-secrets`.
```
grype: 
  metadataStore: 
    authSecret: 
      importFromNamespace: metadata-store-secrets
      name: store-auth-token
    caSecret: 
       importFromNamespace: metadata-store-secrets
       name: store-ca-cert
    url: https://metadata-store.<user-supplied-domain-for-view-cluster>
```

Procedure

In the Tanzu Mission Control console, click Catalog in the left navigation pane.
Click on the Solutions tab, and then click on Install Tanzu Application Platform selector.
Select the Single Cluster tile, and then click the Install Tanzu Application Platform button.
Enter a name for your TAP deployment.
You can optionally provide a description.
Click Next.
Configure the profile parameters.
For a single-cluster deployment, you can install only the Full profile. Use the multi-cluster deployment to use a different profile, as described in Install Tanzu Application Platform on Multiple Clusters.
1. Select the version of TAP that you want to install on the cluster.
2. Click Select Cluster to select the cluster on which to install TAP.
3. Specify the ingress domain. To access the Tanzu Developer Portal and deployed workloads using a public URL, you must specify an ingress domain. You should create the DNS record after completing the TAP installation.
4. Specify the name of the supply chain.
  For more information about supply chains, see Overview of Supply Chain Choreographer for Tanzu in the VMware Tanzu Application Platform Documentation.
5. Specify the parameters for the image registry provider, including the secret name, the project path, and the secret namespace. These credentials are for pushing and pulling application images.
  You can optionally click Create Secret to configure a new registry secret or opaque secret.
6. Select the namespace provisioner, either Controller or GitOps, and then configure the parameters for the selected provisioner.
  For more information about the namespace provisioner, see Overview of Namespace Provisioner in the VMware Tanzu Application Platform Documentation.
7. Enter your entitlement account number.
  The entitlement account number (EAN) is a unique identifier that VMware assigns to its customers.
8. By default, guest login is enabled.
  
  By default, unauthenticated guest user access is enabled to the Tanzu Developer Portal. You can optionally disable guest access and configure an alternative authentication provider. For more information, see Set up authentication for Tanzu Developer Portal in the VMware Tanzu Application Platform Documentation.
Optionally, you can expand the Advanced Configuration section to configure parameters in the configuration form or YAML.
Note: To install the Full profile with all build dependencies, add the following section to the YAML configuration.
```
buildservice:
  exclude_dependencies: true 
```
Click View License Agreement to read the agreement, then click Close and Accept to agree to the license terms.
You must accept the license agreement to continue with the installation. You must also enable the option for inclusion in the Customer Experience Improvement Program for the TAP installation to proceed.
Click Install TAP.

Results

When you click Install TAP, Tanzu Mission Control installs Tanzu Application Platform on the cluster. Because the TAP installation also installs packages on the target cluster, it takes some time to complete the installation.

Note: When installing or upgrading a Tanzu Application Platform (TAP) deployment on your cluster, you might encounter an intermediate state of installation failure with one or more packages. This situation can be safely ignored, as it is only temporary. After a short period of time, these issues are reconciled to a state of installation success.

What to do next

To view information about the installation, go to the Solutions tab on the Catalog page, and then click Installed Tanzu Application Platforms. From this page, you can do the following:

You can access the developer portal. Click Catalog, then click Installed Tanzu Application Platforms, select a TAP installation, then click the link to the developer portal.
You can verify the profile details and status of all packages installed. Click Catalog, then click Installed Tanzu Application Platforms, then select a TAP installation. To get help for issues with installing packages, see Tanzu Application Platform Packages Are Not Installed in the Troubleshooting section.
You can create developer namespaces. Select Catalog, then click Installed Tanzu Application Platforms, select a TAP installation, and then click Create Developer Namespace. For more information about namespaces, see Set up namespaces in the VMware Tanzu Application Platform Documentation.
You can Edit a Tanzu Application Platform Configuration.
You can Delete a Tanzu Application Platform Configuration.

To learn more about Tanzu Application Platform, see the latest version of the VMware Tanzu Application Platform Documentation.