In certain situations you must enter an IP address, and in other situations you
must enter a hostname. And in some cases, it doesn't matter. You can determine
the appropriate value by inspecting the serving certificate of your vCenter
server.
Download the serving certificate of your vCenter server, and save it to a file
named vcenter.pem:
Replace VCENTER_IP with the IP address of your
vCenter Server.
Open the certificate file to see the Subject Common Name and the Subject
Alternative Name:
openssl x509 -in vcenter.pem -text -noout
The output shows the Subject Common Name (CN). This might be an IP address, or
it might be a hostname. For example:
Subject: ... CN = 203.0.113.100
Subject: ... CN = my-host.my-domain.example
The output might also include one or more DNS names under
Subject Alternative Name:
X509v3 Subject Alternative Name:
DNS:vcenter.my-domain.example
Choose the Subject Common Name or one of the DNS names under
Subject Alternative Name to use as the value of the vCenter server address
in your configuration file. For example:
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-29 UTC."],[[["\u003cp\u003eThis guide explains how to determine the correct vCenter server address for your Google Distributed Cloud configuration files, including admin workstation, admin cluster, and user cluster files.\u003c/p\u003e\n"],["\u003cp\u003eThe appropriate vCenter server address can be an IP address or a hostname, depending on your vCenter server's serving certificate.\u003c/p\u003e\n"],["\u003cp\u003eYou can obtain your vCenter server's serving certificate using \u003ccode\u003eopenssl\u003c/code\u003e to determine the correct address.\u003c/p\u003e\n"],["\u003cp\u003eInspect the certificate's Subject Common Name (CN) or Subject Alternative Name (DNS) to find a suitable value for the configuration.\u003c/p\u003e\n"],["\u003cp\u003eThe serving certificate of your vCenter server will determine whether you need to use an IP address or hostname in the configuration file, and you can choose between the Subject Common Name or one of the DNS names.\u003c/p\u003e\n"]]],[],null,["# Finding your vCenter server address\n\nThis document shows how to determine the value you should enter for\nyour vCenter server address in an Google Distributed Cloud\n[admin workstation configuration file](/anthos/clusters/docs/on-prem/1.7/how-to/admin-workstation-configuration-file)\nor an\n[admin cluster configuration file](/anthos/clusters/docs/on-prem/1.7/how-to/admin-cluster-configuration-file).\nIn some cases, you might also want to to enter this value in a\n[user cluster configuration file](/anthos/clusters/docs/on-prem/1.7/how-to/user-cluster-configuration-file).\n\nIn certain situations you must enter an IP address, and in other situations you\nmust enter a hostname. And in some cases, it doesn't matter. You can determine\nthe appropriate value by inspecting the serving certificate of your vCenter\nserver.\n\nDownload the serving certificate of your vCenter server, and save it to a file\nnamed `vcenter.pem`:\n\n```\ntrue | openssl s_client -connect VCENTER_IP:443 -showcerts 2\u003e/dev/null | sed -ne '/-BEGIN/,/-END/p' \u003e vcenter.pem\n```\n\nReplace \u003cvar translate=\"no\"\u003eVCENTER_IP\u003c/var\u003e with the IP address of your\nvCenter Server.\n\nOpen the certificate file to see the Subject Common Name and the Subject\nAlternative Name:\n\n```\nopenssl x509 -in vcenter.pem -text -noout\n```\n\nThe output shows the Subject Common Name (CN). This might be an IP address, or\nit might be a hostname. For example:\n\n```\nSubject: ... CN = 203.0.113.100\n```\n\n```\nSubject: ... CN = my-host.my-domain.example\n```\n\nThe output might also include one or more DNS names under\n`Subject Alternative Name`:\n\n```\nX509v3 Subject Alternative Name:\n DNS:vcenter.my-domain.example\n```\n\nChoose the Subject Common Name or one of the DNS names under\n`Subject Alternative Name` to use as the value of the vCenter server address\nin your configuration file. For example:\n\n```\nvCenter:\n credentials:\n address: \"203.0.113.1\"\n```\n\n```\nvCenter:\n credentials:\n address: \"my-host.my-domain.example\"\n```"]]
