DLP Agent installation general overview

book

Article ID: 204350

calendar_today

Updated On:

Products

Data Loss Prevention Endpoint Suite

Issue/Introduction

DLP Agent installations are mainly comprised of the following 3 categories:

  • Clean Installation
  • Upgrade Installation
  • Hotfix/Patch Installation

 

This article will cover DLP Agent installation best practices and procedures. The steps may be adapted for automated deployment with management tools such as Symantec ITMS.

Uninstalling the DLP Agent is covered in the following article: Uninstall and remove the Symantec DLP Endpoint Agent

Environment

DLP 15.x

Resolution

Clean Installation

This applies to installing the DLP Agent on an endpoint machine where the DLP Agent is not currently installed.
  1. Package the desired Agent MSI using the Enforce Console.
    1. In the Enforce Console, navigate to System -> Agents -> Agent Packaging
    2. Complete the packaging wizard steps.
  2. Extract the files from the zip package you created in step 1.
  3. Open an Administrator command prompt and change directory to the location of the extracted package files.
  4. Execute install_agent.bat

Upgrade Installation

This applies to upgrading an existing agent installation to a newer Release Version or newer Maintenance Pack.
For example, upgrading from 15.5 GA to 15.5 MP2 HF22, or upgrading from version 15.5 GA to 15.7 GA, or 15.7 GA to 15.7 MP1
  1. Package the desired Release or Maintenance Pack Agent MSI using the Enforce Console (see step 1 in the Clean Installation section above)
  2. Extract the files from the zip package created in step 1
  3. Open an Administrator command prompt and change directory to the location of the extracted package files.
  4. Execute upgrade_agent.bat

Hotfix/Patch Installation

This applies to installing a hotfix MSI on an existing agent installation that is on the same Release Version and Maintenance Pack level as the hotfix.
For example, patching from 15.5 GA to 15.5 GA HF1, or patching 15.7 MP1 to 15.7 MP1 HF1
  1. When you receive a hotfix MSI package, it will typically have a name similar to one of the following examples:
    1. AgentInstall-x64_15_5.msi
    2. AgentInstall-x64_15_7.msi
      1. N.B. Take note of the actual MSI file name you used to deploy the currently installed agent. For example, if you used "AgentInstall-x64_15_5_MP2.msi" to deploy the existing agent, you need to use that exact same name in the <MSI_Filename>.msi token in the patch_agent.bat file below or the patch installation will fail.
  2. Create a patch_agent.bat file using Windows Notepad with the following command line, replace the <MSI_Filename>.msi token with the correctly determined name as discussed above - in most cases you will not change the file name.
    msiexec /i <MSI_Filename>.msi /q LOGDETAILS="Yes" /L*v %SystemDrive%\patchAgent.log REINSTALL=ALL REINSTALLMODE=vomus
  3. Place the Agent MSI file containing the fixes you need to deploy into the same directory with the patch_agent.bat file.
  4. Open an Administrator command prompt and change directory to the location of the MSI and patch_agent.bat file.
  5. Execute patch_agent.bat

Additional Information

See also: Uninstall and remove the Symantec DLP Endpoint Agent

See also: DLP Agent Install Files Information

See also: Agent upgrade failed - Error: Another version of this product is already installed