vCenter Server 8.0 へのアップグレードが次のエラーで失敗する: "ESX Agent Manager (EAM) upgrade failed to obtain EAM URLs"

Products

VMware vCenter Server

Issue/Introduction

免責事項：これは英文の記事「Upgrade to vCenter Server 8.0.x fails with "ESX Agent Manager (EAM) upgrade failed to obtain EAM URLs"」の日本語訳です。記事はベストエフォートで翻訳を進めているため、ローカライズ化コンテンツは最新情報ではない可能性があります。最新情報は英語版の記事で参照してください。

症状:

vCenter Server 8.0.x へのアップグレードが、事前チェック中に次のエラーが発生して失敗します。

Source vSphere ESX Agent Manager (EAM) upgrade failed to obtain EAM URLs to check against trusted certificates by the System!

Verify that the ESX Agent Manager extension is running properly on the source vCenter Server instance and https://VC_IP/eam/mob presents correct data. If log in to the MOB is not successful, try resolving the issue with https://kb.vmware.com/s/article/94934.

例:

ソース vCenter Server の /var/log/vmware/eam/eam.log を確認すると、次のエラーが見つかります。

eam.log .. [YYYY-MM-DDTHH:MM:SS] | INFO | vim-monitor | VcListener.java | 125 | Full stack trace: com.vmware.eam.EamRemoteSystemException: Client error communicating with the > vCenter server. at com.vmware.eam.vim.server.impl.VimRoot.rootOperation(VimRoot.java:103) at com.vmware.eam.vim.server.impl.VimRoot.currentTime(VimRoot.java:78) .. Caused by: com.vmware.vim.vmomi.client.common.UnexpectedStatusCodeException: Unexpected status code: 404 at com.vmware.vim.vmomi.client.common.Response$Status.getStatus(Response.java:56) at com.vmware.vim.vmomi.client.http.impl.HttpExchangeBase.parseResponse(HttpExchangeBase.java:271) at com.vmware.vim.vmomi.client.http.impl.HttpExchange.invokeWithinScope(HttpExchange.java:54) at com.vmware.vim.vmomi.client.http.impl.TracingScopedRunnable.run(TracingScopedRunnable.java:24) at com.vmware.vim.vmomi.client.http.impl.HttpExchangeBase.run(HttpExchangeBase.java:57) at com.vmware.vim.vmomi.client.http.impl.HttpProtocolBindingBase.executeRunnable(HttpProtocolBindingBase.java:227) at com.vmware.vim.vmomi.client.http.impl.HttpProtocolBindingImpl.send(HttpProtocolBindingImpl.java:114) at com.vmware.vim.vmomi.client.common.impl.MethodInvocationHandlerImpl$CallExecutor.sendCall(MethodInvocationHandlerImpl.java:693) at com.vmware.vim.vmomi.client.common.impl.MethodInvocationHandlerImpl$CallExecutor.executeCall(MethodInvocationHandlerImpl.java:674) at com.vmware.vim.vmomi.client.common.impl.MethodInvocationHandlerImpl.completeCall(MethodInvocationHandlerImpl.java:371) at com.vmware.vim.vmomi.client.common.impl.MethodInvocationHandlerImpl.invokeOperation(MethodInvocationHandlerImpl.java:322) at com.vmware.vim.vmomi.client.common.impl.MethodInvocationHandlerImpl.invoke(MethodInvocationHandlerImpl.java:195) at com.sun.proxy.$Proxy50.currentTime(Unknown Source) at com.vmware.eam.vim.server.impl.VimRoot.rootOperation(VimRoot.java:101) ... 9 more ..

ソース vCenter で PNID を照会すると、PNID が小文字で表示されていることがわかります。
```
# /usr/lib/vmware-vmafd/bin/vmafd-cli get-pnid --server-name localhost
vcsa.domain.local
```
ただし、ソース vCenter の /etc/vmware-rhttpproxy/endpoints.conf.d/ProxyConfiguration.json を見ると、hostname の部分が大文字で表記されています。
```
VCSA.domain.local
```

Environment

VMware vCenter Server 7.0.x

VMware vCenter Server 8.0.x

Cause

この問題は、vCenter Server 7.0 において、vCenter の FQDN、プライマリネットワーク識別子 (PNID)、vsphere.local ドメインに組み込まれたプラットフォームサービスコントローラのドメインコントローラ名 (DCName)、および /etc/vmware-rhttpproxy/endpoints.conf.d/ProxyConfiguration.json 内の PNID のスペルにて、大文字と小文字の区別が異なる場合に発生します。
vCenter Server 8.0 では、/etc/vmware-rhttpproxy/endpoints.conf.d/ProxyConfiguration.json にvCenter の FQDN が含まれなくなり、localhost に置き換えられます。

Resolution

注意：以下の手順を実行する前に、vCenter Server Appliance のバックアップまたはオフラインスナップショット（電源オフ状態）を作成してください。vCenter がリンクモードレプリケーション設定の一部である場合は、すべてのレプリケーションノードのバックアップ/スナップショットも作成してください。

この問題を解決するには、vCenter Server の PNID を /etc/vmware-rhttpproxy/endpoints.conf.d/ProxyConfiguration.json のスペルと一致するように変更してください。ただし、大文字小文字が異なる場合は PNID を直接変更することはできないため、以下の 2 段階の手順が必要です。

現在の vCenter IP と一時的な FQDN (例: VCSA1.domain.local) を使用して、DNS サーバーに一時的なレコードを作成します。
Reconfigure the Primary Network Identifierで概説されているプロセスに従って、PNID をこの一時的な FQDN に変更します。
PNID を古い FQDN に戻します。ただし、 /etc/vmware- rhttpproxy/endpoints.conf.d/ProxyConfiguration.json で見つかったスペルを使用します。例えば、vCenter の FQDN が ProxyConfiguration.json で VCSA.mj.local と記載されている場合は、これを新しい PNID として使用します。
一時的な DNS レコードを削除します。
vCenter Server をアップグレードします。

Additional Information

EAM URL を参照するアップグレード前チェックの失敗、または /var/log/vmware/eam/eam.log に「Client error communicating with the > vCenter server」というエラーメッセージが表示される場合は、サービストラスト (EAM の前述の URL を含む) を更新するために、lsdoctor.py --trustfix を実行する必要がある可能性があります。

lsdoctor の実行に関する詳細については、「Using the 'lsdoctor' Tool」を参照してください。