VUM の IP アドレス変更について

vSphere Update Manager (以下、VUM) は、Windows サーバ上で動作するため、IP アドレス変更時にも、VUM がインストールされている Windows サーバ上で作業します。

  • VUM Windows サーバへ接続
  • VUM IP アドレス変更
  • VUM IP アドレス更新・設定反映
  • VUM プラグイン有効化

作業を実施する前に

VUM が仮想マシンとして動いている場合には、念のため、クローン、またはスナップショットを取ってから作業を実施することをオススメします。

Step 1. VUM Windows サーバへ接続

最初に、VUM がインストールされている Windows サーバへ接続し、管理者アカウントでログインします。

以下の例では、リモートデスクトップ接続していますが、vCenter コンソールでも構いません。

VUM Windows サーバへ接続

Step 2. VUM IP アドレス変更

VUM の IP 情報は、VUM デフォルトパス直下に存在する extension.xml ファイルに保存されています。

VUM がインストールされているデフォルトパスへ移動し、extension.xml 右クリック > プログラムから開く > ワードパット をクリックします。

プロセス VUM デフォルトパス
32bit C:\Program Files\VMware\Infrastructure\Update Manager
64bit C:\Program Files (x86)\VMware\Infrastructure\Update Manager
extension.xml フォルダへ移動

xml 編集プログラムについて

メモ帳はうまく編集できないため、編集プログラムは、ワードパットを使ってください。

以下のハイライト部分を、変更したい IP アドレスに書き換えてから保存してください。

<?xml version="1.0" encoding="UTF-8"?>
<config>
    <vim>
        <vmodlName>vim.version.version10</vmodlName>
    </vim>
    <extension>
        <name>com.vmware.vcIntegrity</name>
        <version>6.0.0.25006</version>
        <description>VMware vSphere Update Manager Extension</description>
        <certificate>ssl\rui.crt</certificate>
        <keyFile>ssl\rui.key</keyFile>
        <healthUrl>http://10.100.100.100:9084/vci/downloads/health.xml</healthUrl>
        <servers>
            <server>
                <url>https://10.100.100.100:8084/vci/sdk</url>
                <proxyNameSpace>vci/sdk</proxyNameSpace>
                <description>VMware vSphere Update Manager</description>
                <company>VMware, Inc.</company>
                <type>SOAP</type>
                <serverThumbprint>B9:89:8A:DE:72:32:CB:2A:6E:B8:0A:33:25:10:DF:BA:08:03:17:38</serverThumbprint>
                <adminEmail>a@vmware.com</adminEmail>
                <adminEmail>b@vmware.com</adminEmail>
            </server>
            <server>
                <url>https://10.100.100.100:9087/vum-fileupload/</url>
                <proxyNameSpace>vum-fileupload</proxyNameSpace>
                <description>VMware vSphere Update Manager</description>
                <company>VMware, Inc.</company>
                <type>HTTP</type>
                <serverThumbprint>EF:63:6B:39:62:84:2D:DC:BD:F7:D8:D6:49:C9:9A:98:8A:1D:E6:67</serverThumbprint>
                <adminEmail>a@vmware.com</adminEmail>
                <adminEmail>b@vmware.com</adminEmail>
            </server>
        </servers>
        <clients>
            <client>
                <version>6.0.0.25006</version>
                <description>VMware vSphere Update Manager Client 6.0</description>
                <company>VMware, Inc.</company>
                <type>win32</type>
                <url>http://10.100.100.100:9084/vci/downloads/VMware-UMClient.exe</url>
                <proxyNameSpace>vci</proxyNameSpace>
            </client>
            <client>
                <version>6.0.0.25006</version>
                <url>https://10.100.100.100:9087/vci/downloads/vumclient.zip</url>
                <proxyNameSpace>vci</proxyNameSpace>
                <description>VMware vSphere Update Manager Web Client</description>
                <company>VMware, Inc.</company>
                <type>vsphere-client-serenity</type>
            </client>
        </clients>
        <tasks>
            <task id="com.vmware.vcIntegrity.SigUpdateTask"/>
            <task id="com.vmware.vcIntegrity.CheckNotificationTask"/>
            <task id="com.vmware.vcIntegrity.ScanTask"/>

            ・・・

            <task id="com.vmware.vcIntegrity.CancelRemediateTask"/>
            <task id="com.vmware.vcIntegrity.CancelVaDiscoveryTask"/>
            <task id="com.vmware.vcIntegrity.ConfigureToolsUpgradeTask"/>
            <!-- host upgrade upload task -->

            <task id="com.vmware.vcIntegrity.ImportRelease"/>
            <task id="com.vmware.vcIntegrity.DownloadOfflinePatchTask"/>
            <task id="com.vmware.vcIntegrity.ConfirmOfflinePatchTask"/>
            <task id="com.vmware.vcIntegrity.CancelOfflinePatchTask"/>
            <task id="com.vmware.vcIntegrity.RemediatePrecheckTask"/>
        </tasks>
        <events>
            <event id="com.vmware.vcIntegrity.DownloadGuestUpdate"/>
            <event id="com.vmware.vcIntegrity.DownloadGuestUpdateFailed"/>
            <event id="com.vmware.vcIntegrity.DownloadGuestUnixUpdate"/>

            ・・・

            <event id="com.vmware.vcIntegrity.SysprepHandleFailure"/>
            <event id="com.vmware.vcIntegrity.RemediationStatusEvent"/>
            <event id="com.vmware.vcIntegrity.SequentialRemediateFailedEvent"/>
            <event id="com.vmware.vcIntegrity.CheckPXEBootHostFailure"/>
        </events>
        <privileges>
            <privilege groupId="VcIntegrity.General" id="com.vmware.vcIntegrity.Configure"/>
            <privilege groupId="VcIntegrity.Updates" id="com.vmware.vcIntegrity.Scan"/>
            <privilege groupId="VcIntegrity.Updates" id="com.vmware.vcIntegrity.Remediate"/>
            <privilege groupId="VcIntegrity.Updates" id="com.vmware.vcIntegrity.Stage"/>
            <privilege groupId="VcIntegrity.Updates" id="com.vmware.vcIntegrity.ViewStatus"/>
            <privilege groupId="VcIntegrity.Baseline" id="com.vmware.vcIntegrity.ManageBaselines"/>
            <privilege groupId="VcIntegrity.Baseline" id="com.vmware.vcIntegrity.AssignBaselines"/>
            <privilege groupId="VcIntegrity.FileUpload" id="com.vmware.vcIntegrity.ImportFile"/>
        </privileges>
        <faults>
            <fault id="com.vmware.vcIntegrity.IncompatibleVc"/>
            <fault id="com.vmware.vcIntegrity.NoLicense"/>
            <fault id="com.vmware.vcIntegrity.NoSignatureSiteConnection"/>

            ・・・

            <fault id="com.vmware.vcIntegrity.VAAutoUpdateTimedoutFailure"/>
            <fault id="com.vmware.vcIntegrity.VAPreInstallScriptTimedoutError"/>
            <fault id="com.vmware.vcIntegrity.VAPostInstallScriptTimedoutError"/>
        </faults>
    </extension>
