Manage an AWS catalog
Manage machine catalogsdescribes the wizards that manage a machine catalog. The following information covers details specific to AWS cloud environments.
Note:
Before managing an AWS catalog, you need to finish creating an AWS catalog. SeeCreate an AWS catalog.
Remove tags
When you create a catalog or a VM, tags are created on the following resources:
- Virtual machine
- Root disk volume
- Identity disk volume
- NIC
- Root disk image (AMI)
- Launch template
- Snapshot of AMI or root disk
You can remove VMs and machine catalogs from Citrix database and remove tags. You can use:
Remove-ProvVM
withForgetVM
parameter to remove VMs and tags from a single VM or a list of VMs from a machine catalog.Remove-ProvScheme
withForgetVM
parameter to remove a machine catalog from the Citrix database and resources from a machine catalog.
This feature is only applicable to persistent VMs.
To do this:
- Open aPowerShellwindow.
- Run
asnp citrix*
to load the Citrix-specific PowerShell modules. Unlock the VM before removing the VMs. For example:
Unlock-ProvVM -ProvisioningSchemeName "
" -VMID " Run one of the following commands to remove VMs, machine catalog, and tags from resources.
Run
Remove-ProvVM
withForgetVM
to remove VMs from Citrix database and tags from VMs. For example:Remove-ProvVM -ProvisioningSchemeName "
" -VMName " " -ForgetVM Run
Remove-ProvScheme
to remove machine catalog from Citrix database and resources from a machine catalog. For example:Run Remove-ProvScheme -ProvisioningSchemeName "
" -ForgetVM
Verify that the VM is removed from the Delivery Controller, however, not from the hypervisor.
- Run
Get-ProvVM -ProvisioningSchemeName "
. This must return nothing." -VMName " " Go to AWS EC2 console. You must see the VMs, however, the tags are now removed. Tags from the following resources are removed:
- Virtual machine
- Root disk volume
- Identity disk volume
- NIC
- Run
If you remove the machine catalog, verify that the catalog is removed from the Delivery Controller.
- Run
Get-ProvScheme -ProvisioningSchemeName "forgetvmdemo"
. This must return an error. Verify in AWS EC2 console that the following resources are removed.
- Root disk image (AMI)
- Launch template
- Snapshot of AMI or root disk
- Run
Identify resources created by MCS
Following are the tags that MCS adds to the resources on AWS platform. The tags in the table are represented as “key”:”value”.
Resource name | Tag |
---|---|
ID disk | “Name”: “VMName_IdentityDisk” |
:“XdConfig XdProvisioned = true” | |
“CitrixProvisioningSchemeId”: “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx” | |
Image | :“XdConfig XdProvisioned = true” |
“CitrixProvisioningSchemeId”: “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx” | |
NIC | “Description”: “XD Nic” |
:“XdConfig XdProvisioned = true” | |
“CitrixProvisioningSchemeId”: “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx” | |
OS disk | “Name”: “VMName_rootDisk” |
“XdConfig”: “XdProvisioned=True” | |
“CitrixProvisioningSchemeId”: “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx” | |
[when AwsCaptureInstanceProperties = true] “Citrix Resource”: “” | |
[when AwsCaptureInstanceProperties = true and AwsOperationalResourcesTagging = true] “CitrixOperationalResource”: “” | |
PrepVM | “Name”: “Preparation - CatalogName - xxxxxxxxxx” |
:“XdConfig XdProvisioned = true” | |
“CitrixProvisioningSchemeId”: “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx” | |
[when AwsCaptureInstanceProperties = true] “Citrix Resource”: “” | |
[when AwsCaptureInstanceProperties = true and AwsOperationalResourcesTagging = true] “CitrixOperationalResource”: “” | |
Published snapshot | :“XdConfig XdProvisioned = true” |
如果不是一个快照卷工人AMI,那么“CitrixProvisioningSchemeId”: “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx” | |
Template | [when AwsCaptureInstanceProperties = true] “XdConfig”: “XdProvisioned=true” |
[when AwsCaptureInstanceProperties = true] “CitrixProvisioningSchemeId”: “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx” | |
[when AwsCaptureInstanceProperties = true] “CitrixResource”: “” | |
[when AwsCaptureInstanceProperties = true and AwsOperationalResourcesTagging = true] “CitrixOperationalResource”: “” | |
VM in catalog | :“XdConfig XdProvisioned = true” |
“CitrixProvisioningSchemeId”: “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx” | |
[when AwsCaptureInstanceProperties = true] “CitrixResource”: “” | |
[when AwsCaptureInstanceProperties = true] “aws:ec2launchtemplate:id”:”lt-xxxx” | |
[when AwsCaptureInstanceProperties = true] “aws:ec2launchtemplate:version”: “n” | |
[when AwsCaptureInstanceProperties = true and AwsOperationalResourcesTagging = true] “CitrixOperationalResource”: “” | |
Volume worker AMI | :“XdConfig XdProvisioned = true” |
Volume worker bootstraper | “Name”: “XenDesktop Temp” |
:“XdConfig XdProvisioned = true” | |
“CitrixProvisioningSchemeId”: “xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx” | |
[when AwsCaptureInstanceProperties = true and AwsOperationalResourcesTagging = true] “CitrixVolumeWorkerBootstrapper”: “” | |
Volume worker instance | “Name”: “Citrix.XD.Volumeworker-xxxx-xx-xx-xx-xxxx” |
:“XdConfig XdProvisioned = true” |