Tag Archives: CIP

vCenter 6.0 vCSA Install & Upgrade Page Troubleshooting

The new 6.0 version of VMware’s vCenter Server Virtual Appliance (vCSA) has a newly updated deployment methodology using an .ISO and .html web page that is relatively well documented across the web.

I have frequently run into issues with getting the vCSA install/upgrade page to load and/or VMware Client Integration Plugin (CIP) to work properly. Below are the various fixes that have worked for me. More than likely if you run through the entire list, you’ll find a solution that works for you. If you don’t, or if you’ve found another solution you’d like to see on the list, please let me know! Obviously make modifications to your system at your own risk.

These basics to get started are covered elsewhere extensively, but here’s a quick overview:

  1. Mount the VCSA .iso with your favorite mounting software or native OS tool. I’m a fan of Virtual CloneDrive available here for OSes without the capability.
  2. Make sure your Internet Browsers are closed
  3. Install the Client Integration Plugin (CIP) using the .exe from within the <cd drive>:\vcsa folder.
  4. Open the <cd drive>:\vcsa-setup.html web page

Troubleshooting tricks:

  1. Upon opening the page (if the CIP installed correctly,) you will get a browser specific “Launch Application” (FireFox,) “External Protocol Request” (Chrome,) etc. Pop-Up with a check box that asks to “Remember My Choice”.
    1. Don’t select “Remember My Choice” until after you’ve gotten it working.
    2. This pop-up is your clue that your on the right track to get things working.
    3. If you don’t get this Pop-Up, the CIP is not installed correctly.
      1. Try restarting.
      2. Uninstall older versions of the CIP if installed
        1. Go to Programs and Features (for example) to see if an older version of the “VMware Client Integration Plug-in” is installed. Even the v5.5 version can cause problems.
        2. Restart and then reinstall the new version.
      3. If the Pop-Up still doesn’t appear and you are using FireFox, there may be a problem with your FF profile
        1. Try creating a new FF profile by running from Run/CMD “firefox.exe -p”
    4. Once you get the pop-up, Approve it quickly! Then, move on to the next step.
  2. If on Windows, modify your Hosts file. Add or modify these lines as follows:
    1. “   vmware-localhost
      #::1         vmware-localhost”
    2. Commenting out the IPv6 line fixed my problem on several occasions.
  3. All Browsers
    1. Make sure your browser is updated.
    2. Check to see if any older VMware plugins are installed.
      1. Uninstalling older Client Support and Remote Console plugins have resolved the issue for me in the past.
  4. FireFox specific
    1. Make sure FireFox is updated. Yes, I’m repeating this one.
    2. Check your proxy settings
      1. Go to about:preferences#advanced
      2. Select Connection Settings
      3. Change this to “No Proxy” or “Auto-detect”. “Manual” should work as well.
      4. Thanks to Sunny for this one.
    3. See what’s going on
      1. Click Menu > Developer > Web Console
      2. Review the errors. The most common error I’ve seen is the following:
        1. “Firefox can’t establish a connection to the server at wss://vmware-localhost:8093/”
    4. Check this obscure setting:
      1. Open about:config
      2. Search “dhe”
      3. The following two values should be changed to “false”
        1. security.ssl3.dhe_rsa_aes_128_sha
        2. security.ssl3.dhe_rsa_aes_256_sha
      4. Screenshot:
        1. VMware VCSA CIP Troubleshooting - Firefox Setting security.ssl3.dhe
      5. This one is courtesy of VMware from their KB, here.
      6. If this doesn’t fix it, I’d recommend changing them back.

Let me know if you find any other resolutions!