</config>

Step 3. VUM IP アドレス更新・設定反映

次に、窓ボタン + r を押すと出てくる ファイル名を指定して実行 ダイアログ上で cmd を入力し、コマンドプロンプトを開きます。

コマンドプロンプトを開く

VUM がインストールされているデフォルトパスへ移動し、以下のコマンドを実行し、変更した IP アドレス情報を反映させます。

vciInstallUtils.exe --vc <VCENTER_IP> --port <VCENTER_PORT> -U <VUM_ID> -P <VUM_PW> -S ./extension.xml -C ./ -L ./ -O extupdate

vciInstallUtils.exe コマンドについて

日本語 KB に載っているコマンドは、オプションにスペースが入ってないため、そのまま実行しても動きません。(単純なことでちょっと苦戦)

上記のコマンドを実行するか、英語 KB に載っているコマンドを実行してください。(あまり違いはありませんが)

KB : vCenter Update Manager の IP アドレスの変更、および Update Manager セットアップの保持 (2083835) (×)

KB : Changing the vCenter Update Manager IP address and preserving the Update Manager setup (1013222) (○)

プロセス VUM デフォルトパス
32bit C:\Program Files\VMware\Infrastructure\Update Manager
64bit C:\Program Files (x86)\VMware\Infrastructure\Update Manager

以下の例では、vciInstallUtils.exe のオプションに指定する値として、以下を使っています。

オプション
vCenter IP 10.100.100.50
vCenter Port 80 (デフォルト)
VUM ID VUM@vsphere.local
VUM Password VUM123

コマンドを実行して失敗した場合にも、それっぽい長い実行結果が表示されるので、実は失敗しているのに、成功したと勘違いしやすいです。

ちゃんと以下のような結果が出力されたか確認してください。 (SSL 関連警告、エラーメッセージは無視しています)

