config_ant utility
The config_ant utility is a front end to the Apache Ant tool.
Description
- Uses the implementation of Ant that is provided by WebSphere Application Server Version 8.5.5 (Ant V1.6.5)
- Sets up the classpath so that WebSphere Application Server and WebSphere Commerce Ant tasks can be called
- If the default build file is used, some basic validation is performed before the Ant build is executed.
- Sets Java logging configuration using the properties file: WC_installdir/config/deployment/properties/config.properties
Usage
The standard Apache Ant command-line parameters are supported. Similar to Apache Ant, the utility can be used to run any user-defined Ant build file. To specify a build file other than the default build file use the -buildfile command-line argument. For example, config_ant.bat/sh -buildfile PathToAntBuildfile [other parameters]
See the Apache Ant documentation (for Apache Ant V1.6.5) for more details on using Ant and Ant build files. Depending on the build file, there might be required or supported command-line parameters.
In addition to the standard Apache Ant command-line parameters, an optional
passwordFile
parameter allows users to pass a properties file that contains
encrypted passwords. Use the properties file to hide passwords from the command prompt. For more
information about adding passwords to the properties file, see Changing config_ant utility password properties file.
Example
- WC_installdir/bin/config_ant.sh -buildfile buildfile -logfile logfile [-DpasswordFile=passwordFile]
- WC_installdir\bin\config_ant.bat -buildfile buildfile -logfile logfile [-DpasswordFile=passwordFile]
- buildfile
- Optional: The full path to the Ant build file. If you do not specify an Ant build file, then it
defaults to the WebSphere Commerce instance creation build script. The default build file is:
WC_installdir/config/deployment/xml/createInstance.xml
- logfile
- Optional: The full path to the output log file target location. If the default build file is
used and its default target is selected, then the output is logged to the default instance creation
log file:
WC_installdir/instances/instance_name/logs/createInstanceANT.log. Otherwise, the output goes to the console and is not logged.
. - passwordFile
- Optional: The full path to the password properties file. The properties file can contain encrypted passwords that might be required when running the utility. For example, you can store encrypted database administrator (dbaPassword) or database user (dbUserPassword) passwords. Passwords that are entered on the command line take precedence over the passwords that are in the password file. For more information, see Changing config_ant utility password properties file.