Citrix: Workspace Install and Update

This document will walk you through installing and configuring the Citrix Workspace Client

Intro

Citrix Workspace is a new client from Citrix that works similar to Citrix Receiver and is fully backward-compatible. This article explains how to download and install the Citrix Workspace client.

Information

Download the latest version of Citrix Workspace. The page will auto-detect the OS version and offer the most recent version of the client for download.

Once the Receiver has been installed, users can opt to use a web browser to access Citrix, or configure the Receiver application to natively connect. The URLs are listed below.

URL Configuration

All URL environments are now using multi-factor authentication (MFA). If you need help configuring MFA, please visit 2-Step Verification via Office 365 or Duo. Citrix uses the Microsoft MFA service and the Microsoft Authenticator App similar to Office 365.

uncapps.its.unc.edu - We typically use this environment for departmental customers.

virtuallab.unc.edu - Provides student access to programs normally found only in computer labs and libraries. Site messages are tailored to students.

Citrix Login Instructions for UNCAPPS

1. In your browser, navigate to https://uncapps.its.unc.edu/
   • For a very brief moment you will see the traditional login page.

2. You will be immediately redirected to the Microsoft login page.

3. Enter your Onyen in the format onyen@ad.unc.edu
4. Enter your password, click Sign in

5. You will then be prompted to approve the sign in request in your Authenticator app.

6. Complete the MFA number match prompt on your Authenticator app where your Microsoft account is configured by entering the number shown on the login screen.

7. Choose to stay signed in or not

8. You will then be redirected back to https://uncapps.its.unc.edu/

If this is the first time you have used UNCAPPS and you do not have the Citrix Workspace installed or your local browser is blocking the ability to detect the Citrix Workspace automatically at startup, you see a window titled, "Welcome to Citrix Receiver."  Follow the below steps if you see this welcome screen.

1. Click Detect Receiver
   • The installation program checks to see if the Workspace app is on your computer.
   • If it has been installed, the installation program displays a window that lets you launch UNCAPPS, and you can skip the rest of these steps.\
   • If it is not installed, you see an option to download it.
2. Check the box to agree to the Citrix license agreement and click Download.

3. When the download completes, open the downloaded installer and click through the prompts.

4. When you finish installing, go back to the browser and click Continue to confirm that the Citrix Workspace installation is complete.

The installation program takes you to the UNCAPPS home screen.

Troubleshooting

If you are seeing odd issues with Citrix, make sure you have installed the latest version of Citrix Workspace.

ReceiverCleanupUtility

If you are running the latest version of Citrix Receiver, there could be a problem with corrupt files or registry entries carried over from earlier versions.  Citrix has a cleanup utility to completely uninstall all files and registry entries for Citrix Receiver. Citrix says that the newer versions of Citrix Receiver (v4.4 and later) no longer need the ReceiverCleanupUtility.  However, we’ve found instances where the ReceiverCleanupUtility is the only thing that helps.

Here are the steps involved:

1. Download the file ReceiverCleanupUtility.zip
2. Extract the file ReceiverCleanupUtility.exe from the .zip file.
3. Double-click ReceiverCleanupUtility.exe.
4. A Command Prompt window will appear, hit any key to continue.
5. When done, it will ask if you want to send data to Citrix, type “n” for no.
6. Hit any key to exit the Command Prompt.
7. Go to Citrix Workspace to install the latest version.
8. After the install is complete, open a browser and logon to your Citrix URL (uncapps.its.unc.edu, or virtuallab.unc.edu) and try again.

Unable to See Local Printers and Drives

The first thing to check in this case would be to see if they have the receiver installed. Citrix offers a browser-based HTML5 version of the receiver that will work without the receiver client being installed on a client machine. The drawback of this is that it doesn’t allow the user to access local resources. Installing the receiver client will resolve this issue.

Related Knowledge Articles

Citrix Favorites

Citrix Profiles

---