How I Upgraded My Site From 7.15 Flat All the Way to 1912

By Ray Davis posted 09-08-2020 09:04 AM

  

This is a guide on how I upgraded my site from 7.15 flat, all the way up to 1912. I also included moving off 2012R2 to 2016 DDCs with some troubleshooting situations you might run into. I covered the basics of upgrading licensing, DDC upgrades, Storefront upgrades with NS VIP configuration, PVS upgrades, WEM upgrades, VDA upgrades, and some re-configuration of Snap-ins with Citrix Director for ADM and session recording.

References for detailed instructions:

https://docs.citrix.com/en-us/citrix-virtual-apps-desktops/upgrade-migrate/upgrade.html
https://www.carlstalhood.com/delivery-controller-1912-ltsr-and-licensing/#licensingupgrade


PpeEJnwxuTATaBU2shZvx3NihrZ8vhAUy9jhBsjugn7vufRpVzOXHIHKRQDQ47aSUFe3tBICXilwKJ6dviicWZNvOy2ndWBt0Fn3cicTeYp_-Gw0sQFvJCQMEjvJKEE5pmKA2TE


Upgrade the licensing Server
:
Go download the version you need. In this case, it’s 11.16.3.0, Build 29000.


Run the CTX_licensing installer.


Check the box to agree.













After upgrading Citrix Licensing Server, in Citrix Studio, go to Configuration and Licensing.

On the right, click Authenticate Certificate.






Open Citrix licensing Manager.




I was prompted to register my licensing server with Citrix Cloud.

Licensing Manager might prompt you to register with Citrix Cloud.




On the Settings > Usage and Statistics page, in the "Share usage statistics with Citrix" section, click Register.




You’ll see a screen with a registration code. Click the Copy button and then click Register to be taken to Citrix Cloud.





After logging in to Citrix Cloud, on the top left, click the menu (hamburger) icon and then click License & Usage. If you don’t see this link, you might have to log out and log back in.




In the License & Usage service, switch to the Registrations tab.




Click the blue Register button in the middle of the page to register.





Paste in the copied code and then click Continue. Click Register.





In the On-premises Licensing Manager, it will eventually show as Registered.

On the same Usage & Statistics page, scroll down, and then click Upload now. This should cause data to upload to Citrix Cloud and show up in Citrix Cloud License & Usage.

Citrix.cloud.com reporting:










*Note* I always check and make sure it shows as activated within Studio and is set to the right product edition.

Upgrade VDA to 1912.

I also upgrade my VDAs ahead of time. It’s easy, and something I just do. Depending on your provision side, PVS, MCS, or old fashion servers (which is still used).

Mount ISO and upgrade.















Upgrade Delivery Controllers 7.15.5000.

Snapshot your Delivery controller.

Backup your SQL databases.

Attach the 7.15 CU5 media.

Run the Studio and Server Components for the upgrade.




Read and Accept.




Read and make sure you take the correct actions you need in your environment.




Start your Preliminary Test and make sure you are good!






Firewall Ports:



Summary:





Upgraded process started.















Connect to Call home if you need to.



Launch Studio.













**NOTE** If you already have two controllers, in Load Balancing, reactivate the servers with the new Delivery Controller version and set the second half of the servers to Down. Follow the top steps on the second half of the Delivery Controller Server. Activate each server with the new Delivery Controller Server version in Load Balancing again.

I am adding a 2016 server to move off 2012R2. I will add the Second 2016 server in, then make sure 2016 is handling the connections. Then Decom 2012R2 and add a new second (replacement of 2012R2 as 2016 server.

Attach the 7.15.5000 ISO, click on XenDesktop or XenApp (depending on your deployment).

XenDesktop allows for both XenApp and XenDesktop. XenApp is only XenApp.



Select Delivery Controller.



Read and Understand, accept.



We only want: Delivery Controller, Studio, and Director.




I don’t want SQL express in the step – uncheck it.




Review and make sure the firewall is configured based on your environment.




Installs:



This will take about 5-7 minutes.



Select Call Home options:



Finish, reboot, and then launch Studio.




After Studio is opened, select “Connect this Delivery Controller to an existing site.”




Add the primary DDC.



It will ask to update the DB automatically. I select "yes" and will put in my SQL creds.







Studio will open and show the Site.



Run a Site check to make sure it’s good.




This will take 10 minutes.



Looks good.



At this point, I have the following:

2012R2 715.5000 Deliver Controller

2016 7.15.5000 Delivery Controller.

Both are upgraded from 7.15 to 7.15.500.



Now we will begin the 7.15.500 upgrade to 1912 LTSR.

Snapshot your Delivery controller.

Backup your SQL databases.

Attach the 1912 media.

Run the Studio and Server Components for the upgrade.




Read and accept.





Make sure the following has been completed to ensure an upgrade will go smooth:




Licensing Error I received when I clicked "next." Even though I upgraded my licensing version to 11.16.3.0 build 29000, I had to update my licensing files past November 2019. I logged into my Citrix Licensing manager, https://yourCTXlicServer.FQDN:8083, then selected "check for available renewals." Follow the prompts to get an updated timestamp.




Before:



After:



Being as this is not production; my specs are lower than what it wants. However, I will meet the minimum to ensure the upgrade is solid.




Server specifications: https://docs.citrix.com/en-us/citrix-virtual-apps-desktops/system-requirements.html





Let's pick back up where I left off. Preliminary Site Test (Run this to ensure no errors exist).






Test in progress.






Two tests will not run, as they don’t apply.






Results: go through and test all the orchestrations of the environment.





Firewall ports.





Summary, then click upgrade.







Upgrade progress:





Upgraded, but Reboot needed.






After Reboot it will resume. Now on Post Install….




Connect to Citrix Cloud for Diagnostics data if needed in your environment.




Finish and now open Studio.




Now upgrade the Database through Studio (my service account has permissions).




It will ask you again about backing up the DB.




Add the credentials, unless you are logged into the server as the account (account needs proper permissions, in Citrix, and on the servers).




It’s now started.




 Going, 9 successful… GOOOD so far.




Still going well.




Finished.




You now need to do the second Delivery controller we added early in the process. It’s the 2016 server.




Remote to the Server, attach the Media, and I double-click on the mounted ISO from my hypervisor.




Click "Upgrade" on Studio and Server components.




Read and Agree.



Ensure the following is completed, although it’s a second DDC.




Firewall for DDC and Director:




Summary:




Warning pop up about not being able to stop it once it starts.




Upgrading has started (the time says 13 minutes). Sometimes it’s accurate, or not accurate.




The machine needs to be rebooted to apply some .Net settings/updates.








Rebooted, and now it’s still applying them.



Log back in, and it will resume back to the place it was at. Be patient!






Connect to Citrix Cloud for Diagnostics data if needed in your environment.






Now launch Studio.




Start the automatic site upgrade.




Being this has already ran, it shouldn’t take long.




Studio is now launched.




Lets do a site Test on the Delivery controller.




Things passed, and look good.



Let’s do a Machine Catalog and Delivery group test. (Failed)?!! Looks like my Delivery controllers don’t have the updated vCenter cert. Let me fix this. I simulated a failure to show the value of running the tests.

I fixed my cert by following this: https://support.citrix.com/article/CTX138640




Once both have updated 1912 software, go into the first Delivery Controller and finish the “upgrade remaining delivery Controllers.”




Once all the Delivery Controllers and VDAs are upgraded, within Citrix Studio, view your Catalog for the current functional level. (Set to VDA version you have in the catalogs.) Citrix Virtual Apps and Desktops (CVAD) 1912 lets you upgrade your Catalogs and Delivery Groups to functional level 1811 if needed.

**WARNING****

Don’t upgrade the Catalog or Delivery Group until all VDAs with the Catalog and Delivery Group are VDA version 1811 or newer.






Then upgrade the Delivery Groups by right-clicking on a Delivery Group and clicking Upgrade Delivery Group.






This concludes the upgrade for the Delivery controller.

Now let’s Decom one Delivery controller, which is 2012R2.

*Note*

https://discussions.citrix.com/topic/388816-decommission-delivery-controller/

https://docs.citrix.com/en-us/citrix-virtual-apps-desktops/manage-deployment/delivery-controllers.html

Active connections should not be dropped if you remove a delivery controller from the site. Remove the controllers from Storefront first, then from Citrix studio. Any VDAs registered to the controller should re-register with the remaining controllers, however, this may take a few minutes, so a resource that hasn’t registered yet might be unavailable for a relatively short time.

You could also stop the Broker service on the redundant controllers, which would also cause any registered VDAs to de-register.

Whilst doing this during business hours should be OK, there’s always a risk that for some reason a VDA doesn’t register with the remaining controllers, so unless you can’t avoid it, doing it out of hours, or during low use phases is always preferable.

Remove the controllers from Storefront first.




Then from studio.

Make sure the Controller is powered on so that Studio loads in less than one hour. Once Studio loads the Controller you want to remove, power off the Controller when prompted to do so.

Select Configuration > Controllers in the Studio navigation pane and then select the Controller you want to remove.




Select Remove Controller in the Actions pane. If you do not have the correct database roles and permissions, you are offered the option of generating a script that allows your database administrator to remove the Controller for you.










This errored out. So, I did it and selected "No" here.




Then it asked to generate a DB script, for the Database guys.






This still didn’t remove it. So, at this time I found the CTX link: 

https://support.citrix.com/article/CTX139505

https://www.jgspiers.com/remove-orphaned-delivery-controller-xenapp-xendesktop-site/

Run “Get-BrokerController”:




Then run this POSH Script.




It will put an Evict.txt file in either your profile %userprofile% or C:\windows\system32. Give this file to your DBA, then run it on the database.




Check Studio and it's gone.




Any VDAs registered to the controller should re-register with the remaining controllers.

Adding a second 2016 Delivery controller now to slit the broker balancing out.

Install Virtual Apps and Desktops.




Select Delivery Controller.




Read and accept.




Select the components you need.




Install the Feature you need (NO Local SQL for me).




Firewall ports:




Summary:




Extracting Files.




The machine needs to reboot.




Collect diagnostic information.




Finished, now launch Studio.




Connect the delivery controller to an existing site.




Add the delivery controller address that is already a part of the site.




For this part, in my environment, I selected "Yes."




Enter my creds to add to the database, then let the process begin.




I now have two controllers that are 2016.




Both servers are:




Remember to update the List of DDCs for the new DDC to register the machines.

https://docs.citrix.com/en-us/citrix-virtual-apps-desktops/manage-deployment/vda-registration.html

Finalize Citrix Director.

Finalize Director upgrade run this:

C:\inetpub\wwwroot\Director\tools\Directorconfig.exe /upgrade

If you use Citrix ADM, and Citrix Session Recorder you will need to register the Snapin back after all the upgrades. This is so you can control the feature in Director.

Register Director ADM MAS back.

If using HTTPS to connect to Insight Center, the Insight Center certificate must be valid and trusted by both the Director Server and the Director user’s browser. To link Citrix Director with NetScaler HDX Insight, on the Director server run:

C:\inetpub\wwwroot\Director\tools\DirectorConfig.exe /confignetscaler

Enter Machine name or IP: Netscaler Insights machine or IP vs1ctxadm01.jaxnavy.org
Enter 1 for Citrix ADM (aka MAS).
Rest is self-explanatory.




Register Director Snapin back for Session recording.

Run C:\inetpub\wwwroot\Director\tools\DirectorConfig.exe /configsessionrecording

Enter the Session Recording FQDN (server.FQDN) 19. Enter 1 for HTTPS.

Enter 443 as the port.




Upgrading or replacing the SQL Local DB for Local Host Cache for 1912 or 1912 CU1:

There have been some recent changes to the LTSR article around Local Host Cache upgrades:

  • When upgrading Delivery Controllers to Citrix Virtual Apps and Desktops version 1912 or 2003: Upgrading SQL Server Express LocalDB is optional. Local Host Cache works properly, with no loss of functionality, regardless of whether you upgrade SQL Server Express LocalDB. We added the option to move to a newer version of SQL Server Express LocalDB in case there are concerns about the end of support from Microsoft for SQL Server Express LocalDB 2014.
  • When upgrading Delivery Controllers to Citrix Virtual Apps and Desktops versions newer than 2003: The minimum supported version is SQL Server Express 2017 LocalDB Cumulative Update (CU) 16. If you originally installed a Delivery Controller earlier than version 1912, and have not replaced SQL Server Express LocalDB with a newer version since then, you must replace that database software now. Otherwise, Local Host Cache will not work.

As you can see here, at one time it stated you needed to upgrade, or it would not work. However, it doesn’t seem that is 100% anymore. I think that’s why Citrix updated the doc. 

As you can see here, some had the same concerns or questions around it. I most certainly did. 




So, let’s get started. I always do a snapshot first, which is completed. 

Complete the upgrade of your Citrix Virtual Apps and Desktops components, databases, and site. (Those database upgrades affect the site, monitoring, and configuration logging databases. They do not affect the Local Host Cache database that uses SQL Server Express LocalDB.)

As you can see, I am on 1912 CU1 and have MSQL Express 2014.




On the Delivery Controller, download PsExec from Microsoft. See the Microsoft document PsExec v2.2.





Stop the Citrix High Availability Service.




Open CMD as Admin and open PsExec.exe

psexec -i -u “NT AUTHORITY\NETWORK SERVICE” cm






Move to the folder containing SqlLocalDB.

cd “C:\Program Files\Microsoft SQL Server\120\Tools\Binn”




Stop and delete CitrixHA (LocalDB).
If you don’t stop it, you will get this error (me not paying attention):



SqlLocalDB stop CitrixHA.

SqlLocalDB delete CitrixHA.




Remove the related files in C:\Windows\ServiceProfiles\NetworkService




Uninstall SQL Server Express LocalDB 2014 from the server, using the Windows feature for removing programs.




Install SQL Server Express LocalDB 2017. In the Support > SQLLocalDB folder on the Citrix Virtual Apps and Desktops installation media, double-click sqllocaldb.msi.














Reboot the server and make sure this is started: “Citrix High Availability Service.”




Logged on and it took about 15 seconds to show up.




Then 60 seconds or so on this.




Check if the CitrixHA Db is created.

CitrixHA is re-created the next time configuration sync occurs. After a minute or two, use the SqlLocalDB utility to confirm that CitrixHA has been re-created.

SqlLocalDB i

CitrixHA

MSSQLLocalDB

Example:

While still in the PsExec session run this:

C:\Program Files\Microsoft SQL Server\120\Tools\Binn>SqlLocalDB i

CitrixHA

MSSQLLocalDB








You will see this until you do the second broker.




After I did my second broker this was in the logs:






But then I see this almost every two minutes. I remember reading about this. But I thought it was fixed many versions ago. 




Did some Googling on the errors and came up with the two links below.

https://blog.citrix24.com/xendesktop-7-15-local-host-cache-troubleshooting/

LHC DB upgrade reference:

https://docs.citrix.com/en-us/citrix-virtual-apps-desktops/upgrade-migrate/upgrade.html#replace-sql-server-express-localdb

Turns out some AD account was deleted over time, and it had some bad SIDs.

So, I ran the quick script to get the output.

Get-BrokerApplication |foreach {if ($_.AssociatedUserNames -match “S-1-5-21”) {$_.Name; $_.AssociatedUserNames -match “S-1-5-21”; “”}}





Went into Studio and deleted them from the location it displayed above, which was in Published Application Visibility.

Then, based on CTX230775, had needed to redo the LHC DB. So, quickly ran through the process and it fixed the error. 


In summary, this is how I upgraded the LHC DB and some minor troubleshooting. Hope it helps someone.

Citrix StoreFront 7.15 to 1912 (example I did on one SF server on the upgrade, but you would want 2 servers).

If you have a load balancer, disable it in your load balancer. This way traffic doesn’t route to it. (Assuming you have two or more storefront servers.)

In my case, I have an LB Vserver and IP is X.X.X.X  and back end servers are A.A.A.A  and B.B.B.B

Server A.A.A.A is disabled.

Browse the ISO.






Accept the terms.




Ready to install.




Installing.




Upgrade has finished.




I am adding a new StoreFront Server, so this will be a new install and add to the Storefront store. I just browse to the StoreFront application and run it.






License agreement.




Review prerequisites.




Ready to install.




Installing Software.




Successfully installed Storefront.




Join existing server group.




On the Primary StoreFront Server click “Add Server” here to get an Authorization Code.



Take this information and input it on the secondary StoreFront Server.




Input information on the Second server.




Joining.








Sever joined.

Now add IIS Cert and bind it to 443 in IIS.




Add this second server into NetScaler LB (I already have the one added in NS).

https://docs.citrix.com/en-us/storefront/current-release/integrate-with-citrix-gateway-and-citrix-adc/load-balancing-with-citrix-gateway.html

https://docs.citrix.com/en-us/storefront/current-release/integrate-with-citrix-gateway-and-citrix-adc/load-balancing-with-citrix-gateway.html#citrix-service-monitor

Add Server in netscaler>Traffic Management>Load Balancing>Servers

Add Server.




Add service.




Add monitor.

 



Now go bind it. Once you bind it to the Service, you will notice it’s down – which is normal, from what I have gathered.




The StoreFront monitors by default are only via HTTP. What I created earlier is trying to probe the backend services of our server through HTTPS.

To fix this do this:

Run PowerShell as an administrator.

PS C:\Program Files\Citrix\Receiver StoreFront\Scripts> .\ImportModules.ps1






PS C:\Program Files\Citrix\Receiver StoreFront\Scripts> Get-DSServiceMonitorFeature http://localhost:8000/StorefrontMonitor




Now run the command Set-DSServiceMonitorFeature -ServiceURL https://localhost:443/StoreFrontMonitor.




All steps outlined in Red.




Now you will see the monitor come alive on the Service.




Now bind it to the main Vserver.

Provisioning Server 1808 to 1912.

Please check to see if the previous version needs to be uninstalled first. In some versions, Citrix wants you to uninstall the older version first. But most of the time you don’t need to. 

Example here: https://discussions.citrix.com/topic/400292-pvs-server-upgrade-1808-to-1811-please-uninstall-pvs-server/

We are updating 1808 to 1912 so an in-place upgrade is good.

Before I start, I make sure I use a service account that is tied to the database so it can upgrade the database.

I put the account in the local admin of the PVS servers and use it to do the upgrades


Machine generated alternative text:
•I Panel 
All Control Panel Items Programs and Features 
Uninstall or change a program 
Search Programs and Fei 
To uninstall a program, select it from the list and then click Uninstall, Change, or Repair. 
Orga nize 
Uninstall Repair 
Citrix Diagnostics Facility 
Citrix Host Service PowerSheII snap-in 
Citrix Provisioning Consolexæ 1811.1.0 
Citrix Provisioning Server x64 1808.1.0 
Publisher 
Citrix Systems, Inc. 
Citrix Systems, Inc. 
Citrix Systems, Inc. 
Citrix Systems, Inc. 
Installed On 
8/30/2017 
12/28/2018 
12/28/2018 
10/16/2018

After the uninstall has completed, restart the server. When it comes back up, log back in with the service account.

Attach the ISO. Run Server installation.


Machine generated alternative text:
Citrix Provisioning 
Console Installation 
Server Installation 
Larget Device Installation 
Help and Support 
DVD 
Install the Server and its dependencies. 
O Exit

Click “Install,” the process will begin and then the window will disappear for a couple of minutes while it installs some of the pre-requisites. 


Machine generated alternative text:
Citrix Provisioning Server x64 1906.1.0 InstallShieId Wizard 
Citrix Provisioning Server x64 1906.1.0 requires the following items to be installed on 
your computer Click Install to begin installing these requirements. 
Status 
succeeded 
Succeeded 
Installing 
Pending 
Pending 
Pending 
P ending 
Requir ement 
CDF x64 
Telemetry Service x64 
Broker Snapin v2 x64 
Host PovverSheII Snapln v2 x64 
DelegatedAdmin PonerSheII Snapln x64 
ConfigLogging_PonerSheIISnapInx64 
Con figur a ton _P o n er ShellSnapInx64 
Installing Broker Snapin v2 x64

When the window pops back up Click “Next.” 



Accept the License Agreement and click “Next.”





Enter “Something” in the User Name and Organization fields, then click “Next.”



Click “Next.”



Click “Install.” 




Installing.




Click Finish.




The configuration wizard will start.











 









 

For this screenshot, I have 2 PVS servers. Depending on your farm, you could have one or more. The PVS server IP address will show here. If you have one server then one Ip will show. If you have two, then two will show. 



 









Backup your database before starting.








PVS console upgrade

Log in to the server with the service account.

In C:\SRC\1906 open the “Console” Folder. 

Right-click on “PVS_Console_x64.exe” and run as administrator. 

Once the .exe has launched Click next through the installation.



(Additional Screenshots of steps)

If you run into any issues during the installation of the pre-requisites refer to: 

https://www.carlstalhood.com/provisioning-services-server-install/


Accept the licensing term.




Fill in the names.




Install in the default directory.




Install.





Installing:




Finish.




Open the console and check the version.




You need to re-register those PowerShell snap-ins. Reregistering Citrix.PVS.Snapin.dll is well-known. Here are five other snap-ins that are necessary as well.

https://support.citrix.com/article/CTX235079

Citrix.PVS.Snapin

Citrix.Broker.Admin.V2

Citrix.Configuration.Admin.V2

Citric.ConfigurationLogging.Admin.V1

Ctrix.DelegatedAdmin.Admin.V1

Citrix.Host.Admin.V2


On the PVS server, run CMD as Administrator. Then in each of these folders:

CD \Windows\Microsoft.NET\Framework64\v4.0.30319

CD \Windows\Microsoft.NET\Framework\v4.0.30319


Run all of these commands:

.\InstallUtil.exe “C:\Program Files\Citrix\Provisioning Services Console\Citrix.PVS.Snapin.dll”

.\InstallUtil.exe “C:\Program Files\Citrix\Broker\Snapin\v2\BrokerSnapin.dll”

.\InstallUtil.exe “C:\Program Files\Citrix\Configuration\SnapIn\Citrix.Configuration.Admin.V2\Citrix.Configuration.PowerShellSnapIn.dll”

.\InstallUtil.exe “C:\Program Files\Citrix\ConfigurationLogging\SnapIn\Citrix.ConfigurationLogging.Admin.V1\Citrix.ConfigurationLogging.PowerShellSnapIn.dll”

.\InstallUtil.exe “C:\Program Files\Citrix\DelegatedAdmin\SnapIn\Citrix.DelegatedAdmin.Admin.V1\\Citrix.DelegatedAdmin.PowerShellSnapIn.dll”

.\InstallUtil.exe “C:\Program Files\Citrix\Host\SnapIn\Citrix.Host.Admin.V2\\Citrix.Host.PowerShellSnapIn.dll”


PVS Targets upgrades

You will need to go to the PVS server that you are working on the upgrades and open the PVS console.

Then go to vDisk Pools and create new versions. If you have five versions, then the sixth version will need to be merged with the last base and updates or updates only and needs to be Maintenance mode. It will take some time to create the merge-base.

Now go into your Hypervisor and power on the Master VM up that has the new version.

Open the console so you can see the VM.

It will ask you to press 1 for the new Maintenance version. Press 1, and it will boot into windows.

Now bring over the PVS software, and put it on the C or D drive of the Target.






Click Next at "Welcome to the Installation Wizard for Citrix Provisioning Service Target Device x64."




Select "I accept the terms in the license agreement," Click Next.




Leave as default, Click Next.




Leave as default, Click Next.




At "Ready to install the program," click Install.




Installation will begin and take a few minutes to complete.




Click Finish at "Installation Wizard Completed."




At this stage, the vDisk should be re-sealed (based on your sealing techniques) and re-distributed/copied to each Provisioning Server.

Update the BDM ISO. 

We use the BDM ISO.






Information:

Remember don’t check this unless your troubleshooting:

https://support.citrix.com/article/CTX230333

Reason why is here:

https://discussions.citrix.com/topic/363293-pvs-76-xa65-tds-taking-10mins-to-boot/








Upload to your hypervisor storage. Datastor/Container

Now attach that ISO to the PVS Targets you upgraded on 4c. It will need to new ARDBIN file. (If you forget this step, it will still boot. But will be slower and could get stuck in a loop.)

Citrix WEM 1811 upgrade to 1912 LTSR

Upgrade Deployments.

The data below is from Citrix Workspace Environment Manager 1912 Citrix Systems.

https://docs.citrix.com/en-us/workspace-environment-management/current-release/upgrade.html



The Workspace Environment Management components must be upgraded in the following order:

Infrastructure services

https://docs.citrix.com/en-us/workspace-environment-management/current-release/upgrade.html#step-1-upgrade-the-infrastructure-services

Database

https://docs.citrix.com/en-us/workspace-environment-management/current-release/upgrade.html#step-2-upgrade-the-database

Administration console

 https://docs.citrix.com/en-us/workspace-environment-management/current-release/upgrade.html#step-3-upgrade-the-administration-console

Agent

 https://docs.citrix.com/en-us/workspace-environment-management/current-release/upgrade.html#step-4-upgrade-the-agent


The following changes are going to occur so be ready:

  • A new clean installation of the WEM Agent will result in a complete change of Service Names and Folder Structures as below
  • The new Service name is: Citrix WEM Agent Host Service
  • The new process name is: Wem.Agent.Service.exe
  • The new path structure is: %ProgramFiles%\Citrix\Workspace Environment Management Agent

An upgraded installation of the WEM agent will result in partial changes to your environment:

  • The new Service name is: Citrix WEM Agent Host Service
  • The new process name is: Wem.Agent.Service.exe

The path on the file system will not be altered and will remain as it was: %ProgramFiles%\Norskale\Norskale Agent Host

Be aware also that in both clean and upgraded deployments, the Windows Event logs will change from Norskale Agent Service to WEM Agent Service 

Source:

https://jkindon.com/2019/09/11/citrix-wem-updated-start-up-scripts/

Infrastructure services.




I need .Net 4.7.1






I selected Yes.




Reboot and log in.




















Database

Open the database management Utility.














I at this point just restarted the server.

Check Database parameters (open the WEM Infrastructure Service Configurations).




You will notice the Port and old name (1811).




You will notice the Port and new name -1912.




*One thing to note on Port* 

Cache synchronization port. (Applicable to Workspace Environment Management 1909 and earlier; replaced by Cached data synchronization port in Workspace Environment Management 1912 and later.) The port on which the agent cache synchronization process connects to the infrastructure service to synchronize the agent cache with the infrastructure server. The cache synchronization port must be the same as the port you configured for the cache synchronization port (WEM Infrastructure Service Configuration > Network Settings) during the infrastructure services configuration. The port defaults to 8285 and corresponds to the AgentCacheSyncPort command-line argument.

Cached data synchronization port. (Applicable to Workspace Environment Management 1912 and later; replaces Cache synchronization port of Workspace Environment Management 1909 and earlier.) The port on which the agent cache synchronization process connects to the infrastructure service to synchronize the agent cache with the infrastructure server. The cached data synchronization port must be the same as the port you configured for the cached data synchronization port (WEM Infrastructure Service Configuration > Network Settings) during the infrastructure services configuration. The port defaults to 8288 and corresponds to the CachedDataSyncPort command-line argument. Alternatively, you can specify the port using a command-line option in the silent installation of the WEM agent 

Wayne Lui states it's backward compatible and still listens, but I would add this into your Firewall Ruleset. 




Admin Console.






















Agents

Upgrade the Agent on the machines. I did this with the GUI, but I do this in production.

##Install CMDLine with an SCCM task


Task 1:

“Citrix Workspace Environment Management Agent Setup.exe” Cloud=0 VUEMAppCmdDelay=5 WaitForNetwork=30 SyncForegroundPolicy=1 GpNetworkStartTimeoutPolicyValue=5 /log WEM2003.txt /quiet


Task 2:

##Copys Startup script 

xcopy “\\server\Citrix\Upgrade Files\WEM\2003\Workspace-Environment-Management-v-2003-01-00-01\WemRefreshCache\RefreshWEMAgentonReboot.bat” c:\scripts\refreshWemAgent /h /i /c /k /e /r /y


Task 3:

Then it runs a:

C:\Windows\Microsoft.NET\Framework64\v4.0.30319\ngen.exe update

C:\Windows\Microsoft.NET\Framework64\v4.0.30319\ngen.exe eqi 3


I took James Kindon's script: https://jkindon.com/2019/09/11/citrix-wem-updated-start-up-scripts/

Then it’s called it the same name as my older script was (RefreshWEMAgentonReboot.bat), does an xcopy, and placed it in the same location. This way the scheduled task will still have the same name when it runs. The CLI parameters are different but will do the same deal.










We use BISF to handle this during our sealing process.












Agents are completed.

There is a lot of material here, and I hope it helps out someone. In this blog, I highlighted how to upgrade the basics for what I would think most people would have. This is what I did in my environment and it has helped me.


#Citrix_Studio
#Citrix_Virtual_Apps_Desktops

​​​​​

Comments

09-24-2020 02:56 PM

Yea I have, I also Snapshot the DDC, back up the databases. Then my steps are, just down the DDC, Restore the SQL part, Revert the snapshot, power on and all is good. I went through this twice 2 months ago.

09-24-2020 12:03 PM

Have you tested a Delivery Controller restore (in case of a failed or botched site upgrade)?  I always shut down the DDC's (if possible) before snapping and taking a SQL backup and was wondering if this is a recommended step.