Error while replacing updated .dll files during a CCS upgrade or content installation

Products

• Control Compliance Suite
• Control Compliance Suite Standards Server

Issue/Introduction

Control Compliance Suite (CCS)

When you upgrade CCS 12.5.x components or contents, it is possible that some .dll files in the installation package are not upgraded if they are currently in use or locked at the time of the upgrade or installation. The error details are visible only in the installation logs, but no error message is displayed on the installer during the installation process.

Environment

CCS 12.5.x Product Update (PU) upgrades or Security Content (SCU) upgrades

Resolution

From SCU 2017-3 onwards, if a .dll file is not replaced successfully during CCS upgrade/installation, the following error message is displayed:

Error while copying the file <filename>. Refer to the installation logs for details.

The file can be located at the temporary location: <file location>. Copy the file, and then delete it from the temporary location.

Example of the error below: (the same error will still occur in CCS 12.5.x)

                                                DLL file installation error

 

Moreover, the Undeployed Files folder is created at the following location:

<CCS Installation Directory>\Symantec\CCS\Reporting and Analytics\UnDeployedFiles

This folder contains the .dll files that are not replaced because they are in use by another process during the upgrade/installation. The folder also contains the Details.txt file. The Details.txt file provides the following information:

• Date and time when the UnDeployedFiles folder was created
• Name of the .dll file that is not installed successfully
• Location where the .dll file needs to be replaced

You must manually replace the .dll files at the respective locations. To replace the undeployed .dll files, do the following:

1. Before replacing the .dll files, stop the Symantec Application Server Service and the Symantec Data Processing Service.
2. Copy the .dll files from the Undeployed Files folder.
3. Replace the files to the respective locations.
4. Start the Symantec Application Server Service and the Symantec Data Processing Service.
5. Delete the Undeployed Files folder.