Tanzu Platform 10.0

Understanding installation pre-check output

Last Updated March 03, 2025

Use the following table to interpret the output from the installer pre-check command.

Test performed Output
IDP for OIDC

Checks for connectivity and appropriate permissions to your IDP.
Includes: Config - Issuer, client Id and client secret, and connectivity via nslookup

Fix: Verify that the specified IDP host is accessible from the cluster.
Success:
2024-08-01T14:22:32+05:30 [i] Checking host connectivity for IDP - oidc
2024-08-01T14:22:32+05:30 [i] Success: The hostname 'https://my-server.okta.com' resolves to 18.###.###.128, 18.###.###.130, 18.###.###.131

Error:
2024-08-01T14:21:13+05:30 [i] Checking host connectivity for IDP - oidc
2024-08-01T14:21:13+05:30 [i] Failure: The hostname 'https://dsadasdev-7084asdasd6880.oktasdasda.coasdasm' could not be resolved. Details: Server: 10.###.###.100
2024-08-01T14:21:13+05:30 [i] Address: 10.###.###.100#53
2024-08-01T14:21:13+05:30 [i]
2024-08-01T14:21:13+05:30 [i] ** server can't find https://dsadasdev-7084asdasd6880.oktasdasda.coasdasm: NXDOMAIN
IDP for AD

Checks for connectivity and appropriate permissions to your IDP.
Includes: Config - hostname and connectivity via nslookup

Fix: Verify that the configuration parameters are correctly set.
Success:
2024-08-01T14:22:32+05:30 [i] Checking host connectivity for IDP - ad
2024-08-01T14:22:32+05:30 [i] Success: The hostname 'https://my-server.okta.com' resolves to 18.###.###.1

Error:
2024-08-01T14:23:18+05:30 [i] Identity provider pre check started
2024-08-01T14:23:18+05:30 [i] Error: provide a valid value for Active Directory host
2024-08-01T14:23:18+05:30 [i] Identity provider pre check completed
IDP for LDAP

Checks for connectivity and appropriate permissions to your IDP.
Includes: Config - hostname and connectivity via nslookup

Fix: Verify that the configuration parameters are correctly set.
Success:
2024-08-01T14:22:32+05:30 [i] Checking host connectivity for IDP - ldap
2024-08-01T14:22:32+05:30 [i] Success: The hostname 'https://my-server.okta.com' resolves to 18.###.###.1

Error:
2024-08-01T14:23:18+05:30 [i] Identity provider pre check started
2024-08-01T14:23:18+05:30 [i] Error: provide a valid value for LDAP host
2024-08-01T14:23:18+05:30 [i] Identity provider pre check completed
Image Registry

Checks for connectivity to the given image registry along with specific version.

Fix: Verify that the version, user name and password, and repository URL are correctly set.
Success:
2024-08-02T10:23:45+05:30 [i] Starting connection validation
2024-08-02T10:23:47+05:30 [i] Connection successful - Tanzu Platform Self Managed version 1.0.0-2813-v4b004bc exist in repository my-packages-repo
2024-08-02T10:23:47+05:30 [i] Completed connection validation

Error:
2024-08-02T10:23:45+05:30 [i] Starting connection validation
2024-08-02T10:23:47+05:30 [i] Error: failed to connect - Hub Self Managed version 1.1.0-2137-v64eeda2 , *my-packages-repo*
2024-08-02T10:23:47+05:30 [i] Completed connection validation
Kubernetes cluster

Checks for connectivity to the target cluster, and memory and CPU resources.

Fix: Verify that the cluster has required memory and CPU resources.
Success:
2024-08-02T10:23:47+05:30 [i] Starting infra validation
2024-08-02T10:24:05+05:30 [i] WARNING: version difference between client (1.24) and server (1.26) exceeds the supported minor version skew of +/-1
2024-08-02T10:24:05+05:30 [i] Memory and CPU resources for the cluster:
2024-08-02T10:24:05+05:30 [i] Total Combined Resources (excluding master/control-plane/infra nodes):
2024-08-02T10:24:05+05:30 [i] Total Memory: 217.33 GiB
2024-08-02T10:24:05+05:30 [i] Total CPU: 56 CPU
2024-08-02T10:24:05+05:30 [i] Memory check completed
2024-08-02T10:24:05+05:30 [i] CPU check completed
2024-08-02T10:24:05+05:30 [i] Completed infra validation

Error:
2024-08-02T10:23:47+05:30 [i] Starting infra validation
2024-08-02T10:24:05+05:30 [i] Cluster connection pre check completed successfullyProfile: standard
2024-08-02T10:24:05+05:30 [i] Memory and CPU resources for the cluster:
2024-08-02T10:24:05+05:30 [i] Total Combined Resources (excluding master/control-plane/infra nodes):
2024-08-02T10:24:05+05:30 [i] Total Memory: 124.19 GiB
2024-08-02T10:24:05+05:30 [i] Total CPU: 32 milliCPU
2024-08-02T10:24:05+05:30 [i] Error: the total memory (124 GiB) of the Kubernetes cluster is less than required memory (500)
2024-08-02T10:24:05+05:30 [i] Error: the total CPU (32 milliCPU) of the Kubernetes cluster is less than required CPU (40)
2024-08-02T10:24:05+05:30 [i] Completed infra validation
DNS configuration

