AGO2GO Install instructions for Mac 10.9 to 10...Lantz Newberry 11/07/2016 Page 1 Installing AGO2GO on Mac OS 10.9 to 10.12 This has been confirmed to work with Mac OS X 10.12 "Sierra"

Lantz Newberry 11/07/2016 Page 1

Installing AGO2GO on Mac OS 10.9 to 10.12

This has been confirmed to work with Mac OS X 10.12 "Sierra"

We will be installing and setting up two Mac applications.

The applications are in the folder named “AGO2GO Mac Apps”

Transfer the zipped folder to your Mac's Desktop to unzip it there.

The 2 applications are as follows;

• Citrix Receiver 12.3.0 for Mac OS 10.9 to 10.12

(I’ll use the abbreviation "CR" in the instructions) • NetScaler Gateway 3.1.4 for Mac OS 10.9 to 10.11 or

(I’ll use the abbreviation "NSG" in the instructions) • NetScaler Gateway 3.1.6 for Mac OS 10.12 Sierra

(I’ll use the abbreviation "NSG" in the instructions) NOTE: The Mac app installers end with the suffix (.dmg). A DMG file is a mountable disk image created in Mac OS X. DMG files are commonly used for OS X software installers that mounts a virtual disk on the Desktop when opened. After an installation, you can trash the DMG files.


INSTALLING CITRIX RECEIVER 1. In the Finder double-click the "CitrixReceiver.dmg" file and it will mount a virtual disk (circled in red) on the Mac

Desktop, then a small window will open containing both the uninstaller and installer files.

2. If this is a first- time install, move to step 3.

If you have a previous version of Citrix Receiver double-click the "UNinstall Citrix Receiver.app" file and follow the instructions.

Troubleshooting: You can double-check if all components were uninstalled by following the article called “Manual Removal of Mac Apps – Citrix Receiver, NetScaler Access Gateway and Endpoint Analysis” at the end of these instructions. This is especially important with very old versions because the newer uninstall may miss files.

3. Double-click the "Install Citrix Receiver.pkg" file.


4. Click Continue.

5. Click Continue again.

6. Click Agree and Continue.


7. Click Install.

8. Use your Mac's admin Username and Password if asked.

9. Click Continue.


10. Click Close when the install is finished.


INSTALLING NETSCALER GATEWAY 1. In the Finder double-click the "Citrix_Access_Gateway.dmg" file and it will mount a virtual disk (circled in red)

on the Mac Desktop, then a small window will open containing both the uninstaller and installer files.

2. If this is a first- time install, move to step 3.

If you have a previous version of Citrix NetScaler Access Gateway double-click the "UNinstall Citrix NetScaler Gateway.app" file and follow the instructions.

Troubleshooting: You can double-check if all components were uninstalled by following the article called “Manual Removal of Mac Apps – Citrix Receiver, NetScaler Access Gateway and Endpoint Analysis” at the end of these instructions. This is especially important with very old versions because the newer uninstall may miss files.

3. Double-click the "Install Citrix Access Gateway Plug-in.pkg" file.


4. Click Continue.

5. Click Agree and Continue.

6. Click Install.


7. Use your Mac's admin Username and Password if asked.

8. Click Close when the install is finished.


SETUP CITRIX RECEIVER APP Open the Finder and go to the Applications folder and double-click the "CR" app.

Click on the “CR” name in the menu and choose Preferences.


Under the General tab CHECK the box "Show Receiver in menu bar" and click the red button to close the window.

Click on the “CR” name in the menu and choose Quit “CR.”

Go to the menu bar, click on the “CR” icon and choose Quit.


Setup NetScaler Gateway App Open the Finder and go to the Applications > Citrix folder and double-click the "NSG" app.

If the app doesn’t open, read and follow the last section in these instructions titled NetScaler Gateway Won’t Open!, then return here.

Click on the "Connection:" drop down menu to open the “NSG” Preferences window.


Under the Connections tab add the following settings;

• Connection: AGO2GO • Server address: atg.cag.wa.gov

Click the General tab and CHECK the box "Show “NSG” status in the menu bar" and click the red button to close the window.


Setup Safari Citrix Plug-ins 1. Quit ALL apps 2. Open Safari 3. Go to https://atg.cag.wa.gov (if you get a message to trust the website do so) 4. Go to Safari menu > Preferences 5. Go to Security tab - see screenshot 6. Check: warn when visiting a fraudulent website 7. Check: Enable JavaScript 8. UNcheck: Block pop-up windows 9. Check: Allow WebGL 10. Check: Allow Plug-ins

11. Click the Plug-in Settings… button 12. On the left side make sure you have - see screenshot 13. Check: Citrix AG Mac Plug-in (version 2.0.0.13)

• atg.cag.wa.gov: On (this setting is to trust the website) 14. Check: Citrix Receiver (version 12.3.0)

• atg.cag.wa.gov: On (this setting is to trust the website)

https://atg.cag.wa.gov/


