Citrix MCS Machine Catalog Update Failure on AWS Due to Unsupported Catalog Name Characters
Article ID: CTX696778
Updated On:
Description
Administrators attempting to update a Machine Catalog master image hosted in AWS may observe:
- Catalog update operation fails.
- Image preparation terminates before completion.
- The provisioning task enters a FailedToFinalizeImagePreparation state.
- Web Studio displays an error indicating invalid AMI naming.
- Hosting connections and cloud permissions appear healthy.
- Other catalogs may update successfully using the same AWS hosting connection and service account.
Cause
Investigation found the machine catalog names contained the special character, an ampersand (&). Citrix MCS generates AWS AMI names based on the Machine Catalog name. AWS AMI naming restrictions do not permit the ampersand (&) character. As a result, image preparation fails when MCS attempts to create or finalize the AWS AMI during a catalog update.
Resolution
Recreate Machine Catalogs using a name that does not contain the ampersand (&) character. Do not use the ampersand (&) character when creating machine catalogs hosted on AWS.
Issue/Introduction
Updating a Citrix DaaS Machine Catalog hosted on AWS fails during the image preparation phase with an error like: Error finalizing the prepared image:2AMI names must be between 3 and 128 characters long,3and may contain letters, numbers, '(', ')', '.', '-', '/' and '_'
