How to test an application without Citrix Virtual Apps using RDP Initial App

How to test an application without Citrix Virtual Apps using RDP Initial App

book

Article ID: CTX335974

calendar_today

Updated On:

Description

Sometimes an application does not work as desired when published as an application through Citrix Virtual Apps.  In the diagnostic process, you might be asked to test the application without Citrix as an RDP Initial App. 


Instructions

Prepare a RD session host:

  1. Build a clean Windows 2016 or 2019 server. 
  2. Join it to the domain so that a user can log into it.
  3. Install the RD session host role:  From an elevated powershell prompt run:
                              add-windowsfeature rds-rd-server  
            You will be prompted to reboot the server.
  1. Install the application that you need to test.
  2. Configure this registry setting here* :
Registry HiveHKEY_LOCAL_MACHINE
Registry PathSOFTWARE\Policies\Microsoft\Windows NT\Terminal Services
Value NamefAllowUnlistedRemotePrograms
Value TypeREG_DWORD
Enabled Value1
 

Prepare the .rdp file that will launch Chrome:

  1. On your endpoint, open the rdp client (mstsc).
  2. Enter the IP or FQDN of the new machine you just made.
  3. Under the Options, choose Save As… and save the .rdp file with a unique name.  
  4. Open Notepad.  Choose File Open and change the file type in the lower right corner from "Text Documents (*.txt)" to "All Files (*.*)"
  1. Open your .rdp file that you created in step 3 above.  Find the line that says “alternateshell:s:” 
  2. Type in the full path to the application that you want to launch for the test.  In this example, we plan to launch Chrome. 
Graphical user interface, text, application  Description automatically generated
  1. Save the file.

Launch the application:

  • Double-click the .rdp file to launch the application. 
  • A new RDP session will start to the RD session host. 
  • The application will fill the desktop and there will be no direct access to the desktop. 
 

Environment

Caution! Using Registry Editor incorrectly can cause serious problems that might require you to reinstall your operating system. Citrix cannot guarantee that problems resulting from the incorrect use of Registry Editor can be solved. Use Registry Editor at your own risk. Be sure to back up the registry before you edit it.

Issue/Introduction

When diagnosing a problem with a published application, it is often helpful to test the behaviour without Citrix Virtual Apps.