Runecast vSphere Client Plugin

Warning

Runecast vSphere Client Plugin is no longer supported
If you still have is installed, please follow steps below to Uninstall Runecast plugin from your vCenter.

Unregistering the extension from vCenter Server and cleaning up its files

Note

Unregistering the extension from vCenter Server stops it from being active in the vSphere Client, but does not clean up its files. This is because of a known VMware limitation on the vCenter Server version 6 and 7. Starting from vCenter Server version 8, you only need to unregister the plugin by running the below script or from https:///mob, and clean-up is done automatically.

We will walk you through each step of the uninstallation, providing clear instructions and useful tips along the way in this comprehensive tutorial: How to uninstall the Runecast plugin in vCenter.

To unregister the plugin run the following script:

Write-Host ''
Write-Host "Please enter vCenter Server address and login credentials"
Write-Host ''

###Setting up###
$vcenter = Read-Host 'vCenter Server address'
$user = Read-Host 'Username'
$pswd = Read-Host 'Password' -AsSecureString
$creds = New-Object System.Management.Automation.PSCredential($user,$pswd)
Set-PowerCLIConfiguration -InvalidCertificateAction Prompt -Scope Session -Confirm:$false | Out-Null

#Connect to vCenter
Write-Host "Connecting to $vcenter..." -ForegroundColor yellow
$vc = Connect-VIServer -Server $vcenter -Credential $creds

if (!$vc) {
    Write-Host "Connection to $vcenter failed" -ForegroundColor red
} else {
    Write-Host "Successfully connected to $vcenter"
    Write-Host "Runecast Web Client plugin is about to be unregistered from $vcenter" -ForegroundColor yellow

    do {
        Write-Host "Do you want to continue? (y/n): " -ForegroundColor yellow -NoNewline
        $answer = Read-Host
    } until (($answer -eq 'y') -Or ($answer -eq 'Y') -Or ($answer -eq 'n') -Or ($answer -eq 'N'))

    if (($answer -eq 'y') -Or ($answer -eq 'Y')) {
        Write-Host 'Unregistering Runecast plugin...' -ForegroundColor yellow
        $em = Get-View ExtensionManager
        try {
            $em.UnRegisterExtension("biz.runecast.rc2plugin")
            Write-Host 'Runecast plugin unregistered. Please, log out and log back in to vSphere Client'
        }
        catch {
            Write-Host $_.Exception.Message -ForegroundColor red
        }
    }

    #Disconnect from vCenter
    Write-Host "Disconnecting from $vcenter..." -ForegroundColor yellow
    Disconnect-VIServer -Server $vc -Confirm:$false
}

To clean up the files, and completely remove the plugin, follow the steps below:

1. Stop vSphere Client service(s).

   Tip

   Information about how to stop/start vCenter services is available on the following links: https://kb.vmware.com/s/article/2109887
   https://kb.vmware.com/s/article/2109881

2. Remove the plugin directories:

   • For VCSA version 6.5 and later, navigate to:

     • /etc/vmware/vsphere-client/vc-packages/vsphere-client-serenity and remove the biz.runecast.\* folder
     • /etc/vmware/vsphere-ui/vc-packages/vsphere-client-serenity and remove the biz.runecast.\* folder
     • $VMWARE_DATA_DIR/vsphere-client and remove the runecast folder
     • $VMWARE_DATA_DIR/vsphere-ui and remove the runecast folder

   • For Windows based vCenter Server 6.5 and later, navigate to:

     • %VMWARE_CFG_DIR%\vsphere-client\vc-packages\vsphere-client-serenity and remove the biz.runecast.\* folder
     • %VMWARE_DATA_DIR%\vsphere-ui\ and remove the runecast folder

   • For VCSA version 6.0, navigate to:

     • /etc/vmware/vsphere-client/vc-packages/vsphere-client-serenity and remove the biz.runecast.\* folder
     • $VMWARE_DATA_DIR/vsphere-client and remove the runecast folder

   • For Windows based vCenter Server 6.0, navigate to:

     • %VMWARE_CFG_DIR%\vsphere-client\vc-packages\vsphere-client-serenity and remove the biz.runecast.\* folder
     • %VMWARE_DATA_DIR%\vspherewebclientsvc\ and remove the runecast folder

3. Start vSphere Client service(s).