Not able to install the WSSA agent 7.2.1

Products

• Web Security Service - WSS

Issue/Introduction

When Upgrading the WSSA 6.1.1 agent to WSSA 7.2.1 agent on a windows machine, the following error was displayed on the Windows console:

"A required configuration parameter is missing.  The installer is invalid or is missing the parameter that sets the path to the Unified Agent configuration file located on the Client Manager.  Please contact your network administrator for assistance."

The referenced unified agent was not installed on the machine - it was in the past but had been upgraded to WSSA 6.1.1 without issues.

Cause

A prior version of Unified agent still had registry entries that indicated it was on the system

Environment

WSSA 6.1.1 installed

Upgrading to WSSA 7.2.1

Resolution

Run regedit and search for "Unified Agent" string

When entry discovered, delete it and hit F3 to make sure no other instances of it exist

When all references to it are removed, reinstall WSSA agent.

Additional Information

With WSSA install issues, always run the installed with the following parameters to gather additional information:

c:\path\to\installer.msi /L*V \path\to\output.log

In our case, we could see the following entry:

 

MSI (s) (C4:68) [17:17:17:735]: Skipping action: MarkUpgradeFailureOnNewerProductFound (condition is false)
MSI (s) (C4:68) [17:17:17:735]: Skipping action: AI_DOWNGRADE (condition is false)
MSI (s) (C4:68) [17:17:17:736]: Doing action: LaunchConditions
Action 17:17:17: LaunchConditions. Evaluating launch conditions
Action start 17:17:17: LaunchConditions.
A required configuration parameter is missing.  The installer is invalid or is missing the parameter that sets the path to the Unified Agent configuration file located on the Client Manager.  Please contact your network administrator for assistance.
MSI (s) (C4:68) [17:17:44:980]: Product: Unified Agent -- A required configuration parameter is missing.  The installer is invalid or is missing the parameter that sets the path to the Unified Agent configuration file located on the Client Manager.  Please contact your network administrator for assistance.