How to Use Apps@UT Office of Information Technology (865) 974-9900 Contents Introduction... 1 Available Software & License Limitations... 1 License information... 1 Software... 1 Session Timeout Limits... 2 User File Storage and Disk Space Limits... 2 Using the Apps@UT System... 3 Logging In from Windows or Macintosh Computers... 3 Using Applications... 5 Saving Files on Apps.utk.edu... 5 Programming Details... 6 Printing... 6 Error Messages and Known Problems... 6 Introduction Apps@UT, located at https://apps.utk.edu, is our cloud computing solution which allows you to run software remotely, without actually having that software installed on your own computer. You can use this system from any Windows, Macintosh or Linux computer. We will soon update our HelpDesk Knowledgebase with instructions for configuring clients for Apple or Android mobile devices. The software will run on remote servers, but will display on your own device in such a way that you can interact with it just as though you had installed it locally. It is very easy to use since you can open and save files stored on your computer and print to your own printer. UTK faculty, staff and students can receive assistance using Apps@UT by calling the OIT HelpDesk 974-9900, or use our walk-in service at The Commons (Hodges Library). If you are using the research tools on the server, we can also help you analyze data in the form of numbers, text or images. See http://oit.utk.edu/research for details. Available Software & License Limitations License information All the software on Apps@UT is for university academic work only. Administrative users (i.e. those in departments which do not grant degrees) must use an administrative SAS license on their own PCs. Any users assisting outside organizations, either for-profit or non-profit, must contact the vendor for information regarding commercial licensing. Work for government agencies whose main mission it is to provide grants, such as the NSF and NIH is allowed. However, work for most other federal and state government agencies is not. Software The software currently available on Apps@UT is listed below. Following each name in parentheses is the maximum number of people who can use each package or the letters SL if a site license is in place that allows us to avoid such limits. Software site licenses often allow you to install an individual copy on your computer too (SAS and SPSS
Modeler are exceptions; see http://oit.utk.edu/software for details). The code OS stands for Open Source. Such software is free so we do not need to limit the number of executions. You can also install it on your own machine. For descriptions of the research software, the locations of any tutorials or online manuals as well as how we can help you use each package, see our web page: http://oit.utk.edu/research/software. Text Analysis ATLAS.ti (5), QDA Miner (SL), Simstat(SL), WordStat (SL) Statistics & Data Mining Amos (SL), EQS (2), HLM (2), JMP (SL), LISREL (2), Mplus (1), R (OS), SAS (SL), SAS Enterprise Guide (SL), SAS Enterprise Miner (SL), SAS Text Miner (built into Enterprise Miner, SL), SPSS (SL), SPSS Complex Samples (2), SPSS Modeler(SL), Stata MP (14), SUDAAN built into SAS (1), SUDAAN stand alone (1). Science & Engineering HSC Chemistry (10), ImageJ (OS), MATLAB (SL), MATLAB Toolboxes (SL) [See http://oit.utk.edu/matlab], Maple (SL), Mathematica (8), Mestrenova (5), Origin (3), Scientific Notebook (10), SigmaPlot (6), SigmaScan (1), Simulink (SL), Session Timeout Limits To ensure that a copy of the software is available when you need it, sessions will be disconnected after 60 minutes of inactivity. To prevent loss of work, save often! The system will warn you that your session is timing out which will give you time to take any action to reset the timer (e.g. drop down a menu). If you notice that you have just been disconnected from the system, logging on again within 10 minutes will restore your session and no work will be lost. Since the timer is based on interactive use, long-running batch jobs are also killed by default. If you need to run a job non-interactively for more than one hour, call us to make special arrangements. User File Storage and Disk Space Limits Apps@UT uses the My Documents folder on T-Storage, OIT s network-accessible file storage system. If you are faculty or staff and in Active Directory, this should also appear as your H: drive. Personally owned computers will not be in active directory but you can mount this file space by following these instructions. It is important to name the drive H: when you do this: T-Storage mounting instructions for Windows: oit.utk.edu/helpdesk/kb/entry/1976 T-Storage mounting instructions for Macintosh: oit.utk.edu/helpdesk/kb/entry/1975 T-Storage mounting instructions for Linux: http://oit2.utk.edu/helpdesk/kb/entry/2007
Using the Apps@UT System Logging In from Windows or Macintosh Computers 1. Download and install the Citrix Receiver (or Online Plugin for older Macs) for your computer from: o Windows & Mac OS https://webapps.dii.utk.edu/softwaredistribution/login.aspx o Linux OS http://www.citrix.com/clients o Mobile Devices http://www.citrix.com/clients You only need to do this once for each computer you use. 2. After installing the Citrix Receiver, reboot your computer. 3. Use the browser of your choice to go to http://apps.utk.edu and the following window will appear: 4. Fill in your UT NetID and password then click Log On. 5. If the following window appears, you may have skipped step #1 above. Click on the Install button to get the Citrix Receiver. If you have installed the application, click on Skip to Log on.
6. Your browser will take you to the OIT Software Download website for the instructions listed in Step 1. 7. When the receiver is installed, point your browser again to http://apps.utk.edu and log in. If prompted to install, click Skip to Log In. Once you are authenticated, the following screen will appear, offering you folders to choose. Click on any folder once to open it. 8. I clicked on the Statistics & Data Mining folder and the following screen appeared. It offers to let you start any application with a single click of your mouse.
Using Applications You start an application with either a single click on its icon in your browser (Windows or Mac users). Soon after you start an application, it will ask you for permission to use your computer s disk drives: In most cases you will want to choose Permit use so the server can both read and write files to your local computer drives. If instead you choose to Block access, then you will have to use the applications on Apps@UT to store your files in your T-Storage area. When you make your choice, the application will then start. If you choose to Block Access, OIT does not recommend checking the box Do not ask me again for this site. Once this option has been selected, you will not be prompted again. Saving Files on Apps@UT You need to learn a few tips about saving files when working on Apps@UT. These appear confusing at first, but most people quickly adjust. OIT recommends saving files from Apps@UT to the My Documents folder in your T- Storage home area. This data will be backed up automatically each night, but we strongly recommend backing up your own data frequently and storing the copies in separate buildings.
When you try to save a file, you may be prompted with the following screen. You must choose how Apps@UT will interface with your local computer (not T-Storage) Block Access Cannot access your local computer from Apps@UT Allow Reading Read only access to your local computer from Apps@UT Permit all accesss Access to your local comptuer from Apps@UT (Recommended) In addition to saving files, you can move files to and from the server in any application by using File>Open to open a file from one system and then save it to the other using File>Save As. If you have your T-Storage area mounted as a drive on your own computer, moving files to and from the server consists of simply moving files to and from your H: drive. If you have trouble mounting the H: drive, you can instead move files by using the Explorer located in the server s Utilities folder. It is best to avoid this approach if possible because you use up another server license as long as the server s copy of Explorer is open. Programming Details Programmers must refer to the location of their files using a path. Apps@UT has your T-Storage area mounted as an H: drive. If you mount your T-Storage area to your own computer, you should also mount it as H: so a program will run in either place without changes. The name H: is actually a drive mapping for the UNC path of \\tshome.utk.tennessee.edu\~\. From Apps@UT, your computer s main drive will be named \\client\c$\. For example, Windows 7 users could refer their My Documents area as \\client\c$\users\account\my Documents, where Account is what you login to your computer with (i.e. not your UT NetID). Printing The Apps@UT system does not have printers. Instead, it prints to your default printer. When you choose Print from the File menu, you will see your default printer in the Print dialog box. To change that printer, you must change your own computer s default printer. On Windows computers, choose Devices and Printers from the Start menu, then right click on the printer you want and choose Set as default printer. The next time you print from the server, your new default printer will appear. Error Messages and Known Problems This section documents common error messages, known problems and the best ways to deal with them.
Credentials: If you try to logon and see, ERROR: The credentials supplied were invalid (or expired). First, make sure that UTK is listed as the domain in the Login screen. If you continue to have problems, contact the HelpDesk at 974-9900. Cookies: If you get a message saying to flush your browser s cookies do so following these directions: http://oit2.utk.edu/helpdesk/kb/entry/1977. If you still have problems try starting a private browsing window in your browser (called incognito in Chrome) and go to https://apps.utk.edu from that. Blank Screen, Access Denied, etc.: If you get a message saying your access is denied or the page for the application simply does not appear, you may need to add https://apps.utk.edu to your browser s list of trusted sites. In Internet Explorer, you can do this from the menu Tools> Internet Options> Security> Trusted Sites> Sites> Add. In Firefox, this is done from the menu Firefox> Options> Options> Security> Exceptions. Chrome: Customize and Control> Options> Under the hood> Network> Change Proxy Settings> Security> Sites> Add Pop-up Blockers: If you have problems starting any particular application, check to see if you have a pop-up blocker active. If so, you can add https://apps.utk.edu as a trusted site. In Internet Explorer, you can do this from the menu Tools> Internet Options> Pop-up Blocker> Settings> Address of website to allow> Add. In Firefox, this is done from the menu Tools> Options> Content> Block Popup Windows> Exceptions. Chrome: Customize and Control> Options> Under the hood> Network> Change Proxy Settings> Privacy> Pop-up Blocker> Settings> Add. Can t Access Your Local Hard Drive. Usually when you connect to Apps, it asks you for access to your local hard drive. If you choose Block Access and check the box saying Do not ask me again for this site then you will not be able to write to your local hard drive and it will never ask you again. Windows users can fix this by following the steps listed at http://support.citrix.com/article/ctx128775. Mac users can run the Citrix Viewer, go to Preferences and change the setting there. More than one instance. The message below tells you that you can only run one copy of any software on the server. If you accidentally open another, it will give you this message. It also appears when you don t log out and the application continues to run even though you don t see it on your screen. It will usually clear up when the application is terminated after 60 minutes. EQS cannot find its example files. We recommend downloading the demo version of EQS at http://www.mvsoft.com/ to any drive you have write access to. From there EQS will be able to read them.