Loading

×Sorry to interrupt
CSS Error

Refresh

Cookie Preference Center

General Information on cookies

When you visit our website, we use cookies to ensure that we give you the best experience. This information does not usually directly identify you, but it can give you a more personalized web experience. Because we respect your right to privacy, you can choose not to allow some types of cookies by clicking on the different category headings to find out more and change your settings. However, blocking some types of cookies may impact your experience on the site and the services we are able to offer. Further information can be found in our

Cookie Policy.

Strictly Necessary

Strictly Necessary

Always Active

Strictly Necessary

Strictly necessary cookies are always enabled since they are essential for our website to function. They enable core functionality such as security, network management, and website accessibility. You can set your browser to block or alert you about these cookies, but this may affect how the website functions. For more information please visit www.aboutcookies.org or www.allaboutcookies.org.

Cookie Details‎

Performance

Performance

Performance

Performance cookies are used to analyze the user experience to improve our website by collecting and reporting information on how you use it. They allow us to know which pages are the most and least popular, see how visitors move around the site, optimize our website and make it easier to navigate.

Cookie Details‎

Please confirm your settings by refreshing the page.

Functional

Functional

Functional

Functional cookies help us keep track of your past browsing choices so we can improve usability and customize your experience. These cookies enable the website to remember your preferred settings, language preferences, location and other customizable elements such as font or text size. If you do not allow these cookies, then some or all of these services may not function properly.

Cookie Details‎

Advertising

Advertising

Advertising

Advertising cookies are used to send you relevant advertising and promotional information. They may be set through our site by third parties to build a profile of your interests and show you relevant advertisements on other sites. These cookies do not directly store personal information, but their function is based on uniquely identifying your browser and internet device.

Cookie Details‎

Advertising Cookies

Consent Leg.Interest

Select All Vendors

Select All Vendors

Select All Hosts

Select All

Clear Filters

Information storage and access

Apply

Confirm My Choices Reject All Allow All

Skip to main content

My Subscriptions

Loading

Knowledge Base

Manually deleting replica virtual machines in VMware Horizon View (1008704)

Last Updated: 10/3/2023Categories: TroubleshootingTotal Views: 112856Language:
English

8 like this article

Subscribe to get an email
newsletter with new updates

8 people found this helpful Please provide article feedback:

Symptoms

You cannot remove replica virtual machines associated with desktop pools in View Composer

Removing source and replica virtual machines associated with desktop pools in View Composer fails

You have already used ViewDBChk Removing invalid linked clone entries automatically using the ViewDBChk tool (2118050) without success.

Purpose

This article provides information on the unprotected entity operation in sviconfig, which allows you to unprotect replica virtual machines for deletion from VirtualCenter or vCenter Server.

This is a legacy article for versions of Horizon prior to Horizon 8

Horizon 7.13.x has reached its End of General Support (Apr 30, 2023) and has entered into its Technical Guidance Support phase (ends Apr 30, 2025)

Important: We recommend you migrate from Horizon 7 to Horizon 8 as soon as possible. Horizon 8 offers numerous improvements in performance, scale, and experience for both Administrators and end users. Please see Ensuring a successful migration from Horizon 7 to Horizon 8 (89840)  for additional advice.

Support level for deprecated features with Horizon 8.0(2006) (94831) has details in regards to Horizon 8.0 which allowed a transition period/

Resolution

Note: If you are trying to find or remove an unused replica virtual machine, see Finding and removing unused replica virtual machines in VMware View (2009844).

The View Connection Server creates, manages, and deletes linked clones during the View Composer operations. If the Connection Server functions are interrupted, the linked clones create orphaned folders, protected folders and virtual machine objects remaining in vCenter Server.

To resolve this issue, run the unprotectentity command to remove the protection from linked clone objects.

Run these commands from the command prompt on the View Composer Server:

C:\Program Files (x86)\VMware\VMware View Composer

Note: In Windows Server 2008 machines, the command prompt must be run as an Administrator or you will receive an error. To accomplish this, Click Start, and type cmd. Hold Ctrl + Shift, and press Enter. User Account Control then confirms the escalated permissions, and you will be running cmd.exe as an Administrator.

Unprotecting a replica in the VMwareViewComposerReplicaFolder folder

For View Composer 2.7 and earlier (View 5 and earlier), run this command:

sviconfig -operation=UnprotectEntity -VcUrl=https://VirtualCenter_address/sdk -Username=VirtualCenter_account_name -Password=VirtualCenter_account_password -InventoryPath=/Datacenter_name/vm/VMwareViewComposerReplicaFolder/Replica_Name -Recursive=true

For View Composer 3.0 (View 5.1and later), run this command:

sviconfig -operation=UnprotectEntity -DsnName=name_of_DSN -DbUsername=Composer_DSN_User_Name -DbPassword=Composer_DSN_Password -VcUrl=https://vCenter_Server_address/sdk -VcUsername=Domain\User_of_vCenter_Server_account_name -VcPassword=vCenter_Server_account_password -InventoryPath=/Datacenter_name/vm/VMwareViewComposerReplicaFolder/Replica_Name -Recursive=true

Notes:

The sviconfig command parameters are case sensitive.

Values in italics are variables and must be replaced with your environmental values.

