Failed to download the Site Recovery plugin with "Name or service not known" error after vSphere Replication deployment

Products

• VMware vSphere ESXi

Issue/Introduction

• After deploying vSphere Replication, the Site Recovery plugin download fails in the vSphere Client with the "Name or service not known" error.
  
  
• Configured the vSphere Replication host name using a Short Name.
  
  
• You can see the following error in vsphere_client_virgo.log.

/var/log/vmware/vsphere-ui/logs/vsphere_client_virgo.log

[YYYY-MM-DDTHH:MM:SS.985Z] [INFO ] sdk-plugin-deployer-769       com.vmware.vise.plugin.status.RemotePluginStatusServiceImpl       DOWNLOADING: Downloading plugin package com.vmware.drui.plugin:9.0.2.24570573 from https://<Host Short Name>:443/drplugin/plugin.json.zip ...
[YYYY-MM-DDTHH:MM:SS.985Z] [INFO ] sdk-plugin-deployer-769       com.vmware.vise.plugin.download.PluginDownloadServiceImpl         Downloading plug-in package 'com.vmware.drui.plugin:9.0.2.24570573' with temporary name '/etc/vmware/vsphere-ui/vc-packages/vsphere-client-serenity/com.vmware.drui.plugin-9.0.2.24570573/plugin-package.tmp'.
[YYYY-MM-DDTHH:MM:SS.985Z] [INFO ] sdk-plugin-deployer-769       com.vmware.vise.plugin.download.PluginDownloadServiceImpl         Downloading plugin package from https://<Host Short Name>/drplugin/plugin.json.zip
[YYYY-MM-DDTHH:MM:SS.985Z] [ERROR] sdk-plugin-deployer-769       com.vmware.vise.plugin.download.PluginDownloadServiceImpl         Downloading plug-in package 'com.vmware.drui.plugin:9.0.2.24570573' to '/etc/vmware/vsphere-ui/vc-packages/vsphere-client-serenity/com.vmware.drui.plugin-9.0.2.24570573/plugin-package.tmp' has failed due to unknown reasons. Removing failed plugin package folder '/etc/vmware/vsphere-ui/vc-packages/vsphere-client-serenity/com.vmware.drui.plugin-9.0.2.24570573'. java.net.UnknownHostException: <Host Short Name>: Name or service not known
 

 

Environment

VMware vSphere Replication 9.x

Cause

This issue occurs because the hostname was configured using short name that cannot be resolved via DNS.

vCenter Server downloads the plugin from a URL like the following, using the configured hostname:
https://<hostname>:443/drplugin/plugin.json.zip

If you configure a hostname that cannot be resolved, vCenter Server cannot access vSphere Replication and fails to download the Site Recovery plugin with the error "Name or service not known".

The Hostname must be set to a fully qualified domain name (FQDN) that resolved by DNS.
Using short name are not allowed.

Resolution

Please configure a valid fully qualified domain name (FQDN) that can be resolved by DNS.

Steps to follow:

1. Log in to the vSphere Replication Appliance VAMI using admin user.
   https:<vSphere Replication IP or FQDN>:5480/
   
   
2. Navigate to Summary and verify the Hostname and vCenter Server details.
   
   
3. Go to Networking and click Edit and update it with the correct FQDN.
   
   
4. Update the certificate
   Click Change Certificate and proceed with the update.
   
   
5. Reconfigure the appliance
   
   
   
6. Verify that the plugin download succeeds in the vSphere Client.

 

 

:

 

 

Additional Information

Below is the document to reconfigure the vSphere replication network settings:

Configure vSphere Replication Network Settings