Problem

When you apply maintenance or update a deployment update, the process might fail. When this happens, a failure message is generated that simply states that the server was not started.  Here are some examples of  errors that are returned:

The problem occurs if you have previously run the update host-name references tool on your environment and the update contains any of the following SAS Data Management products:

• SAS^® Data Remediation Data Server
• SAS^® Job Monitor Data Server
• SAS^® Federation Server

Determine Whether This Is the Problem

To determine whether the reason your servers are not starting is because of the issue described in this note, see the updateConfigure log associated with each product. Search for the phrase BUILD FAILED.  A few lines above this phrase, note the host name of the server that the update task is trying to reach. If the name referenced is the host name from before you ran the update host-name reference tool, then the solution provided in this note must be applied to your system to proceed with the update.

Note: Configuration logs are stored in the SAS-configuration-directory/Lev1/Logs/Configure directory. The exact log location on your system is provided as a link in the error-message window that is presented by SAS^® Deployment Manager.

Solution

If SAS Deployment Wizard is on the first error page and it is still running, complete the steps below and click Retry.

If, instead, you have cleanly exited SAS Deployment Wizard at the first start-up failure, then complete the steps below and run the update again by launchingSAS Deployment Manager and selecting Update Existing Configuration.

Note:  If you did not skip a failure, then you should be able to run the update again without needing to revert to the configuration to your last known backup first. If, however, you skipped any errors that are unrelated to the specific issues in this note or you chose to skip start-up failures covered in this note, then you should revert the configuration to your last known backup, complete the steps below, and begin the update again from that point. 

1. Data Remediation Data Server:
   1. Click the Downloads tab and download the XML file for SAS Data Remediation Server.
   2. Use FTP or normal transfer tools to transfer the *_dmrmdtdsvrc_config.xml file to the SASHome/SASDataRemediationDataServer/2.3/Config directory on the SAS compute machine where this product is installed.
   3. Rename the existing dmrmdtdsvrc_config.xml file to SN60586.dmrmdtdsvrc_config.xml.
   4. Rename the downloaded file to dmrmdtdsvrc_config.xml. 
       
2. Job Monitor Data Server:
   1. Click the Downloads tab and download the XML file for SAS Job Monitor Server. 
   2. Use FTP or normal transfer tools to transfer the *_jobmntrdsvrc_config.xml into the SASHome/SASJobMonitorDataServerConfiguration/2.2/Config on the SAS compute machine where this product is installed.
   3. Rename the existing jobmntrdsvrc_config.xml to SN60586.jobmntrdsvrc_config.xml.
   4. Rename the downloaded file to jobmntrdsvrc_config.xml.
       
3. SAS Federation Server:
   
   1. Launch SAS^® Management Console and connect to the SAS^® Metadata Server.
   2. Expand Environment Management and Server Manager.
   3. Right-click Federation Server Old_HostName Lev1 - Logical server and select Properties.
   4. Update just the host name portion of this field, replacing the short name of the old host name with the short name of the new.
   5. Click OK to save and exit the server object’s properties.

Operating System and Release Information

Note: The fixes in this SAS Note assume that you are updating to SAS 9.4 maintenance 4 at revision 17w16 or later. If you are updating to any release prior to revision 17w16, do NOT use the files below. Instead, contact SAS Technical Support.

Select a product to download the manual patch:

SAS Data Remediation Data Server

SAS Job Monitor Data Server