Access Keys:
Skip to content (Access Key - 0)

Using BrioQuery and SAPgui via Citrix 10 on Mac OS X

On this page:


Citrix is an enterprise service that allows Macintosh users to access applications that do not run on Mac OS X. The IS&T Help Desk provides support for Macintosh users accessing BrioQuery and SAPgui via Citrix.

Setting Up Citrix for First Time Use

These steps need to be followed just once, before you use Citrix for the first time.

  1. You must register for a Citrix account before you can use it.
    Note: To use Citrix, your Kerberos password cannot be more than three years old. If your password exceeds this age limit, you need to change your Kerberos password
  2. Follow the Citrix 10 for Macintosh Installation Instructions to install the application.
  3. Citrix applications rely on launch.ica files, which are downloaded as a zip archive, and stored on your machine for future use. Follow the instructions to obtain Citrix version 10 launch files

Logging In to Citrix

Locate the folder of MIT Citrix launch files on your computer. If needed, follow the instructions to obtain Citrix version 10 launch files
Citrix file folder

  1. Double-click BrioQuery.ica or SAPgui.ica.
    Citrix launch files

    Result: A connection is made to the Citrix server, and the Windows Server 2003 login window appears.
  2. Enter your Kerberos username and password and click OK. The username is the first part of your email address, before the Enter the password that you use to check your email.
    Windows server lg in screen

    Result: The application (BrioQuery or SAPgui) launches.

Tips for Citrix Usage

  1. Off Campus Users Need the MIT VPN Client
    If you are working from off campus, or from a private subnet on campus, you will need to run the Cisco VPN client in order to log in to Citrix.
    On campus users not running the MIT VPN will see the following error:
    'Connection failed"

  2. Keyboard Shortcuts
    Since you're running BrioQuery for Windows, make sure you use the BrioQuery (Windows) keyboard shortcuts rather than the BrioQuery (Macintosh) shortcuts. E.g., To open a file, press <control> - O
  1. Context-sensitive Menus
    To access the BrioQuery context-sensitive menus in the Citrix environment, place your pointer on the item, then press <option> - click

Working with Files

The Open and Save dialog boxes do not display the name of your local hard drive(s) but instead display drive letters and terms used in Windows (e.g., Local Disk C: ). Your local desktop hard drive displays as "C$ on 'Client'V:".

To open or save a file:

  1. Go to either File > Open... or File > Save As...
    Result: A message displays, "Program requires READ access to the "C" drive which maps to the folder hdname:Users:user_folder (where hdname is the name of your hard drive and user_folder is the name of your account folder in the Users folder). Do you want to allow or deny READ access to this folder for the rest of the session?"
  2. Click Allow.
    Result: The Open or Save As dialog box displays.
  3. Click on the arrow to the right of the Program folder and select C$ on 'Client'V: from the list to go to your local hard drive.
    Result: The folders inside hdname:Users:user_folder display.
  4. Save the file.

To allow Read and Write access without being prompted

  1. Navigate on your hard drive to Applications > Citrix ICA Client. Double-click to launch the Citrix ICA Client Editor.
    Network connection screen

  2. Press Default Settings.
    Result: The Default Settings window opens.
    Default settings screen

  3. Select the Drives and Devices tab.
    Drives and devices screen

  4. On the line with the user home icon, set the following values:
    • The Enabled column should be checked.
    • Click the icon in the Read column until it changes to a pair of glasses with no question mark, and no red line.
    • Click the icon in the Write column until it changes to a pencil with no question mark and no red line.
  5. Click Save and exit the application.
    Result: Citrix will allow Read and Write access without prompting each time.

Note: You may want to create a subfolder, for example on your Desktop, to store your BrioQuery files.


Printing from Citrix is different from printing natively on your Macintosh. Your print job is processed first by Windows in the remote Citrix system, and then it is passed to the MacOS printing system on the computer you're working on.

Enable Printing with Dialog

Before you can start printing within Citrix, you'll need to enable the Citrix print dialog. Go to the File menu in Citrix, and make sure that Enable Print Dialog is turned on:
Citrix file menu options

You only need to do this once.

Printing Your Document

When printing a document in Citrix, you'll need to take a few extra steps. To print from BrioQuery:

  1. Go to File > Print...
    Result: The BrioQuery (Windows) dialog box displays.
    Windows print screen

    Note: You may see a different printer listed in the Name field.
  2. Click OK.
    Result: The Macintosh Print dialog box displays.
    Macintosh print screen

    Note: If the Macintosh Page Setup dialog box displays, choose your printer from the Format for: popup list, then click OK.
  3. From the Printer: popup list, choose your printer, then click Print.

Change the Citrix Window Size

  1. Navigate on your hard drive to Applications > Citrix ICA Client. Double-click to launch the Citrix ICA Client Editor.
    Client editor screen

  2. Press Default Settings.
    Result: The Default Settings window opens.
    Default settings screen

  3. Select the Connection Properties tab, then Windows and Sounds.
    Windows and sounds screen

  4. Use the drop-down menu to select the desired window size.

Related Links

Data and Reporting Services
Citrix 10 for Macintosh
Citrix Registration

IS&T Contributions

Documentation and information provided by IS&T staff members

Last Modified:

April 29, 2016

Get Help

Request help
from the Help Desk
Report a security incident
to the Security Team
brio brio Delete
brioquery brioquery Delete
citrix citrix Delete
m-hermes m-hermes Delete
mac mac Delete
data data Delete
warehouse warehouse Delete
sapgui sapgui Delete
sap sap Delete
gui gui Delete
os os Delete
x x Delete
c-citrix c-citrix Delete
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.
This product/service is:
Easy to use
Difficult to use

This article is:
Adaptavist Theme Builder (4.2.3) Powered by Atlassian Confluence 3.5.13, the Enterprise Wiki