SAS 9.4 Collection Assistant for Deployment Diagnostics (CADDy) is a PowerShell utility provided by SAS Technical Support to collect information commonly needed to investigate SAS 9.4 installation, configuration, upgrade, and migration issues on Windows environments. The tool identifies the SAS installation and configuration directories, gathers relevant diagnostic data, and packages it into a single ZIP file for submission to SAS Technical Support.

---

What CADDy Collects

• SAS 9.4 deployment information, artifacts, and log files
• Microsoft System Information (Msinfo32.exe) from the machine where SAS 9.4 is installed
• SAS Private Java Runtime Environment functionality test results
• a detailed execution log and collection summary

---

How to Use CADDy

1. Save the script.
   Right-click the collect_diagnostics_s9.ps1 link and select Save link as to save the script to the machine where SAS 9.4 is installed.
   
   
2. Open PowerShell.
   Open PowerShell on the system. Run PowerShell as Administrator to avoid file access issues.
   
   
3. Run the script.
   Note: If PowerShell blocks the script with an execution policy error, the user running CADDy might need to temporarily relax the PowerShell execution policy (for example, set the policy to Unrestricted) before running the script. See Set-ExecutionPolicy for additional information.
   
   Change to the directory that contains the script and run the following:
   .\collect_diagnostics_s9.ps1
   
   Here is an example:
   Windows PowerShell
   PS C:\> cd C:\Users\<user>\Downloads
   PS C:\Users\<user>\Downloads> .\collect_diagnostics_s9.ps1
   
   
4. Acknowledge the notice.
   When prompted, review the diagnostic collection notice. Enter A to proceed or D to cancel.
   
   
5. Locate the output.
   A completion message is displayed when the tool finishes.
   
   Here is an example:
   Windows PowerShell
   CADDy finished successfully.
   You can find the .zip package here:
    C:\Users\<user>\Desktop\CADDy_SAS94_Diagnostics_<machine>_<date-time>.zip
   Press Enter to close this PowerShell window...

The ZIP file is saved to the Desktop of the user running the script. Provide this ZIP file to SAS Technical Support as requested.

---

Command-Line Options

-Help

Prints a short usage guide that explains the available command-line options (with examples) and then exits without running any diagnostics collection.

.\collect_diagnostics_s9.ps1 -Help

-Output

Customizes where the output ZIP file is saved. You can provide either a directory path or a full path including the ZIP file name.

.\collect_diagnostics_s9.ps1 -Output "C:\Support"
.\collect_diagnostics_s9.ps1 -Output "C:\Support\SAS_Diagnostics.zip"

-SpecifySASHome

Allows you to explicitly specify the SAS installation directory (SASHome) instead of being automatically detected.

.\collect_diagnostics_s9.ps1 -SpecifySASHome "D:\Program Files\SASHome"

-EnableManifest

Enables the creation of file-size manifest files. The manifest files contain a list of names and file sizes of all files under each SAS installation and configuration directory. Use this option only if requested by SAS Technical Support.

.\collect_diagnostics_s9.ps1 -EnableManifest

-ExportEvents

Exports the Windows Event Viewer System and Application logs to .evtx files and includes them in the CADDy results ZIP. Use this option only if requested by SAS Technical Support.

.\collect_diagnostics_s9.ps1 -ExportEvents