Installation Note 70020: An upgrade in place to SAS® 9.4M7 on Microsoft Windows fails with an "unexpected error" during a SAS Web Server configuration
During an upgrade in place (UIP) on a Microsoft Windows system from a previous maintenance release to SAS 9.4M7 (TS1M7), the SAS® Deployment Manager fails during a SAS Web Server configuration. This issue occurs if the CustomLog directive in the <SAS-configuration-directory>\Levn\Web\WebServer\conf\extra\httpd-ssl.conf file is split across multiple lines. As a result, the following error occurs:
An unexpected error occurred. Please refer to <SAS-configuration-directory>\Levn\Logs\Configure\vfabrcersvrc_startMidtierServers_<date>.log for more details.
When you inspect that file, the following error occurs:
[webserverTarget] [exec] AH00526: Syntax error on line 324 of D:/SAS_Config/Lev1/Web/WebServer/conf/extra/httpd-ssl.conf:
[webserverTarget]
[webserverTarget] [exec] Invalid command '%t %h %{SSL_PROTOCOL}x %{SSL_CIPHER}x "%r" %>s %b', perhaps misspelled or defined by a module not included in the server configuration
[webserverTarget]
[webserverTarget] [exec] Result: 1
This error occurs because the first line of the CustomLog directive in the httpd-ssl.conf file is being deleted. For example, the CustomLog directive might look similar to the following in a httpd-ssl.conf file:
# CustomLog "C:/SAS/BIserver/Lev2/Web/WebServer/logs/ssl_request.log" \ # if uncommenting, remove characters after backslash
CustomLog "||C:/Program\ Files/SASHome/SASWebServer/9.4/httpd-2.4/bin/rotatelogs.exe -l C:/SASConfig/Lev1/Web/WebServer/logs/ssl_request_%Y-%m-%d-%H.%M.log 50M" \
"%t %h %{SSL_PROTOCOL}x %{SSL_CIPHER}x \ "%r\ " %>s %b"
During the UIP, the first uncommented line is being deleted from the file, causing the error that occurs in the startMidtierServers_<date>.log file. To circumvent this issue, complete either of the following workarounds:
- Copy the deleted line back into the httpd-ssl.conf file from a file backup.
- If you do not have a backup, abridge the above excerpt to match your environment.
Operating System and Release Information
SAS System | SAS Web Server | Microsoft® Windows® for x64 | 9.4 | 9.4 | 9.4 TS1M0 | 9.4 TS1M8 |
*
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.
When performing an Upgrade in Place on Microsoft Windows to SAS 9.4M7 (TS1M7), the SAS® Deployment Manager fails during the SAS Web Server configuration "An unexpected error occurred. Please refer to ...\Logs\Configure\vfabrcersvrc_startMidtierServers_
.log for more details.
Type: | Installation Note |
Priority: | medium |
Date Modified: | 2023-05-04 15:49:34 |
Date Created: | 2023-04-13 13:48:20 |