Cluster Node Pre‑Install Checklist (Wizard Prereqs)
Use this checklist immediately before running the on‑prem cluster install wizard. It prevents common failures caused by blocked pop‑ups, missing egress access, or authentication missteps.
1) Allow Browser Pop‑Ups
Before starting the OVA Cluster Node installation and the Create Cluster flow, configure your browser to allow pop‑ups from your Apporto portal.
-
Why: The wizard triggers an auth/consent pop‑up needed to complete cluster registration.
-
Chrome example: Settings → Privacy & Security → Site Settings → Pop‑ups and redirects → Allowed → Add
https://YourPortalName.apporto.com.
If pop-ups are blocked, the auth consent window will not appear and installation will fail or stall.
2) Test Egress Port 443 Connectivity (Manager Node → Troubleshooting)
From the Control/Manager Node, open Troubleshooting and use the port check to verify outbound connectivity on 443/TCP to all required FQDNs.
2.1 Your Tenant
-
YourPortalName.apporto.com→ 443 should return Pass.
2.2 NA/AMER Endpoints
-
nv-region-kafka-bootstrap.apporto.com(plus brokersnv-region-kafka-broker-0/1/2.apporto.com) -
docker.io,registry-1.docker.io,auth.docker.io -
k8s.gcr.io -
public-assets.apporto.com -
nv-mgmt-release-mgmt-utils-prod.apporto.com -
nv-mgmt-hoopdev-grpc.apporto.com
2.3 EU/EMEA Endpoints
-
afg-region-kafka-bootstrap.apporto.com(plus brokersafg-region-kafka-broker-0/1/2.apporto.com) -
afg-mgmt-hoopdev-grpc.apporto.com(note: may not be active until regional rollout)
3) Authenticate with MSP Admin During Create Cluster
-
When prompted during Create Cluster, sign in using an MSP Admin account to your portal/tenant.
-
Immediately after sign‑in, the browser shows an Allow pop‑up. Click Allow to grant installer access.
If you dismiss or block the Allow prompt, cluster registration will not complete.
4) Expected Duration and Failure Guidance
-
Expected completion time: 15–30 minutes after clicking Finish in the wizard.
-
If it takes longer than 30 minutes, treat it as a likely failure and collect diagnostics.
Wizard Walkthrough (Key Moments)
-
Select Register → Next.
-
Fill required fields → click Refresh to generate the RDP Management API Key.
-
Review summary → click Finish to start installation.
If Installation Exceeds 30 Minutes
-
Open Troubleshooting on the Manager Node.
-
Enable the Support Tunnel (see link below).
-
Generate a Support Bundle and download it.
-
Open an Apporto support ticket and attach the Support Bundle.
Related Deployment Content
Troubleshooting & Support
Quick Checklist
- Pop‑ups allowed for
https://YourPortalName.apporto.com - Manager Node can reach all required FQDNs on 443
- MSP Admin account ready for Create Cluster auth
- Support Tunnel and Support Bundle steps known in case of delay > 30 minute