42646 - Troubleshooting the SAS® 9.3 installation process in a Windows operating environment

Installation Note 42646: Troubleshooting the SAS® 9.3 installation process in a Windows operating environment

When you install SAS 9.3, several files are created that can help you troubleshoot any installation and configuration issue that might occur. The most important files are

SDWPREFS.txt
SDW.log
DEPLOYMENTSUMMARY.html
IT.log
DEPLOYWIZ.log
SDM.log
system.info

If you open a track with SAS Technical Support, be sure to include these files in order to facilitate the troubleshooting process. If only some of these files are available, send what you have and document that these are the only files that were created.

The following table shows where you can find the relevant files.

Windows Edition	Location	Files
Windows XP Windows 2003 Server	%USERPROFILE%\Local Settings\Application Data\SAS\SASDeploymentWizard\	DEPLOYWIZ.log DEPLOYMENTSUMMARY.html SDWPREFS.txt SDW.log SDM.log SDW_sysinfo.log
Windows Vista Windows 7 Windows 2008 Server	%USERPROFILE%\AppData\Local\SAS\SASDeploymentWizard\	DEPLOYWIZ.log DEPLOYMENTSUMMARY.html SDWPREFS.txt SDW.log SDM.log SDW_sysinfo.log
Windows XP Windows Vista Windows 2003 Server Windows 7 Windows 2008 Server	C:\Program Files\SASHome\InstallMisc\InstallLogs\	IT.log DEPLOYMENTSUMMARY.html <12-byte>_preexec.log <12-byte>_postexec.log

Logs That Are Created in the SAS InstallMisc Directory

For SAS 9.3, several logs are created in the SAS InstallMisc Directory (that is, c:Program Files\SASHome\InstallMisc\InstallLogs\9.3). For example:

C:\Program Files\SASHome\InstallMisc\InstallLogs\IT_date-time-stamp.log
Note: The IT log provides very extensive and detailed error messages that along with the information from the SDW.log file and are extremely important and helpful in narrowing down installation issues.

C:\Program Files\SASHome\InstallMisc\InstallLogs\deploymentsummary.html

The DeploymentSummary_date-installed_time-installed.html file: This file provides a summary of the installation, including whether the installation was successful or whether it completed with warning or error messages. Here is a sample of what it might contain:

Deployment Summary for 2011 Mar 08 09:54:13
System Requirements
Completed successfully - Microsoft Visual Studio Tools for Office 8.0
Completed successfully - Microsoft Visual Studio Tools for Office 9.0

Installation
Completed successfully - SAS Deployment Manager
Completed successfully - SAS/SECURE Java Component
Completed successfully - SAS Enhanced Editor (English)
Completed successfully - Base SAS JAR Files
Completed successfully - Base SAS Help and Documentation
Completed successfully - SAS Deployment Tester - Client
Completed successfully - SAS Enterprise Guide (English)
Completed successfully - SAS Add-in for Microsoft Office (English)
Completed successfully - Report Fonts for Clients
Completed successfully - SAS Disk Cleanup Handler (English)
Completed successfully - SAS Install Qualification Tool
Completed successfully - Install Post Processing

C:\Program Files\SASHome\InstallMisc\InstallLogs\<12-byte>_version_platform_language_preexec.log
C:\Program Files\SASHome\InstallMisc\InstallLogs\<12-byte>_version_platform_language_postexec.log

Files That Are Created in the SASDeploymentWizard Directory

For SAS 9.3, several files are created in the SASDeploymentWizard directory (that is, C:\Users\sas\AppData\Local\SAS\SASDeploymentWizard). Here are some of the files that are stored in this directory:

The sdwprefs.txt file: This file contains the choices or preferences that you used during the installation (for example, the location of the SASHOME directory). Here is an example of what it might contain:

 
#Tue Mar 08 14:47:16 EST 2011
SASHome=C\:\\Program Files\\SASHome
MachineName=One Machine
LastSSDDir=C\:\\SAS Software Depot
LastProjDir=C\:\\SAS\\installFiles\\plan.xml
LastSidFile=C\:\\ssd_32bit_93\\sid_files\\SAS93_012345_12345678_Win_Wrkstn_Srv.txt

The SDW.log file: This log is for the SAS^® Deployment Wizard. Here is a sample of what it might contain:

  
INFO: Command Arguments: -templocation C:\Users\sas\AppData\Local\Temp\_setup24047 -startuplocation C:\ssd_32bit_93
INFO: Platform Code: win
INFO: :C:\Users\sas\AppData\Local\Temp\_setup24047\products\deploywiz__93340__prt__xx__sp0__1\deploywiz\win\sse2check.exe:
INFO: System Properties
      User ID:          sas
      User Home:        C:\Users\sas
      Temp Directory:   C:\Users\sas\AppData\Local\Temp\
      Java Version:     1.6.0_24
      Java Home:        C:\Users\sas\AppData\Local\Temp\_setup24047\products\javaruntime__99170__win__xx__sp0__1
      OS Name:          Windows 7
      OS Architecture:  x86
      OS Version:       6.1
      Software Version: 903500.0.0.20110223190000_v930

