Citrix & Cisco ACI integration. Unexpected error, illegal character in path.

So, a few weeks back I performed a data center migration of Citrix XenApp 7.6 LTSB. The migration was a ‘Big Bang’ scenario kind.. we’ll you gotta luv those.. never really know how these turn out. In this case, the networking of the brand new data center was based around Cisco ACI.

So after well documenting the whole Citrix environment, I started to remove Machines & Machines Catalogs,,.. after that I removed the hosting connection of the old VMWare vSphere farm. Imported the new server certificate & root CA certificate of the new vCenter server, configured service account permissions and we where good to go, one might think.

After creating the (new) Machine Catalogs, the next step would be to deploy the ‘production farm’ from a ‘golden image’ by means of Citrix ‘Machine Creation Services’. Now, that didn’t go as planned.

Deployment started an returned an error:


Right.. now that wasn’t suppose to happen.. Viewing the error details:


Illegal characters in path?! well now.. what could that be..?


The Cisco ACI environment configured the networking for vCenter with a ‘pipe’ ( | ) symbols in the network name.
Citrix Studio, Machine Creation Services – and specific the underling powershell cmdlets don’t like ‘pipe’ ( | ) symbols.
The only way to work around this issue, for our team at that moment, was to create Standard Portgroups within VMWare/vCenter which din’t include pipe symbols. We gave them the correct VLAN tag, restarted the deployment and finished the migrations in appropriate timeline. The end costumer was a happy one.

So, if you every hear Cisco ACI, keep an eye out for the pipes 😉






StoreFront 3.6 Replication Error – Propagate Changes failed – due to HTML5 Installer



Problems with Citrix Storefront 3.6 today.
First thing is to verify Storefront services rights, follow this guide:

So, that is not the case this time…

The Problem:

When looking at event viewer on the secondary StoreFront node, the following error shows

An error occurred running the command: 'Add-DSFeatureInstances' 
The MSI HTML5Installer.msi is already installed 
At line:1 char:1
+ Add-DSHTML5ClientFeature -Folder 'C:\Program Files\Citrix\Receiver St ...
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
The MSI HTML5Installer.msi is already installed
Citrix.DeliveryServices.PowerShell.Command.RunnerInterfaces.Exceptions.PowerShellExecutionException, Citrix.DeliveryServices.PowerShell.Command.RunnerInterfaces, Version=, Culture=neutral, PublicKeyToken=e8b77d454fa2a856
An error occurred running the command: 'Add-DSFeatureInstances' 
The MSI HTML5Installer.msi is already installed
At line:1 char:1
+ Add-DSHTML5ClientFeature -Folder 'C:\Program Files\Citrix\Receiver St ...
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

So looks like the ‘Replication Engine’ is trying to perform an install of Storefront HTML5 Receiver, which in case is already installed…

The Workaround:

Well.. lets just uninstall that component on secondary server, so rep. engine from primary can install it without failing. One problem with this, is that you can’t uninstall it from ‘Program’s and Features’ within Windows. This needs to be done manually.

The HTML5 MSI is located in C:\Program Files \Citrix\ Receiver StoreFront \Features \HTML5Client \template\HTML5Installer.msi

1) Run C:\Program Files\Citrix\Receiver StoreFront\Features\HTML5Client\template>msiexec /uninstall HTML5Installer.msi on secondary storefront server.

2) Close All Citrix Consoles on secondary storefront server.

3) Restart the Citrix Configuration Replication Service on secondary storefront server.

4) Execute ‘ Propegate Changes’ from primary storefront server. (maybe need a second time)

Problem resolved

– Wondering why I always run into these kind of things… Next..