We’re smarter together. Learn from this collection of community knowledge and add your expertise.

SAS® University Edition Best Practices: Recommended Configurations and Troubleshooting Techniques

by SAS Employee jennifers_sas on ‎11-17-2014 09:17 AM - edited on ‎08-22-2016 07:57 AM by Community Manager (1,856 Views)

Note: this information also appears on support.sas.com as SAS Note 53791.

 

SAS University Edition is a free educational offering of SAS® products through the SAS® Analytics U program, which is available for teachers, students, independent learners, and academics researchers. This software uses virtualization technology to work locally on your PC, Mac, or Linux workstation.

SAS University Edition relies on the third-party virtualization products VirtualBox and/or VMware Workstation Player in order to operate. Some users report errors while using SAS University Edition that might relate to the setup or configuration of the virtual appliance in these third-party products. Examples of potential issues are listed below.

 

Potential Issues

  • At start-up, SAS University Edition provides a URL in a black terminal-style window, through which you access the Information Center. When attempting to connect to the URL, you might receive a connection error in your web browser. Here are some examples:
    • On Internet Explorer: "The page can't be displayed"
    • On Safari: "Safari can't connect to the server"
    • On Firefox: "Unable to connect"
    • On Chrome: "Oops! Google Chrome could not connect to localhost:10080"
  • You might receive an error when attempting to update your existing SAS University Edition software.
  • When starting SAS University Edition, you might receive an error stating that VirtualBox or VMware Player has encountered an unexpected error.
  • Even if SAS University Edition has worked in the past, it might begin displaying unexpected behavior.

 

Troubleshooting Techniques

Listed below are a series of best practices, recommended configurations, and troubleshooting techniques that might help you resolve errors that you encounter when using SAS University Edition.

Is SAS University Edition Running in the Background?

Ensure that the virtual machine is running for the entirety of your SAS University Edition session. This enables SAS University Edition to establish a connection with your web browser. The virtual machine is running properly if the black terminal-style window is open in the background and is displaying either "localhost:10080" in VirtualBox or a proper IP address in VMware Player.

To start a SAS University Edition session, open the virtualization software and follow the steps below.

  • For VirtualBox: In the Oracle VM VirtualBox Manager, select the SAS University Edition vApp ► Machine ► Start ► Normal Start.
  • For VMware Player: In the VMware Workstation management window, select the SAS University Edition vApp ► Play virtual machine.

Is SAS University Edition Configured Properly?

When importing SAS University Edition, you are prompted with system configuration settings. The SAS University Edition virtual appliance that you downloaded during setup contains data on the default configuration. These default configurations should not be changed. Any adjustments to the default configuration of SAS University Edition are not supported. Changes to the configuration might result in unexpected behavior or failure to launch. Verify that your settings match the highlighted settings in the screenshots below.

For VirtualBox

To access SAS University Edition's configuration settings in VirtualBox, do the following:

  1. Open the Oracle VM VirtualBox Manager.
  2. Once the manager windows comes up, highlight your SAS University Edition instance by single-clicking the list option.
  3. At this point, you should be able to access the setting by selecting the yellow gear labeled Settings in the menu bar. An example of this is shown in the screenshot below.
  4. Once in the appliance settings, navigate through the menus to ensure that your virtual appliance matches the settings shown in the screenshots below.


How-to access VirtualBox settings

General Settings

VirtualBox General

 

Network Settings

VirtualBox Network

 

Processor Settings

VirtualBox Processor

 

Motherboard Settings

VirtualBox Motherboard

 

For VMware Player

To access SAS University Edition's configuration settings in VMware Player, do the following:

  1. Open the VMware Workstation Player management window.
  2. Once the manager windows appears, highlight your SAS University Edition instance by single-clicking the list option.
  3. At this point, you should be able to access the setting by selecting Edit virtual machine settings at the bottom of the screen on the right. An example of this is shown in the screenshot below.
  4. Once in the appliance settings, navigate through the menus to ensure that your virtual appliance matches the settings shown in the screenshots below.