The SDW_sysinfo_date-installed_time-installed.dat file (for example, SDW_sysinfo_20090327_012345.dat) file: This file contains the information about the system and the SAS products that are installed on your system. Here is an example of what it might contain:

SAS Sysinfo Log: 20110308_102738
SDW version: 903500.0.0.20110223190000_v930

   Product_Name=base
   Version=9.3
   Host=win
   InstallTime=2011-03-08 10:01:49
   OrderNum=012345
   Setnumid=12345678
   DisplayName=Base SAS
   InstallLoc=C:\Program Files\SASHome\SASFoundation\9.3
   InstallGUID=null
   InstallStatus=0
   ServicePack=null


   CPU=Intel(R) Core(TM)2 CPU          6400  @ 2.13GHz
   CPU_Architecture=0
   CPU_Family=6
   CPU_Model=15
   CPU_Stepping=2

   OS=Professional  (Build 7600)
   OSVersion=6.1
   OSBuildNumber=7600
   OSPlatformId=2
   OSCSDVersion=

System Information (SYSTEM.info)

In addition, send the System Information by using these steps:

Select Start ► Run and type msinfo32.exe.
When the system information appears, select File ► Save and type system for the name and then send the system.nfo file that is created.

Additional Logs That SAS Technical Support Uses to Help You

For SAS 9.3, here are some additional logs that SAS Technical Support might use to help when you have performed a planned installation and run into problems:

The Configuration Logs, in ConfigDir\LevelDir\Logs\Configure
For example: C:\SAS\Config\Lev1\Logs\Configure
The plan file, properties files, and .bat files used for configuration, in ConfigDir\LevelDir\Utilities

For example: C:\SAS\Config\Lev1\Utilities

The plan.xml will be named plan.year-month-day-hour-minute.xml

For example: plan.2011-03-17-03.33.xml

The Server Logs:

The logs for SAS server are found in their respective configuration directories. For example, the metadata server logs are found here:

ConfigDir\LevelDir\SASMeta\MetadataServer\Logs

For example: C:\SAS\Config\Lev1\SASMeta\MetadataServer\Logs

The Web Application Logs:

The logs for Web applications are typically found here:

ConfigDir\LevelDir\Web\Logs

For example: C:\SAS\Config\Lev1\Web\Logs

The Instructions.html, the DeploymentSummary.html, and the ConfigurationErrors.html, which are found here:

ConfigDir\LevelDir\Documents

For example: C:\SAS\Config\Lev1\Documents

For More Information about Logging

See SAS® 9.3 Logging: Configuration and Programming Reference.
For information about SAS 9.2 (TS1M0), see Usage Note 31627 "Logs that can be used to troubleshoot the Phase 1 SAS® 9.2 (TS1M0) installations."
For information about SAS 9.2 (TS2M0), see Installation Note 35426 "Logs that can be used to troubleshoot the SAS® 9.2 (TS2M0) installations."
For information about SAS 9.3 for the z/OS operating environment, see Installation Note 43606 "Locating the log files for SAS® 9.3 installations in the z/OS operating environment."

Operating System and Release Information

Product Family	Product	System	Product Release		SAS Release
Product Family	Product	System	Reported	Fixed*	Reported	Fixed*
SAS System	Base SAS	z/OS	9.3		9.3 TS1M0
		Z64	9.3		9.3 TS1M0
		Microsoft® Windows® for x64	9.3		9.3 TS1M0
		Microsoft Windows Server 2003 Datacenter Edition	9.3		9.3 TS1M0
		Microsoft Windows Server 2003 Enterprise Edition	9.3		9.3 TS1M0
		Microsoft Windows Server 2003 Standard Edition	9.3		9.3 TS1M0
		Microsoft Windows Server 2003 for x64	9.3		9.3 TS1M0
		Microsoft Windows Server 2008	9.3		9.3 TS1M0
		Microsoft Windows Server 2008 for x64	9.3		9.3 TS1M0
		Microsoft Windows XP Professional	9.3		9.3 TS1M0
		Windows 7 Enterprise 32 bit	9.3		9.3 TS1M0
		Windows 7 Enterprise x64	9.3		9.3 TS1M0
		Windows 7 Home Premium 32 bit	9.3		9.3 TS1M0
		Windows 7 Home Premium x64	9.3		9.3 TS1M0
		Windows 7 Professional 32 bit	9.3		9.3 TS1M0
		Windows 7 Professional x64	9.3		9.3 TS1M0
		Windows 7 Ultimate 32 bit	9.3		9.3 TS1M0
		Windows 7 Ultimate x64	9.3		9.3 TS1M0
		Windows Vista	9.3		9.3 TS1M0
		Windows Vista for x64	9.3		9.3 TS1M0
		64-bit Enabled AIX	9.3		9.3 TS1M0
		64-bit Enabled HP-UX	9.3		9.3 TS1M0
		64-bit Enabled Solaris	9.3		9.3 TS1M0
		HP-UX IPF	9.3		9.3 TS1M0
		Linux	9.3		9.3 TS1M0
		Linux for x64	9.3		9.3 TS1M0
		Solaris for x64	9.3		9.3 TS1M0

* 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.

Type:	Installation Note
Priority:	high

Date Modified:	2011-07-12 12:37:16
Date Created:	2011-03-09 13:45:36