SAS^® Deployment Wizard reports an error similar to the following when issues occur with loading the files inside your SAS Software Depot:

Note: The error message path can vary.

This issue occurs prior to the start of the following:

• Installing your SAS^® 9.4 Foundation Software
• Adding products to an existing deployment
• Performing an Update-in-Place (UIP) to an existing deployment

Inspecting the SDW_[Date-Time].log file that is referenced in the error message displays varying messages similar to any of the following:

WARNING: Error loading hot fix package file: [...].zip

WARNING: There were no valid hot fixes in the hot fix package: [...].zip

WARNING: Error occurred while processing hot fix package file: [...].zip

And ending with:

SEVERE: One or more required hot fix packages could not be loaded. See warnings in log entries above. The Deployment Wizard cannot continue.

In addition, the deploywiz_[Date-Time].log file that is created in the same directory might contain more details about the specific failure (but not in all conditions). Here is an example:

INFO: ExeProc::ReadFromPipe=Standard output
java.util.zip.ZipException: zip END header not found

Cause

A SAS Software Depot typically contains Hot Fixes that were downloaded with an Order via SAS^® Download Manager or added afterward by using SAS Deployment Wizard as well as a manifest (hot_fix_index.xml), which tracks the Hot Fix packages inside.

If any of the expected Hot Fix .zip files within the Software Depot's 'hot_fix' directory are missing or damaged, SAS Deployment Wizard halts with the error message, followed by the path to the log file to inspect: SDW_[Date-Time].log.

This issue is frequently caused by two scenarios:

• Errors downloading Hot Fix files to the SAS Software Depot
  • Via the SAS Download Manager (ESD Client) 
    • Errors occur downloading one or more Hot Fix files after the main Order files complete.
      
      
  • Via SAS Deployment Wizard
    
    • Download errors occur when checking for available Hot Fixes via the SAS Deployment Wizard Retrieve Hot Fixes option under Manage SAS Software Depot.
      
      
• Hot Fix Files are removed/damaged from the SAS Software Depot
  • While the SAS Software Depot was copied or at rest, files in the 'hot_fix' directory were corrupted or not copied. 
  • Hot Fix files were removed (un)intentionally from the 'hot_fix' directory.

Resolution

To resolve this error, you must restore the missing or corrupted Hot Fix files to the Depot.

Complete the following steps to resolve this issue, which are acceptable to the majority of SAS 9.4 deployments. However, see the Multi-Server/Tiered Environments section for Planned deployments and other considerations.

Step 1: Run the SAS Software Depot Check Utility to ensure the integrity of your Software Depot.

To resolve the above error, you should first check the integrity of your base Order (the main part of your SAS Software Depot). If the main Order's files are intact, you should not need to re-download your entire Order again.

Run the SAS Software Depot Check Utility

1. Complete the instructions in Checking Your SAS Software Depot.
   1. If no issues occur in the output report, continue to the next section
      Note: You can ignore any expected files (like old SID/License .txt files) that were removed intentionally.
      
      
   2. Complete this step only if missing or damaged files occur in the output report.
      1. Copy/Download your SAS Software Depot to the machine again and re-check it for issues. If an error occurs, see the Download Errors section. 
         Note: If the download completes without any errors, you can skip the remaining steps and try your action again.

Step 2: Remove existing Hot Fix files from the Depot.

Once you verify that there are no issues with your SAS Software Depot's (main Order) files, begin clearing the Depot's Hot Fix files and folders.

Remove the Hot_Fix Files/Folders

1. Open your File Explorer of choice.
2. Navigate to your SAS Software Depot folder. (For example, C:\SAS Software Depot\.)
3. Open the 'hot_fix' directory.
4. Delete the entire contents (any files or subfolders) of the 'hot_fix' directory.

Step 3: Re-download available Hot Fixes to your SAS Software Depot.

Now that you removed the Hot Fix files and folders from your Depot, use SAS Deployment Wizard to re-populate them.

Important Note: See the Multi-Server/Tiered Environments section for single-machine/environment installation.

Retrieve the latest (install) critical Hot Fixes available via SAS Deployment Wizard

1. Launch SAS Deployment Wizard (setup.exe and so on) from your SAS Software Depot.
   1. Choose Manage SAS Software Depot.
   2. On the next screen, click Retrieve Hot Fixes.
   3. Follow the remaining prompts until complete and close SAS Deployment Wizard.
      If you an error occurs, see the Download Errors section.

After completing all these steps, you should be able to re-try the Deployment or Update-in-Place action with SAS Deployment Wizard.

Additional Information

Download Errors

If errors occur during the (re-)download of your Order or Hot Fix files, have your I.T. or Network Security team review SAS KB0036237, "SAS^® Electronic Software Delivery might require server exclusions to pass through a firewall." Network security hardware and local software security solutions have been known to interfere with the download process even if they are not being explicitly blocked.

If issues still occur, contact SAS Technical Support for additional assistance.

Multi-Server/Tiered Environments

If your deployment contains multiple servers, such as Dev/Test and Production Environments that are required to stay in sync, or if you are performing Install/Update activity on multiple server tiers within the same environment, it is important that the same Hot Fixes are applied to each installation. Downloading the latest Hot Fixes via SAS Deployment Wizard from SAS could change the available Hot Fixes that would be applied. 

Contact SAS Technical Support for additional guidance in this situation.