Troubleshooting: Ant properties error occurs during feature enablement

When you try to enable a feature, you receive an error that states that values must be given for required Ant properties.

Problem

The error message you receive is similar to the following example:
featureInputValidation:

foundationValidate:

checkDBAPassword:

validateSearchParameters:

setSearchVariables:

inputValidation:

BUILD FAILED
C:\IBM\WEBSPH~1\COMMER~1\COMPON~1\common\xml\ENABLE~1.XML:89: The following error occurred while executing this line:
C:\IBM\WEBSPH~1\COMMER~1\COMPON~1\common\xml\ENABLE~1.XML:155: The following error occurred while executing this line:
C:\IBM\WEBSPH~1\COMMER~1\COMPON~1\common\xml\checkPrerequisites.xml:157: The following error occurred while executing this line:
C:\IBM\WebSphere\CommerceServer70\components\foundation\xml\inputValidation.xml:21: The following error occurred while executing this line:
C:\IBM\WebSphere\CommerceServer70\components\foundation\xml\inputValidation.xml:31: The following error occurred while executing this line:
C:\IBM\WEBSPH~1\COMMER~1\COMPON~1\foundation\subcomponents\search\deploy\deploySearch.xml:483: Values must be given for the following required Ant properties: [ searchWebserverHostname searchPluginInstallLocation searchWebserverInstallLocation ]
This message occurs in the following situation
  • If you chose to auto-configure the search web server during feature enablement; that is, if you specified -DautoConfigSearchWebserver=true on the command line, and
  • The autoconfiguration scripts are missing some necessary information; that is, if one or more properties is not set, or if one or more properties is set to a blank value (empty string). The message contains the list of properties that need to be set.
In the example message above, the properties that are missing values are searchWebserverHostname, searchPluginInstallLocation, and searchWebserverInstallLocation.

Solution

You need to determine the correct values for the required properties, which depend on your environment and your configuration. When you know the correct values, you can define the properties on the enablement command line. In the example error message shown above, you would need to add definitions for searchWebserverHostname, searchPluginInstallLocation, and searchWebserverInstallLocation by appending the following to the enablement command:
-DsearchWebserverHostname=webserver1.example.com -DsearchPluginInstallLocation=/usr/IBM/Plugins -DsearchWebserverInstallLocation=/usr/IBM/HTTPServer
For more information about these properties, see the following topics and their subtopics: