Manually installing the vCloud Director Agent on ESXi 5 / vSphere 5

Playing with my vCloud Director lab lately, I have end up with a trouble adding one of my ESXi 5 hosts to my vCloud Director 1.5 due to an error installing the vCloud Director agent. I knew I have used the same host with beta install of vCloud Director before, & that could be the reason why the agent is missing up. Of course, I could have re-installed the ESXi host in 15 minutes and be back on track, but I decided to burn sometime trying to figure out how to fix it without re-installing it. I was able to achieve that by uninstalling the earlier installed vCloud Agent then Install the new vCloud Agent. Doing it in vSphere 4 & vSphere 4.1 was well document in KB2003486, but not how to manually install and uninstall the vCloud agent on vSphere 5. After digging it for a bit, below is how I have done it in case you need it.

1- Enter my ESXi 5 host into maintenance mode

2- SSH login to my ESXi host

3- Uninstall the older vCloud Agent from the host using the following command: esxcli software vib remove -n vcloud-agent

4- Copy the vCloud Agent for vSphere 5 from the vCloud Director servers found at: /opt/vmware/vcloud-director/agent/    using the following command:

scp root@

5- Manually install the new vCloud Director Agent on your ESXi 5  host using the below command:

esxcli software vib install – -depot /tmp/

Note: the above command assume the you have the vCloud Agent in /tmp

The above should do the trick if you are using ESXi 5, if you are using ESXi 4/4.1 then you can follow KB2003486 though for the completion of this article I will highlight the commands of doing it on vSphere 4/4.1 as well.

Manually installing the vCloud Director Agent on ESXi 4.1 / vSphere 4.1

After taking the host into maintenance mode.

1- Login to an SSH session to your host

2- Remove the old agent using the following command:  /opt/vmware/uninstallers/

3- Copy the vCloud Agent installer found at /opt/vmware/vcloud-director/agent/  to your ESXi host using the following command:

scp vslad-install-esx41- root@

4- Change the permissions on the installer using:  chmod 755 vslad-install-esx41-

5- Install the vCloud Director Agent on your ESXi 4.1 host using the following command:



Note: In case if you have not figured it out on your own. was my ESXi host IP, where you should substitute your ESXi host IP for it.

I hope this help you save sometime figure it out as I have already burned the couple hours this topic worth.


  1. Good article helped me out i would like to point out to others the vib install command that worked for me was slightly different as -depot didnt work.

    esxcli software vib install –d /tmp/

  2. Thanks for the feedback Matt

  3. Matt,
    I had the same issue. Turns out it needs to be –depot rather than just -depot, though -d also works

  4. Ha! In my reply it edited it! There should 2 dashes in front of depot, not just one. Looks like the blog editor doesn’t like two dashes…

  5. Hi Kevin,

    Thanks for the hint. I have been using wordpress for about 5 years now and its the first time I notice how it react against a double dash. I have added a space back in the article for it to show the double dash as I could not find a better way to make it show up. I hope that will not confuse any one :).


  6. Thanks dude, I was building my vCloud lab and was facing the same issue and your post resolved my issue. Good post! Keep up the great work!

    -Amitabh | Singapore


  1. [...] you might want to check the following post during the vCloud Director agent installation stage: Installing vCloud Director Agent Manually. You will require vSphere Enterprise License, but I would recommend to get vSphere Enterprise Plus [...]

Speak Your Mind