VUM IP アドレス更新・設定反映Raw Code(S)Raw Code(T)
c:\> cd "c:\Program Files (x86)\VMware\Infrastructure\Update Manager"
c:\> vciInstallUtils.exe --vc 10.100.100.50 --port 80 -U VUM@vsphere.local -P VUM123 -S ./extension.xml -C ./ -L ./ -O extupdate
2015-06-10T11:19:28.473+09:00 verbose vmware-vci-vciInstallUtils[00620] [Originator@6876 sub=Default] Dumping early logs:
2015-06-10T11:19:28.473+09:00 info vmware-vci-vciInstallUtils[00620] [Originator@6876 sub=Default] Logging uses fast path: false
2015-06-10T11:19:28.473+09:00 info vmware-vci-vciInstallUtils[00620] [Originator@6876 sub=Default] The bora/lib logs WILL be handled by VmaCore
2015-06-10T11:19:28.473+09:00 info vmware-vci-vciInstallUtils[00620] [Originator@6876 sub=Default] Initialized channel manager
2015-06-10T11:19:28.473+09:00 info vmware-vci-vciInstallUtils[00620] [Originator@6876 sub=Default] Current working directory: c:\Program Files (x86)\VMware\Infrastructure\Update Manager
2015-06-10T11:19:28.473+09:00 info vmware-vci-vciInstallUtils[00620] [Originator@6876 sub=Default] ThreadPool windowsStackImmediateCommit = true
2015-06-10T11:19:28.473+09:00 info vmware-vci-vciInstallUtils[00620] [Originator@6876 sub=ThreadPool] Thread pool on asio: Min Io, Max Io, Min Task, Max Task, Max Concurency: 2, 200, 2, 10, 2147483647
2015-06-10T11:19:28.473+09:00 info vmware-vci-vciInstallUtils[00620] [Originator@6876 sub=ThreadPool] Thread enlisted
2015-06-10T11:19:28.473+09:00 info vmware-vci-vciInstallUtils[03036] [Originator@6876 sub=ThreadPool] Thread enlisted
2015-06-10T11:19:28.473+09:00 info vmware-vci-vciInstallUtils[03016] [Originator@6876 sub=ThreadPool] Thread enlisted
2015-06-10T11:19:28.473+09:00 info vmware-vci-vciInstallUtils[00444] [Originator@6876 sub=ThreadPool] Thread enlisted
2015-06-10T11:19:28.473+09:00 info vmware-vci-vciInstallUtils[03004] [Originator@6876 sub=ThreadPool] Thread enlisted

・・・

2015-06-10T11:19:29.565+09:00 info vmware-vci-vciInstallUtils[00620] [Originator@6876 sub=Extension] Authenticating user VUM@vsphere.local
2015-06-10T11:19:29.565+09:00 verbose vmware-vci-vciInstallUtils[00620] [Originator@6876 sub=HttpConnectionPool-000001] HttpConnectionPoolImpl created. maxPoolConnections = 1; idleTimeout = 900000000; maxOpenConnections = 1; maxConnectionAge = 0
2015-06-10T11:19:29.643+09:00 info vmware-vci-vciInstallUtils[00620] [Originator@6876 sub=Extension] Logged in!
[2015-06-10 11:19:34:588 'Registrar' 620 INFO] This extension certificate has registered.

2015-06-10T11:19:34.604+09:00 verbose vmware-vci-vciInstallUtils[00620] [Originator@6876 sub=vmomi.soapStub[2]] Resetting stub adapter for server <cs p:0060f4d0, TCP:10.100.100.50:80> : Closed
[2015-06-10 11:19:34:604 '' 620 INFO]  [installerRunVCCommand, 530]  [VCSERVER]The extension registration succeeded
[2015-06-10 11:19:34:619 '' 620 INFO]  [installerRunVCCommand, 699]  [VCSERVER]
Setting the vpxdThumbprint config value in xml

Step 4. VUM プラグイン有効化

最後に、vCenter Client で vCenter へ接続し、プラグインを有効化し、Update Manager タブが追加されていれば OK です。

まずは、プラグイン > プラグインを管理 をクリックします。

vCenter プラグインの管理

プラグインリストが表示されたら VMware vSphere Update Manager エクステンション を右クリックし、有効化 をクリックします。

VUM プラグイン有効化

セキュリティ警告 がポップアップされたら この証明書をインストールし、セキュリティ警告を全て表示しない にチェックを入れ、無視 をクリックします。

VUM セキュリティ警告

プラグインのステータスが 有効 になっていることを確認します。

VUM プラグイン有効化完了

最後に、Update Manager タブが追加されていることを確認します。

VUM タブ追加完了

以上、vSphere Update Manager 6.0 IP アドレス変更 でした。