Values with spaces must be surrounded by double quotes.

For example:

-InventoryPath= "/View Repository/vm/VMwareViewComposerReplicaFolder"

The VMwareViewComposerReplicaFolder is a special container. The replica virtual machines are not visibly part of this container and the path to the virtual machine for sviconfig will always be /Datacenter_Name/vm/VMwareViewComposerReplicaFolder/replica-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx, regardless of which Resource Pools or Folders contain the virtual machine.

If the Datacenter object is not the top-level object and is inside a folder, the path must reflect this. For example, /folderName/Datacenter_Name/vm/VMwareViewComposerReplicaFolder/replica-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.

In some cases the sviconfig command to unprotect the replica may fail. If this occurs, unprotect the folder containing the replica using the procedure below to unprotecting the replica folder and its contents, and remove the replica. Afterwards use the protectEntity operation to re-protect the folder once you have deleted the orphaned object.

Note: For more information on removing replica in View 5.2 and later, see Finding and removing unused replica virtual machines in the VMware Horizon View (2009844).

Manually removing problem desktops and pools from Horizon (2015112)

Unprotecting the replica folder, VMwareViewComposerReplicaFolder and all the linked clone related objects it contains

For View Composer 3.0 (View 5.1 and later), run this command:

sviconfig -operation=UnprotectEntity -DsnName=name_of_DSN -DbUsername=Composer_DSN_User_Name -DbPassword=Composer_DSN_Password -VcUrl=https://vCenter_Server_address/sdk -VcUsername=Domain\User_of_vCenter_Server_account_name -VcPassword=vCenter_Server_account_password -InventoryPath=/Datacenter_name/vm/VMwareViewComposerReplicaFolder -Recursive=true

In View Composer 2.5 and later, you can re-protect the VMwareViewComposerReplicaFolder using -operation=ProtectEntity

The SviConfig utility does not check if a replica is currently in use by other linked clones. If a replica is in use, the linked clones cannot be powered on, refreshed, or recomposed after the replica is unprotected or deleted. You have to manually delete these unusable linked clones. Provisioning new linked clones from the same desktop pool creates new provisioned linked clones for these clones. Determining which replica disk is used for a linked clone virtual machine (1031842)  can assist in determining if a linked clone is utilizing a disk.

Note: The inventory path is case-sensitive. If any part of the path entered in the command line differs from the inventory path, you can receive an Error 11.

Possible error codes from the SviConfig utility

This table lists possible error codes from the SviConfig utility:

Code

Description

0

successful execution

1

The supplied DSN name can not be found

2

The supplied credentials are invalid

3

Unsupported driver for the provided database

4

Unexpected problem arisen

9

An invalid VirtualCenter URL was provided

10

VirtualCenter was unavailable or could not be accessed

11

The specified entity was not found

12

Unknown entity type. Recognized entities are VM and Folder

13

Failed to unprotect replica

14

Unsupported database schema version is found

15

Other application is using required resources. Stop it and retry the operation

18

Unable to connect to database server

26

There are some errors during the operation

27

The replica folder name cannot be found in VC inventory

28

Failed to create unused replica folder

29

Failed to move VM into a VC folder

34

invalid VC certificate

Note: If you receive Error code 11 when you run the command and your replicas are in a folder and not directly under the Datacenter, the path should be manually substituted in place of VMwareViewComposerReplicaFolder.

Related Information

For related information, see:

Manually deleting linked clones or stale virtual desktop entries from VMware View Manager 4.5 and later (2015112)

Finding and removing unused replica virtual machines in VMware View (2009844)

Re-protecting a View replica virtual machine (2015006)

Detectable by VMware SkylineTM

Actions

Copy

link to clipboard
copied!

Print

Language:
English

Attachments

Additional Resources

KB
•
在 VMware Horizon View 5.3 及更高版本中使用 ViewDBChk 工具自动移除无效的链接克隆条目 (2118050)

KB
•
Removing invalid linked clone entries automatically using the ViewDBChk tool (2118050)

KB
•
End Of General Availability of the Free vSphere Hypervisor (ESXi 7.x and 8.x) (2107518)

KB
•
Download and Install VMware Fusion (2014097)

Results 1-4 of 4

Ask The Community

Get answers quickly from VMware experts in the community

Post Subject

CONTINUE IN COMMUNITIES

Related Products:

VMware View Manager

VMware View

VMware Horizon View

VMware Horizon

Related Versions:

VMware View Manager 4.6.x

VMware View Manager 4.5.x

VMware View Manager 4.0.x

VMware View Manager 3.x

VMware View 6.0.x

VMware Horizon View 5.3.x

VMware Horizon View 5.2.x

VMware Horizon View 5.1.x

VMware Horizon View 5.0.x

VMware Horizon 7 version 7.4.x

VMware Horizon 7 version 7.2.x

VMware Horizon 7 version 7.0.x

VMware Horizon 7

view all

Take Our Survey

Was this article helpful?

YES

NO

Copyright © 2005-2024 Broadcom. All Rights Reserved. The term “Broadcom” refers to Broadcom Inc. and/or its subsidiaries.

Terms of Use

Your California Privacy Rights

Privacy

Accessibility

Cookie Settings

Support Assistant