Loading the VMRC Browser Plug-In

Your Web application must load the VMRC browser plug-in by creating an object instance of the plug-in. If you create this object instance for Internet Explorer browsers, you must set the instance class ID to a value specific to the version of the VMRC API you want to use. If you create the object instance in the Firefox or Chrome browsers, you must likewise set the object instance type attribute to a specific value for your VMRC version. Example: Creating an Object Instance of the VMRC Browser Plug-In shows how to create an object instance using HTML, and how to set the CLSID or type values. The object instance is assigned the ID value vmrc.

Example: Creating an Object Instance of the VMRC Browser Plug-In

<!--[if IE]>

<![endif] -->

The code in Example: Creating an Object Instance of the VMRC Browser Plug-In can be included anywhere in the HTML code that makes up your Web application. Subsequent VMRC API examples in this document refer to the plug-in object instance using the value vmrc as set in the example.

The values of the classid and type attributes correspond to specific versions of the VMRC API. For the vSphere 5.1 and vCloud Director 5.1 releases, the classid must be set to the following value.

CLSID:4AEA1010-0A0C-405E-9B74-767FC8A998CB

In vSphere 5.1 and vCloud Director 5.1, the type attribute must be set to the following value.

application/x-vmware-remote-console-2012

You can verify the VMRC browser plug-in version prior to starting the VMRC plug-in by using the getVersion() API method. See Using the VMRC Plug-In and the API.

Windows Plug-in

In the SDK, the vmware-vmrc-win32-x86.exe installer applies to Windows systems.

VMware provides only the 32-bit binary VMRC plug-in, which also runs on 64-bit Windows.

Linux 32-Bit and 64-Bit

The vmware-VMRC.i386.bundle installer applies to 32-bit Linux, and the vmware-VMRC.x86_64.bundle installer applies to 64-bit Linux.

You must be logged in as root or have superuser privileges to run the bundle installers. The plug-in will be installed in /usr/lib/mozilla/plugins as shown below.

# ls -l /usr/lib/mozilla/plugins

...

lrwxrwxrwx 1 root root 62 Apr 8 14:58 npVMwareClientSupportPlugin-5-5-0.so -> /usr/lib/vmware-cip/5.5.0/npVMwareClientSupportPlugin-5-5-0.so

lrwxrwxrwx 1 root root 59 Apr 8 14:58 np-vmware-vmrc-5.5.0-1071230.so -> /usr/lib/vmware-vmrc/5.5/np-vmware-vmrc-5.5.0-1071230-64.so

If you run 32-bit Firefox on 64-bit Linux, install just the i386 bundle.

If you run 64-bit Firefox on 64-bit Linux, The plug-in directory might be /usr/lib64/mozilla/plugins instead of /usr/lib/mozilla/plugins. If the plug-in directory does not exist, you must create it.

If you are not certain whether you have 32-bit or 64-bit Firefox installed, first try /usr/lib, and if that does not work, try /usr/lib64. If you compiled your own copy of Firefox, similar advice applies. If the compiled Firefox binary is under your home directory as firefox/firefox, the plug-in should be installed in the firefox/plugins subdirectory.