Checks for connectivity and configuration.

Fix: Verify that the specified ingress host is accessible from the cluster.
Success:
2024-08-02T10:07:42+05:30 [i] Ingress pre check started
2024-08-02T10:07:42+05:30 [i] Ingress pre check completed

2024-08-02T10:08:12+05:30 [i] Checking host connectivity for Ingress
2024-08-02T10:08:12+05:30 [i] Success: The hostname 'https://my-server.okta.com' resolves to 18.###.###.128, 18.###.###.130, 18.###.###.131

Configuration error:
2024-08-01T14:37:13+05:30 [i] Ingress pre check started
2024-08-01T14:37:13+05:30 [i] Error: provide valid value for certificate
2024-08-01T14:37:13+05:30 [i] Error: provide valid value for private key
2024-08-01T14:37:13+05:30 [i] Ingress pre check completed

Connectivity error:
2024-08-01T14:37:43+05:30 [i] Checking host connectivity for Ingress
2024-08-01T14:37:43+05:30 [i] Not able to extract host name
Version of Kubernetes cluster

Version of Kubernetes cluster into which Tanzu Platform will be deployed meets minimum requirements
Kubernetes cluster (client and server) comparison of the client

Fix: Verify that the Kubernetes cluster supported versions.
2024-08-02T10:23:47+05:30 [i] Starting infra validation
2024-08-02T10:24:05+05:30 [i] WARNING: version difference between client (1.24) and server (1.26) exceeds the supported minor version skew of +/-1
2024-08-02T10:24:05+05:30 [i] Memory and CPU resources for the cluster:
2024-08-02T10:24:05+05:30 [i] Total Combined Resources (excluding master/control-plane/infra nodes):
2024-08-02T10:24:05+05:30 [i] Total Memory: 217.33 GiB
2024-08-02T10:24:05+05:30 [i] Total CPU: 56 CPU
2024-08-02T10:24:05+05:30 [i] Client Version: 1.24
2024-08-02T10:24:05+05:30 [i] Server Version: 1.26
2024-08-02T10:24:05+05:30 [i] Cluster connection pre check completed
2024-08-02T10:24:05+05:30 [i] WARNING: version difference between client (1.24) and server (1.26) exceeds the supported minor version skew of +/-1
Memory and CPU resources for the cluster:
Total Combined Resources (excluding master/control-plane/infra nodes):
Total Memory: 217.33 GiB
Total CPU: 56 CPU
Client Version: 1.24
Server Version: 1.26
2024-08-02T10:24:05+05:30 [i] Memory check completed
2024-08-02T10:24:05+05:30 [i] CPU check completed
2024-08-02T10:24:05+05:30 [x] kubectl client - version '1.24' is not supported
2024-08-02T10:24:05+05:30 [i] Kubernetes server version is supported
2024-08-02T10:24:05+05:30 [i] Completed infra validation
Certificate configuration and precheck

Fix: If you encounter any of such errors. Please verify the certificate content.
It should be provided as string literal in yaml format.
2024-10-22T10:16:03+05:30 [i] Certificate pre check started
2024-10-22T10:16:03+05:30 [x] Ingress certificate is invalid.
2024-10-22T10:16:03+05:30 [x] Custom registry certificate is invalid.
2024-10-22T10:16:03+05:30 [x] Version Control System certificate is invalid.
2024-10-22T10:16:03+05:30 [x] LDAP certificate is invalid.
2024-10-22T10:16:03+05:30 [x] OAuth Provider certificate is invalid.
2024-10-22T10:16:03+05:30 [i] Certificate pre check completed
Profile downgrade

Fix: The Tanzu Platform installer does not allow downgrade of profile from high to low.
Verify profile value in config.yaml it should be same or higher than the old value.
2024-10-22T10:16:03+05:30 [x] Downgrade of profile not supported.
Prepare config before upgrade
tanzu-sm-installer prepare-config --kubeconfig <cluster.config>

Fix: If you encounter issues while upgrade due to config.yaml incorrectness, then run this command to get the correct config.yaml from the cluster.
2024-10-25T11:30:48+05:30 [i] Tanzu Platform Self Managed version 10.0.0-4200-vf923e7e already deployed, starting config preparation by merging existing cluster deployed values and new properties from the default config.yaml... 2024-10-25T11:30:48+05:30 [i] Backup of the config file created at: /Users/ringle/workspace/SM/ensemble-self-managed/config_25_10_24_11_30_48.yaml 2024-10-25T11:30:48+05:30 [ok] Config file prepared validate the same at /Users/ringle/workspace/SM/ensemble-self-managed/config.yaml.