The SAS environment file named sas-environment.XML defines a set of SAS deployments at your site. Your administrator makes this file available on your organization's network, and can provide you with the file's URL.
A prompt for the SAS Environment URL appears in the SAS Deployment Wizard during a client installation. The value that you need to supply is the URL for a sas-environment XML file that should reside on an HTTP server. Your administrator should provide the URL. If you do not know the value to enter during installation, then you can accept the blank value and select Next. However, the value is needed in order to launch any of the clients that rely on that file, such as SAS Enterprise Miner, SAS® Forecast Studio, or SAS® Model Manager. If an appropriate value is not specified, then the logon screen is not displayed, and errors such as the following are displayed:
The application was unable to load the SAS environment definitions. The file
location or file contents might be invalid.
Please contact your administrator for assistance.
The application cannot find the URL for the file that identifies the SAS environments.
Please contact your administrator for assistance.
Specify the value in the SASHOME/sassw.config file with the SASENVIRONMENTSURL parameter.
For multi-machine installations, use:
http://server_host_name.sas.com:port/SASLogon/sas-environment.xml
"Server_host_name.sas" is the address for the middle-tier or web-tier machine and "port" is the port for your web application server.
For single-machine installations, use:
http://my_host_name.com:port/SASLogon/sas-environment.xml
"My_host_name" is the fully qualified host name of your machine, and "port" is the default port for your web application server. The following is a list of default ports based on the web application server that you are using:
- JBoss – 8080
- WebLogic – 7001
- WebSphere - 9080
For additional details, see SAS(R) 9.3 Intelligence Platform: Middle-Tier Administration Guide.
This error might also occur when your web application server is not started. See this SAS note:36986, "Logging on gives an error: "the application was unable to load the SAS environment definitions..."" for other causes of this error.
Operating System and Release Information
| SAS System | SAS Enterprise Miner | Microsoft® Windows® for x64 | 7.1 | | 9.3 TS1M1 | |
| Microsoft Windows Server 2003 Datacenter Edition | 7.1 | | 9.3 TS1M1 | |
| Microsoft Windows Server 2003 Enterprise Edition | 7.1 | | 9.3 TS1M1 | |
| Microsoft Windows Server 2003 Standard Edition | 7.1 | | 9.3 TS1M1 | |
| Microsoft Windows Server 2003 for x64 | 7.1 | | 9.3 TS1M1 | |
| Microsoft Windows Server 2008 | 7.1 | | 9.3 TS1M1 | |
| Microsoft Windows Server 2008 for x64 | 7.1 | | 9.3 TS1M1 | |
| Microsoft Windows XP Professional | 7.1 | | 9.3 TS1M1 | |
| Windows 7 Enterprise 32 bit | 7.1 | | 9.3 TS1M1 | |
| Windows 7 Enterprise x64 | 7.1 | | 9.3 TS1M1 | |
| Windows 7 Home Premium 32 bit | 7.1 | | 9.3 TS1M1 | |
| Windows 7 Home Premium x64 | 7.1 | | 9.3 TS1M1 | |
| Windows 7 Professional 32 bit | 7.1 | | 9.3 TS1M1 | |
| Windows 7 Professional x64 | 7.1 | | 9.3 TS1M1 | |
| Windows 7 Ultimate 32 bit | 7.1 | | 9.3 TS1M1 | |
| Windows 7 Ultimate x64 | 7.1 | | 9.3 TS1M1 | |
| Windows Vista | 7.1 | | 9.3 TS1M1 | |
| Windows Vista for x64 | 7.1 | | 9.3 TS1M1 | |
| 64-bit Enabled AIX | 7.1 | | 9.3 TS1M1 | |
| 64-bit Enabled HP-UX | 7.1 | | 9.3 TS1M1 | |
| 64-bit Enabled Solaris | 7.1 | | 9.3 TS1M1 | |
| HP-UX IPF | 7.1 | | 9.3 TS1M1 | |
| Linux | 7.1 | | 9.3 TS1M1 | |
| Linux for x64 | 7.1 | | 9.3 TS1M1 | |
| Solaris for x64 | 7.1 | | 9.3 TS1M1 | |
*
For software releases that are not yet generally available, the Fixed
Release is the software release in which the problem is planned to be
fixed.