How-to access VMware Workstation Player settings

General Settings

VMware General

 

Network Settings

VMware Network

 

Processor Settings

VMware Processor

 

Motherboard Settings

VMware Memory


Is There a Problem with VirtualBox or VMware Player's Network Adapter?

When you install VirtualBox or VMware Player, the software lays out virtual network adapters that it uses to interface with your system's networking hardware. If the network adapter for your virtualization software was not installed correctly or has been disabled, then SAS University Edition might not be able to connect to your web browser. Verify that your virtual network adapters are enabled and functioning in your system's settings. An example of this can be seen in the screenshot below. TheVirtualBox Host-Only Network adapter represents the virtual adapter installed by VirtualBox, whereas the VMware Network Adapter VMnet1 and VMware Network Adapter VMnet8 adapters are for VMware Player.

Network Adapters


Is There a Problem with My Web Browser's Temporary Files?

SAS University Edition caches data to your web browser's temporary files in order to make SAS University Edition operate more efficiently. In some cases, the temporary files might become corrupted, creating connection or run-time issues while you are accessing SAS® Studio. Try clearing your web browser's cache, cookies, and temporary files, and then relaunch in SAS University Edition. Issues might be specific to the web browser, so try opening SAS University Edition from a different web browser as well. For instructions on how to clear cache, cookies, and temporary files in your web browser, see the following documentation linked below.

Is There a Problem with My Virtual Appliance?

Problems that persist after you have followed these troubleshooting techniques might be caused by a corrupted vApp download or virtual machine. If connection issues persist, redownload and reimport the latest SAS University Edition vApp into your virtualization software. The download and installation process is available on theDownload SAS® University Edition web page. Be sure to follow the QuickStart Guide in order to install SAS University Edition properly.


Additional Support Information for SAS University Edition

Useful SAS University Edition resources are available through these links.

 

SAS University Edition Resources

SAS Notes

  • SAS Note 46250: "When you start SAS® University Edition, an error might occur stating that VT-x or AMD-v is not available"
  • SAS Note 53263: "When you start SAS® University Edition, an error might occur stating that this kernel requires an x86-64 CPU
  • SAS Note 54002: "The error 'The launch of the server process failed...' might occur when you attempt to launch SAS® University Edition"
  • SAS Note 58267: "SAS® University Edition does not start and you are unable to access your data
  • SAS Note 53333: "SAS® University Edition generates errors when local data is accessed
  • SAS Note 54794: "How to read SAS® data sets with different encodings in SAS® University Edition
Comments
by truelotus
on ‎12-08-2014 08:29 PM

I am having this issue. What is vApp???

by truelotus
on ‎12-08-2014 08:30 PM

192.168.253.128 is the url given

by Occasional Learner manish_rauthan007
on ‎12-15-2014 07:13 AM

Have a same issue . How can I resolve this issue

by SAS Employee JosvanderVelden
on ‎12-15-2014 09:56 AM

Your question about vApp is answered more completely in the FAQ : What is a vApp and how does it work?

In short: A virtual application, or vApp, provides a convenient way to use software without the complexity of having to install the software products yourself.

In your second message you mention URL 192.168.253.128. I presume you are using VMware Player and the vApp when started indicates that you should use this URL with http:// in front. Is that correct? Which browser are you using?

Best regards, Jos

by truelotus
on ‎12-18-2014 01:05 PM

Yes, I am using the VMware player, on Chrome. Thanks

by truelotus
on ‎12-18-2014 01:06 PM

oh yes, I  use

http:// in front :smileyhappy:

by SAS Employee JosvanderVelden
on ‎12-18-2014 01:27 PM

In that case I suggest that you open a track with SAS' technical support: Technical Support Form

You could try to execute a "ping 192.168.253.128" and "ipconfig /all" and analyze the result (in a DOS-window).

But that probably won't give much extra information.

I'm sure SAS tech support will resolve your issue.

by truelotus
on ‎12-18-2014 01:29 PM

thanks :smileyhappy: