Migrate your Citrix Storefront to another Server

Migrate your Citrix Storefront to another Server

In this article I would like to explain how you can migrate your Citrix Storefront Cluster to a newer operating system. Normally, if you have a Citrix storefront cluster, you can simply add a Server 2016 storefront server to an existing Server 2012 cluster and remove the older server.

In my example I move the Citrix Storefront Server from Windows Server 2008R2 to Windows Server 2016. Here the workaround with the cluster doesn’t work because too much has changed on the Microsoft IIS.

It is important to note that the same language must always be used on the Windows servers. So you cannot migrate your Citrix Storefront Server from a server with German language to a server with English language.

Why should you migrate your Citrix Storefront at all instead of simply setting up a new server or cluster?

Well, the Citrix storefront / cluster gets a storefront cluster ID in during the first configuration. The client (Citrix Workspace or Citrix Receiver) remembers this ID. If you simply install a new Citrix storefront cluster or server now, you have the problem that the apps are duplicated or no longer updated correctly. The client then configured 2 stores with the same address but different storefront IDs. This can be quite annoying…

Let’s get started.

First we want to export the Citrix Storefront Config from the old Storefront Server.

Go to your Citrix Storefront Server or one of your Citrix Storefront Cluster Servers. There you have to run Powershell. Run the Powershell as administrator.

Now execute the following command:

Copy to Clipboard

Now the necessary Citrix Storefront SDK modules are loaded.

In the next step we want to export the existing Citrix Storefront configuration. Of course we need this if we want to move the Citrix storefront to a new operating system.

Copy to Clipboard

Import settings to the new server

Now we want to import the Citrix Storefront settings on our future server. To do this we execute the first command in Powershell again to load the SDK. Before we can do this on the new server, Citrix Storefront has to be installed. The command only needs to be executed on a server if it is a cluster. The additional cluster node will then be added to the cluster as the second storefront server.

Copy to Clipboard

If the SDK was loaded successfully, we can import our configuration. We do this with the following command:

Copy to Clipboard

Ready for testing!

Now you can check your configuration on your new storefront server and test it.

Check your Storefront Cluster ID

With this command you can display the Storefront Cluster ID (enter the command in Powershell run as administrator):

Copy to Clipboard

If the storefront cluster ID could be read, the output looks something like this:

Copy to Clipboard

And here are some more useful links and informations:

Enclosed I have collected some useful information and I hope this can also help you with the further installation or configuration of the Storefront Server.

Here you can find the first Citrix website with the installation guide for Citrix Storefront: https://docs.citrix.com/en-us/storefront/current-release/install-standard.html

Important is to know the following (text is copied from the Citrix Storefront instructions):

  • Upgrading the operating system version on a server running StoreFront is not supported. Citrix recommends that you install StoreFront on a new installation of the operating system.
  • Upgrading to the latest StoreFront current release from an older current release that is now End of Life is not supported. For more information see CTX200356.
  • StoreFront does not support multiple server deployments containing different product versions, so all servers in a server group must be upgraded to the same version before you grant access to the deployment.
  • StoreFront does not support multiple server deployments containing different server OSs, so all servers in a server group must be on the same Windows Server OS.
  • Concurrent upgrade is not supported for multiple server deployments, servers must be upgraded sequentially.

I would like to take this opportunity to thank my colleague Christian Jöns, who has given me further information on this subject.

I hope as always that you liked the article and that it will help you. If you have any questions or suggestions, please write me a comment. Also read my other articles about Citrix ADC here.

Otherwise I am happy about a Like on Facebook, Xing or if you follow me on Twitter. You will find the social media buttons on top and on bottom of my page. You can also share my article if you like.

4 thoughts on “Migrate your Citrix Storefront to another Server”

  1. Hi

    Thanks for the article – so after installing on the new server what do you do with the old store front server do you just uninstall storefront or shut down?

    1. Hi Andy,
      After you have done the migration, you can change the loadbalancer or DNS to your new storefront/ cluster. After that shutdown your old Servers, check the Environment and delete the old servers after a few days.
      If you have more roles e.g. controller, you have to migrate this also.

  2. Hi – thanks for this brilliant article, I am bit confused under you section for

    I am migrating storefront servers from server 2008R2 to new created server 2016.

    ‘Import settings to the new server’ you say “The command only needs to be executed on a server if it is a cluster.” do you mean one of the new server 2016 server needs to be a member to the existing storefront store group ?

Leave a Comment

Your email address will not be published. Required fields are marked *