15. Click Done. Close Security window. 16. Go to Safari > Clear History. 17. Choose “all history” and click Clear History button.

18. Quit Safari 19. Logout of Mac account 20. Login to Mac account


LOGIN TO AGO2GO To login to AGO network make sure the Connection is set to AGO2GO in the drop down menu and click Connect.

In a few moments is will ask for your “AGO2GO login credentials,” enter them and click Log On.

Username: Your AGO2GO username provided by ISD should look something like, ATG****100

Password: Use one of these two options depending on what you have;

• If using a keyfob, the password is your PIN plus the FOB numbers displayed (no space). • If using a mobile smartphone token (the RSA application on the phone), the password is just the

numbers displayed (no space).


IMPORTANT: At this window use your “AGO network” username and password to logon (NOT your AGO2GO credentials that were used earlier). These are the credentials you use to logon to your PC when you come to work.

These are the AGO2GO applications.

Use the "Log Off" button to logout before quitting the browser.


NETSCALER GATEWAY LOGIN ITEM To setup the NetScaler Gateway application to open automatically when logging on to your computer.

Go to the Apple icon in the menu and choose System Preferences.

Choose "Users & Groups"


Choose the "Login Items" tab and click the "+" button to add an application.

Navigate to the Applications > Citrix folder, select "NSG" and click the Add button.


NETSCALER GATEWAY WON’T OPEN! If you go to open the NetScaler Gateway app on your Mac and it doesn’t, you are experiencing a known Citrix bug. What’s happening is the Citrix Receiver app is opening in the background instead and preventing NetScaler from opening.

You'll need to quit the CR app first, then open the NSG app. To quit the CR app, use the CR icon in the menu bar and choose Quit. Make sure you're quitting the CR app and not the NSG app. After this initial setup of AGO2GO you will NOT be using Citrix Receiver at all, the only app you will be using is NetScaler Gateway, everything else works in the background.

Tip: For quick access to an app you can drag it from the Applications folder into your DOCK and it will create an alias of the apps. This does not move the app, it should still be in your Applications folder, this just creates a shortcut to open it.


Manual Removal of Mac Apps – Citrix Receiver, NetScaler Access

Gateway and Endpoint Analysis Objective In some cases, after having uninstalled a Citrix application for Mac, certain files might be left behind in the system. This

has mostly been reported after having run earlier versions of an uninstaller. This article describes how to manually

remove the files in order to avoid any unexpected behavior if and when an application is re-installed. This article can

also be used as reference to clean a system after having an older or legacy version of an application uninstalled, and

prior to installing the latest version for Mac.

Remove these folders or files from the Root locations; Macintosh HD > Applications folder

• Delete the Citrix folder (part of NetScaler app) • Delete Citrix Receiver.app application

Macintosh HD > Library > Application Support folder

• Delete the Citrix folder (part of NetScaler app) • Delete the Citrix Receiver folder

Macintosh HD > Library > Internet Plug-ins folder

• Delete AGEPAPlugin.plugin file (NetScaler Citrix Endpoint Analysis Plug-in 2.0.0.11 or earlier). This file can prevent newer plugins from showing in Safari’s Plug-ins window.

• Delete AGNetscapePlugin.plugin file (NetScaler Citrix AG Mac Plug-in 2.0.0.11). This file can prevent newer plugins from showing in Safari’s Plug-ins window.

• Delete CitrixICAClientPlugin.plugin file (Citrix Receiver plug-in). Older versions of this file can prevent newer versions from showing in Safari’s Plug-ins window.

Macintosh HD > Library > LaunchAgents folder

• Delete all files that contain com.citrix…plist

Macintosh HD > Users > Shared folder



Remove these folders or files from the User level locations; Macintosh HD > Users > Account Name > *Applications folder (*found in some older versions of Mac OS X)

• Delete the Citrix folder (part of NetScaler app) • Delete Citrix Receiver.app application

Macintosh HD > Users > Account Name > Library > Application Support folder


Macintosh HD > Users > Account Name > Library > Internet Plug-ins folder

• Delete AGEPAPlugin.plugin file (NetScaler Citrix Endpoint Analysis Plug-in 2.0.0.11 or earlier). This file can prevent newer plugins from showing in Safari’s Plug-ins window.

• Delete AGNetscapePlugin.plugin file (NetScaler Citrix AG Mac Plug-in 2.0.0.11). This file can prevent newer plugins from showing in Safari’s Plug-ins window.

• Delete CitrixICAClientPlugin.plugin file (Citrix Receiver plug-in). Older versions of this file can prevent newer versions from showing in Safari’s Plug-ins window.

Macintosh HD > Users > Account Name > Library > Preferences folder

• Delete all files containing com.citrix.receiver…plist

Documents

AGO2GO Install instructions for Mac 10.9 to 10...Lantz Newberry 11/07/2016 Page 1 Installing AGO2GO on Mac OS 10.9 to 10.12 This has been confirmed to work with Mac OS X 10.12 "Sierra"