***Please review all of the instructions before scrolling down to download the Fix My Session installer.***
RDPSoft™ Fix My Session™ Version 1.0.46 Release Notes
FAQs
Where Should I Install Fix My Session?
We recommend installing the main Fix My Session components on a member server or management server in your RDS, AVD, Citrix, or Parallels RAS environment. While this can be a member server dedicated solely to running Fix My Session, it can also be on a shared management server or on a File Server hosting your UPDs or FSLogix profiles. While this Fix My Session Master Server is where you configure Fix My Session’s operating behaviors and deploy out the Fix My Session agent services to your session hosts, it itself uses very little resources on an ongoing basis.
Should you wish, you also have the opportunity to publish the companion Session Savior utility as a RemoteApp in your EUC environment so that users can logout and terminate their own hung sessions, even when the problem is not directly caused by a locked profile. To do that, please consult these resources as appropriate for your environment:
How to Create a Session Savior Collection in RDS
How to Publish the Session Savior Remote App in RDS
How to Create a Session Savior Host Pool in AVD
How to Publish the Session Savior Remote App in AVD
If you are running Fix My Session in a smaller AVD tenant, and do not have an extra management VM in place supporting your AVD session hosts, you can save money by installing Fix My Session on a single Windows 10/11 host (e.g. using a low cost B-Series Azure VM with 2 vCPU and 4 or 8 GBs of RAM), and having it act as both the Fix My Session master server AND the RemoteApp host for the Session Savior published RemoteApp. If you take this approach, first create a new Session Savior Host Pool in AVD and create your new B-Series VM there. Then, install Fix My Session, and after it is configured with agents deployed, publish the Session Savior RemoteApp.
If you are running Fix My Session on another EUC platform, like Citrix or Parallels RAS, you can adapt the RDS deployment steps above to suit your other EUC environment.
What User Profile Technologies Does Fix My Session Support?
Fix My Session has been designed and tested to resolve hung/locked profile issues with User Profile Disks (e.g. UPDs) in RDS environments, as well as FSLogix profile disks in RDS, AVD, Citrix, and Parallels RAS environments. Other profile technologies (e.g. roaming profiles, Citrix Profile Management, etc) have not been tested and are not supported by Fix My Session.
Does Fix My Session Support FSLogix Environments Operating in Cloud Cache Mode?
Fix My Session has not been tested against FSLogix environments operating in Cloud Cache mode at this time, and as such, automatic remediation of Cloud Cache profiles are not supported.
Does Fix My Session Support FSLogix Environments That Allow Multiple User Sessions to Connect to the Same Profile (e.g. Diff Disks)?
Fix My Session has been designed to fix hung/locked FSLogix profiles, where a profile is locked by a previous session or hung session. In Diff Disk scenarios, multiple sessions can access the same profile at the same time, so Fix My Session is not relevant to this scenario.
Does Fix My Session Support FSLogix Environments That Utilize Office (ODFC) Containers?
Fix My Session has been tested in environments that have been configured with standard FSLogix profile containers, as well as environments that utilize both FSLogix profiles AND Office (ODFC) profile containers. If an FSLogix profile is locked, Fix My Session will also attempt to unlock any Office (ODFC) containers associated with that user session during a locked profile remediation.
Will Fix My Session Work In Non-Persistent EUC Environments, Where Session Hosts are Routinely Reprovisioned with Golden Images (e.g. Nerdio)?
Yes, the latest version of Fix My Session can be configured so that its agents are deployed via scripts during the reprovisioning of an AVD or other EUC session host. This requires the use of a Global Managed Service Account in Active Directory. Please consult these resources below to learn how to create a Global Managed Service Account for the Fix My Session Agents, and how to create an auto-provisioning script for those agents.
Using Global Managed Service Accounts with Fix My Session
Performing Scripted Installs of the Fix My Session Agent
Is Azure NetApp Files Supported By Fix My Session?
Unfortunately, Azure NetApp Files are not supported by Fix My Session. This is due to the current lack of API support to manage open file handles on locked profile disks stored on Azure NetApp Files. Consider migrating your profile disks off of Azure NetApp Files to Azure Files if you would like to utilize Fix My Session for automated locked profile remediation.
Supported Operating Systems:
Installation is supported on the following operating systems:
- Windows 10 Enterprise Multiuser for Azure Virtual Desktop
- Windows 11 Enterprise Multiuser for Azure Virtual Desktop
- Windows Server 2016
- Windows Server 2019
- Windows Server 2022
- Windows Server 2025
Hardware Requirements for Main Installation System and for any Session Hosts with the Fix My Session Agents Installed
- CPU: 1 or more vCPUs recommended.
- RAM: 4GB+ minimum.
- Available Disk Space: 20MBs
Prerequisites for All EUC Environments
- Create a Service Account and Assign Admin Rights on Hosts – Create a service account in Active Directory that holds local admin rights on the following systems/VMs: a.) All RDS/AVD/EUC hosts managed by Fix My Session, including RDS connection brokers if RDS is in use. b.) The VM/Computer where Fix My Session is installed. c.) If a Windows File Server is being used to store UPDs or FSLogix profiles (as opposed to Azure File Shares for AVD deployments), make sure this service account is also a local Administrator on those Windows File Server(s).
- Provision a Mechanism to Relay SMTP Mail Notifications to Users – Fix My Session will send updates to end users after attempting to close hung sessions and profile disks that let them know if the fix was successful. It does this by sending email via SMTP relay. Since Microsoft is sunsetting SMTP Auth functionality in October 2025 across its Microsoft 365 offerings, we recommend using a transactional mail service like SendGrid or SMTP2GO, both of which have free tiers. In addition, if you have a mail server or service running on premises that can relay mail for authorized IP addresses or senders, whitelist the master server running the Fix My Session software so it can relay email properly. There are also open source email relay programs available for download like E-MailRelay. For more information on how to setup and troubleshoot email relay, please review this KB article.
- Set Necessary Windows Firewall Exceptions – In order for Fix My Session to communicate with its agents on managed EUC hosts, the Remote Event Log Management and Remote Service Management firewall exceptions must be enabled in the Windows Firewall (domain profile)
Note 1: Fix My Session’s installer and agent installer will automatically create these exceptions during installation, but if you have an active GPO or Intune policy that disables these exceptions, please adjust it.Note 2: When deploying its agents remotely using the Update Agent Settings Wizard, WinRM (Windows Remote Management) must be enabled on the target hosts, with a Windows Firewall exception in place. By default, WinRM is enabled on all supported versions of Windows Server and multi-session Windows 10 and 11 hosts in AVD.
- Adjust FSLogix GPO Settings if Necessary – Fix My Session requires that a user gets a temporary profile session on a session host if a profile problem is encountered, as this prevents the opportunity for Fix My Session to prompt them to start the profile fixing process (e.g. logging out any other sessions that still may be open as well as the temporary profile session, unlocking and closing the handle to their profile disk on a file server, and then deleting the temporary local profile that was created). In order for this to happen, please make sure the PreventLoginWithTempProfile setting is disabled (set to 0).
Prerequisites for AVD Environments
In order to perform specific operations in AVD environments, such as managing open profiles on Azure File Shares, as well as scanning hosts in host pools for hung user sessions, you will need to perform the following actions before setting up Fix My Session. For a guided walkthrough on how to do this, please download this linked PDF document.
- Create a SPN (e.g. App Registration) in the tenant hosting your AVD environment – When creating a new App Registration, create a new secret, and write down the App ID GUID of this SPN, as well as the secret created.
- Go to the Azure Resource Group(s) that host your AVD host pools, and under Identity and Access Management (IAM), grant the Desktop Virtualization Contributor Role to your SPN/App Registration.
- If using Azure File Shares to store user profiles, go to the Storage Account hosting your Azure File Shares, and under Identity and Access Management (IAM), grant the Storage Account Contributor and Storage File Data SMB Share Contributor roles to your SPN/App Registration.
- When deploying the agent components, Fix My Installer will automatically attempt to install the Az.Storage and Az.DesktopVirtualization modules into Powershell on the remote AVD hosts. In addition, when configuring your Azure App Registration and Service Principal Name in the Fix My Session application, Fix My Session will attempt to install these modules on the main installation (master) system. In certain rare circumstances, you may need to install these modules manually on those hosts. If that is required, launch PowerShell with admin rights, and run the following commands:
Install-Module Az.Storage
Install-Module Az.DesktopVirtualization
- If your AVD hosts are running Windows 10 or Windows 11, you must enable the RemoteRegistry service and set its startup type to automatic.
- If you have an AVD environment where session hosts are routinely reprovisioned from a golden image using orchestration (e.g. like in Nerdio), please review the Using Global Managed Service Accounts and Performing Scripted Deployments help topics in the Fix My Session help file for more information on how to deploy Fix My Session’s agents in these scenarios.
Note: If you are running Fix My Session in a smaller AVD tenant, and do not have an extra management VM in place supporting your AVD session hosts, you can save money by installing Fix My Session on a single Windows 10/11 host (e.g. using a low cost B-Series Azure VM with 2 vCPU and 4 or 8 GBs of RAM), and having it act as both the Fix My Session master server AND the RemoteApp host for the Session Savior published RemoteApp. If you take this approach, first create a new Session Savior Host Pool in AVD and create your new B-Series VM there. Then, install Fix My Session, and after it is configured with agents deployed, publish the Session Savior RemoteApp.
Prerequisites for Citrix and Parallels RAS Environments
In EUC environments other than RDS and AVD, one additional step should be taken so that the Session Savior published app can help users locate and terminate their own hung sessions.
In Active Directory, create a Global Security group called All EUC Hosts. In this group, add the computer accounts of all Citrix, Parallels RAS, or other EUC session hosts in your environment. Once this is done, you can specify this group in the Fix My Session Configuration Tool (Self Directed Session Fixer Tab) for the Session Savior app to query. If you also add/remove EUC hosts in the future, also add/remove them from this group going forward.
