Server deployment configuration properties

Property summary

Property detail

source.dir

The deployment source directory.

Default

• Before 7.0.0.3: ${basedir}/source
• Since 7.0.0.3: ${full.source.dir}

full.source.dir

The full deployment source directory. For a full build, ${source.dir} should reference this property.

Default

${basedir}/source

Since

7.0.0.3

full.ear.dir

The directory in ${full.source.dir} where the non-module EAR assets to be deployed are located.

Default

${full.source.dir}/wc.ear

Since

7.0.0.3

full.module.dir

The directory in ${full.source.dir} where the modules to be deployed are located.

Default

${full.source.dir}/wc.ear.ext

Since

7.0.0.3

ear.dir

The directory in ${source.dir} where the non-module EAR assets to be deployed are located.

Default

${source.dir}/wc.ear

module.dir

The directory in ${source.dir} where the modules to be deployed are located.

Default

${source.dir}/wc.ear.ext

log.dir

The deployment log directory.

Default

${basedir}/logs/${build.label}-${target.env}-${tstamp}

log.file

The deployment log file.

Default

${log.dir}/wcbd-deploy-server.log

log.zip.file

The zip file which contains build logs that are attached to deployment failure notifications.

Default

${log.dir}/wcbd-deploy-server-log-${build.label}-${target.env}.zip

working.dir

The working directory used to store temporary files that are generated by the deployment process.

Default

${basedir}/working

working.module.dir

The working directory to prepare deployable modules with matching targetable files renamed and other targetable files deleted.

Default

${working.dir}/module

working.partial.app.dir

The working directory for packaging a partial application zip file.

Default

${working.dir}/partialapp

working.wc.server.dir

The working directory for synchronizing wc-server.xml.

Default

${working.dir}/wc-server

working.wc.server.archive.dir

The working directory for archiving wc-server.xml before synchronization.

Default

${working.wc.server.dir}/archive

connector.module.list

The comma-separated list of connector modules to be deployed. Leave the value of this property empty if no such modules need to be deployed.

Example

TestConnector1,TestConnector2

ejb.module.list

The comma-separated list of EJB modules to be deployed. Leave the value of this property empty if no such modules need to be deployed.

Example

WebSphereCommerceServerExtensionsData,TestEJB1

existing.web.module.list

The comma-separated list of Web modules to be deployed via partial application update. This is typically used for non-metadata changes to existing Web modules that are part of the default WebSphere Commerce application. Metadata files that are part of the Java EE and WebSphere standard (for example, WEB-INF/web.xml and WEB-INF/ibm-web-ext.xml) will automatically be excluded from the deployment. If you require such changes, specify the module in ${new.web.module.list} instead. Leave the value of this property empty if no such modules need to be deployed.

Example

SiteAdministation,Stores

new.web.module.list

The comma-separated list of Web modules to be deployed in its entirety. This is typically used for new Web modules that are added as part of the WebSphere Commerce customization. Leave the value of this property empty if no such modules need to be deployed.

Example

TestWeb1,TestWeb2

context.root.mapping.list

The list of context root mappings that are used to set context root of modules in ${new.web.module.list} during the deployment. The value should be a comma- separated list of mappings of the format moduleURI:contextRoot. If a context root for a module is not defined by this property, a default context root that is the same as the module name will be used.

Example

TestWeb1.war:/wcs/testweb1,TestWeb2.war:/wcs/testweb2

virtual.host.mapping.list

The list of virtual host mappings that are used to set virtual host of modules in ${new.web.module.list} during the deployment. The value should be a comma- separated list of mappings of the format moduleURI:virtualHost. If a virtual host for a module is not defined by this property, the default context root from the Web deployment descriptor will be used.

Example

TestWeb1.war:VH_${wc.instance.name}_Preview,TestWeb2.war:VH_${wc.instance.name}_Tools

Since

7.0.0.1

mapping.option.file

The CSV file that contains additional mapping options to be specified when EJB modules are deployed. For details on the CSV file format and supported options, refer to the WebSphere Commerce Information Center.

Since

7.0.0.2

partial.app.zip.file

The path of the partial application zip file to be created and deployed.

Default

${working.dir}/partialapp.zip

partial.app.zip.includes

The comma-separated list of files in ${working.dir}/partialapp to be included in the partial application zip file. Leave the value of this property empty to include all files.

partial.app.zip.excludes

The comma-separated list of files in ${working.dir}/partialapp to be excluded in the partial application zip file. Leave the value of this property empty to not exclude any file.

connector.module.delete.list

The comma-separated list of connector modules to be deleted. Leave the value of this property empty if no such modules need to be deleted.

Since

7.0.0.3

ejb.module.delete.list

The comma-separated list of EJB modules to be deleted. Leave the value of this property empty if no such modules need to be deleted.

Since

7.0.0.3

web.module.delete.list

The comma-separated list of Web modules to be deleted. Leave the value of this property empty if no such modules need to be deleted.

Since

7.0.0.3

wc.home

The WebSphere Commerce or WebSphere Commerce Developer installation directory.

wc.instance.name

The name of the WebSphere Commerce instance in which the target environment is deployed. Do not include the "WC_" prefix.

was.home

The WebSphere Application Server installation directory. If you are using Rational Application Developer V7.5 on the build system, set the value to RAD_installdir/runtimes/base_v7.

was.profile.name

The name of the WebSphere Application Server profile, on the system where the deployment process is run, that will be used as the administative client to invoke the wsadmin utility to update the deployed WebSphere Commerce application. This profile does not need to be the profile in which the WebSphere Commerce application is deployed; It is only used to facilitate wsadmin connection to the WebSphere Application Server, remote or otherwise. You must create a new Application Server profile using the Profile Management Tool or the manageprofiles utility if you do not have an existing one which the deployment process can use.

was.application.name

The name of the WebSphere Commerce application to be updated by the deployment process.

Default

WC_${wc.instance.name}

was.use.dmgr

Whether the target enviornment uses a Network Deployment Manager to manage the deployed WebSphere Commerce application in a federated or clustered configuration.

Default

false

Valid values

• true
• false

was.host.list

The comma-separated list of host names with a running application server or DMGR instance to deploy to. It should be set as follows:

• For a single-server environment, set it to the host name of the application server.
• For a clustered or federated enviornment managed by a DMGR, set it to the host name of the DMGR.

Example

node1.ibm.com,node2.ibm.com,node3.ibm.com

was.conntype

The type of connection that the wsadmin utility will use to connect to the server on which the WebSphere Commerce application is deployed. Use the default SOAP connection type unless you have special requirements to use other connection types.

Default

SOAP

was.port

The port corresponding to ${was.conntype} that the wsadmin utility will use to connect to the server.

was.jvm.max.memory

The maximum size of the memory for the JVM in which the wsadmin utility is run.

Default

512M

Since

7.0.0.2

db.type

The name of the database vendor which the build processes uses to configure the WebSphere Commerce loading utility classpath. It should be set to the corresponding value for the database vendor type.

Default

db2

Valid values

• DB2: db2
• Oracle: oracle
• DB2 for i: os400

db.name

The database name.

db.schema.name

The database schema name. It is typically the same as the database user name.

jdbc.url

The JDBC URL. Use the value corresponding to the database vendor listed below unless you have special requirements to use other JDBC drivers which requires a different URL, or include other parameters in the URL.

Valid values

• DB2: jdbc:db2://db_host_name:db_port/${db.name}
• Oracle: jdbc:oracle:oci:@db_host_name:db_port:${db.name}
• DB2 for i: jdbc:as400://db_host_name/${db.schema.name};database name=${db.name}

jdbc.driver

The JDBC driver class name. Use the value corresponding to the database vendor listed below unless you have special requirements to use other JDBC drivers.

Valid values

• DB2: com.ibm.db2.jcc.DB2Driver
• Oracle: oracle.jdbc.driver.OracleDriver
• DB2 for i: com.ibm.as400.access.AS400JDBCDriver

jdbc.driver.path

The classpath that contains the JDBC driver library and other libraries it depends on. Use the value corresponding to the database vendor listed below unless you have special requirements to use other JDBC drivers and libraries.

Valid values

• DB2:
  • Windows: DB2_installdir/java/db2jcc4.jar;DB2_installdir/java/db2jcc_license_cu.jar
  • UNIX/Linux: DB2_installdir/java/db2jcc4.jar:DB2_installdir/java/db2jcc_license_cu.jar
• Oracle: Oracle_installdir/jdbc/lib/ojdbc6.jar
• DB2 for i:
  • WC: ${wc.home}/lib/jtopen.jar
  • WCDE: ${wc.home}/wc.modules/workspace/WC/lib/jtopen.jar

datasource.jndi.name

The JNDI name of the default datasource that will be mapped for entity beans in EJB modules that are deployed.

Valid values

• DB2: jdbc/WebSphere Commerce DB2 DataSource ${wc.instance.name}
• Oracle: jdbc/WebSphere Commerce Oracle DataSource ${wc.instance.name}
• DB2 for i: jdbc/WebSphere Commerce iSeries DataSource ${wc.instance.name}

sql.onerror

The action to perform when a statement fails as part of the <sql> task.

Default

continue

Valid values

• continue
• stop
• abort

procedural.sql.file.name.id

The string identifier in the name of a SQL file which indicates that the file is a procedural SQL file. For example, the file name procedural.triggers.sql indicates that the file is a procedural SQL file, but the file name createTables.sql does not.

Default

procedural

Since

7.0.0.3

procedural.sql.delimiter

The delimiter that separates procedural SQL statements in a procedural SQL file.

Default

@

Since

7.0.0.3

wcs.dtd.path

The path to the wcs.dtd file that is used for loading ACP and ACUG data.

Default

${wc.home}/schema/xml/wcs.dtd

wca.logger.config.file

The path to the WCALogger config file which is used by the WebSphere Commerce loading utilities.

Default

${basedir}/WCALoggerConfig.xml

wca.logger.output.dir

The directory in which logs will be created by the WebSphere Commerce loading utilities.

Default

${log.dir}/loader

xmltransform.params

The list of parameters to be passed to the XSL rule file for the xmltransform utility. The following format should be used:

-param "key1=value1" -param "key2=value3" ...

xmltransform.debug

Whether the xmltransform utility should output debugging information to the console.

Default

false

Valid values

• true
• false

idresgen.method

The method to be used by the idresgen utility to load the input file.

Default

mixed

Valid values

• load
• mixed
• update

idresgen.customizer

Name of the customizer properties file to be used for the idresgen utility. Use the value corresponding to the database vendor listed below.

Valid values

• DB2: (empty)
• Oracle: OracleConnectionCustomizer
• DB2 for i: Toolbox_RESWCSID_Customizer

idresgen.input.type

The type of input to the idresgen utility.

Default

infile

Valid values

• infile
• inputDirectory
• inFileList

idresgen.poolsize

The number of identifiers to be reserved by the idresgen utility.

Default

50

idresgen.maxerror

The number of errors after which the idresgen utility terminates.

Default

1

idresgen.optimize

Whether the idresgen utility will check for duplicate records before writing resolved records to the output file.

Default

yes

Valid values

• yes
• no

idresgen.debug

Whether the idresgen utility should output debugging information to the console.

Default

false

Valid values

• true
• false

massload.method

The mode of operation used by the massload utility when it modifies the database using input data.

Default

sqlimport

Valid values

• import
• load
• sqlimport
• delete
• createonly
• loadonly

massload.noprimary

The action that the massload utility takes when the primary key is missing for a record in the input file.

Default

error

Valid values

• error
• insert
• skip

massload.commitcount

The number of records processed by the massload utility before the database commit occurs when using the SQL update method of operation.

Default

100

massload.maxerror

The number of errors after which the massload utility will terminate in the SQL update method of operation.

Default

1

massload.customizer

Name of the customizer properties file to be used for the idresgen utility. Use the value corresponding to the database vendor listed below.

Valid values

• DB2: (empty)
• Oracle: OracleConnectionCustomizer
• DB2 for i: Toolbox_LODWCSDTA_Customizer

massload.debug

Whether the massload utility should output debugging information to the console.

Default

false

dataload.logging.config.file

The path to the logger config file which is used by the WebSphere Commerce Data Load utility.

Default

${basedir}/wcbd-dataload-logging.properties

Since

7.0.0.3

dataload.log.dir

The directory in which logs will be created by the WebSphere Commerce Data Load utility.

Default

${log.dir}/dataload

Since

7.0.0.3

dataload.params

The list of parameters to be passed to the Data Load utility command.

Since

7.0.0.3

run.dataload.sql.common

Whether common SQL data should be loaded.

Default

true

Valid values

• true
• false

run.dataload.sql.target

Whether target-specific SQL data should be loaded.

Default

true

Valid values

• true
• false

dataload.sql.common.dir

The directory that contains common SQL data files to be loaded.

Default

${source.dir}/dataload/sql/common

dataload.sql.common.order

Whether common SQL data files are to be loaded in order as specified in ${dataload.sql.common.ordered.list}.

Default

false

Valid values

• true
• false

dataload.sql.common.fileset.includes

The comma-separated list of common SQL data files, relative to ${dataload.sql.common.dir}, to be included for loading, if ${dataload.sql.common.order} is set to false. Leave the value of this property empty to include all files.

dataload.sql.common.fileset.excludes

The comma-separated list of common SQL data files, relative to ${dataload.sql.common.dir}, to be excluded from loading, if ${dataload.sql.common.order} is set to false. Leave the value of this property empty to not exclude any file.

dataload.sql.common.ordered.list

The comma-separated list of common SQL data files, relative to ${dataload.sql.common.dir}, to be loaded in order, if ${dataload.sql.common.order} is set to true.

dataload.sql.target.dir

The directory that contains target-specific SQL data files to be loaded.

Default

${source.dir}/dataload/sql/${target.env}

dataload.sql.target.order

Whether target-specific SQL data files are to be loaded in order as specified in ${dataload.sql.target.ordered.list}.

Default

false

Valid values

• true
• false

dataload.sql.target.fileset.includes

The comma-separated list of target-specific SQL data files, relative to ${dataload.sql.target.dir}, to be included for loading, if ${dataload.sql.target.order} is set to false. Leave the value of this property empty to include all files.

dataload.sql.target.fileset.excludes

The comma-separated list of target-specific SQL data files, relative to ${dataload.sql.target.dir}, to be excluded from loading, if ${dataload.sql.target.order} is set to false. Leave the value of this property empty to not exclude any file.

dataload.sql.target.ordered.list

The comma-separated list of target-specific SQL data files, relative to ${dataload.sql.target.dir}, to be loaded in order, if ${dataload.sql.target.order} is set to true.

run.dataload.xml.common

Whether common XML data should be loaded.

Default

true

Valid values

• true
• false

run.dataload.xml.target

Whether target-specific XML data should be loaded.

Default

true

Valid values

• true
• false

dataload.xml.common.dir

The directory that contains common XML data files to be loaded.

Default

${source.dir}/dataload/xml/common

dataload.xml.common.order

Whether common XML data files are to be loaded in order as specified in ${dataload.xml.common.ordered.list}.

Default

false

Valid values

• true
• false

dataload.xml.common.fileset.includes

The comma-separated list of common XML data files, relative to ${dataload.xml.common.dir}, to be included for loading, if ${dataload.xml.common.order} is set to false. Leave the value of this property empty to include all files.

dataload.xml.common.fileset.excludes

The comma-separated list of common XML data files, relative to ${dataload.xml.common.dir}, to be excluded from loading, if ${dataload.xml.common.order} is set to false. Leave the value of this property empty to not exclude any file.

dataload.xml.common.ordered.list

The comma-separated list of common XML data files, relative to ${dataload.xml.common.dir}, to be loaded in order, if ${dataload.xml.common.order} is set to true.

dataload.xml.common.idresgen.excludes

The comma-separated list of common XML data files, relative to ${dataload.xml.common.dir}, to be excluded from idresgen during the dataload. Leave the value of this property empty to not exclude any file.

dataload.xml.common.failonerror

Whether the Ant build should fail when there are errors loading the common XML data files.

Default

true

Since

7.0.0.3

Valid values

• true
• false

dataload.xml.target.dir

The directory that contains target-specific XML data files to be loaded.

Default

${source.dir}/dataload/xml/${target.env}

dataload.xml.target.order

Whether target-specific XML data files are to be loaded in order as specified in ${dataload.xml.target.ordered.list}.

Default

false

Valid values

• true
• false

dataload.xml.target.fileset.includes

The comma-separated list of target-specific XML data files, relative to ${dataload.xml.target.dir}, to be included for loading, if ${dataload.xml.target.order} is set to false. Leave the value of this property empty to include all files.

dataload.xml.target.fileset.excludes

The comma-separated list of target-specific XML data files, relative to ${dataload.xml.target.dir}, to be excluded from loading, if ${dataload.xml.target.order} is set to false. Leave the value of this property to not exclude any file.

dataload.xml.target.ordered.list

The comma-separated list of target-specific XML data files, relative to ${dataload.xml.target.dir}, to be loaded in order, if ${dataload.xml.target.order} is set to true.

dataload.xml.target.idresgen.excludes

The comma-separated list of target-specific XML data files, relative to ${dataload.xml.target.dir}, to be excluded from idresgen during the dataload. Leave the value of this property empty to not exclude any file.

dataload.xml.target.failonerror

Whether the Ant build should fail when there are errors loading the target- specific XML data files.

Default

true

Since

7.0.0.3

Valid values

• true
• false

run.dataload.dataload.common

Whether common Data Load utility data should be loaded.

Default

true

Since

7.0.0.3

Valid values

• true
• false

run.dataload.dataload.target

Whether target-specific Data Load utility data should be loaded.

Default

true

Since

7.0.0.3

Valid values

• true
• false

dataload.dataload.common.dir

The directory that contains common Data Load utility data files to be loaded.

Default

${source.dir}/dataload/dataload/common

Since

7.0.0.3

dataload.dataload.common.order

Whether common Data Load utility data files are to be loaded in order as specified in ${dataload.dataload.common.ordered.list}.

Default

false

Since

7.0.0.3

Valid values

• true
• false

dataload.dataload.common.fileset.includes

The comma-separated list of common Data Load utility data files, relative to ${dataload.dataload.common.dir}, to be included for loading, if ${dataload.dataload.common.order} is set to false.

Default

**/wc-dataload.xml

Since

7.0.0.3

dataload.dataload.common.fileset.excludes

The comma-separated list of common Data Load utility data files, relative to ${dataload.dataload.common.dir}, to be excluded from loading, if ${dataload.dataload.common.order} is set to false. Leave the value of this property empty to not exclude any file.

Since

7.0.0.3

dataload.dataload.common.ordered.list

The comma-separated list of common Data Load utility data files, relative to ${dataload.dataload.common.dir}, to be loaded in order, if ${dataload.dataload.common.order} is set to true.

Since

7.0.0.3

dataload.dataload.common.failonerror

Whether the Ant build should fail when there are errors loading the common Data Load utility data files.

Default

true

Since

7.0.0.3

Valid values

• true
• false

dataload.dataload.target.dir

The directory that contains target-specific Data Load utility data files to be loaded.

Default

${source.dir}/dataload/dataload/${target.env}

Since

7.0.0.3

dataload.dataload.target.order

Whether target-specific Data Load utility data files are to be loaded in order as specified in ${dataload.dataload.target.ordered.list}.

Default

false

Since

7.0.0.3

Valid values

• true
• false

dataload.dataload.target.fileset.includes

The comma-separated list of target-specific Data Load utility data files, relative to ${dataload.dataload.target.dir}, to be included for loading, if ${dataload.dataload.target.order} is set to false.

Default

**/wc-dataload.xml

Since

7.0.0.3

dataload.dataload.target.fileset.excludes

The comma-separated list of target-specific Data Load utility data files, relative to ${dataload.dataload.target.dir}, to be excluded from loading, if ${dataload.dataload.target.order} is set to false. Leave the value of this property to not exclude any file.

dataload.dataload.target.ordered.list

The comma-separated list of target-specific Data Load utility data files, relative to ${dataload.dataload.target.dir}, to be loaded in order, if ${dataload.dataload.target.order} is set to true.

dataload.dataload.target.failonerror

Whether the Ant build should fail when there are errors loading the target- specific Data Load uitlity data files.

Default

true

Since

7.0.0.3

Valid values

• true
• false

run.dataload.acug.common

Whether common ACUG data should be loaded.

Default

true

Valid values

• true
• false

run.dataload.acug.target

Whether target-specific ACUG data should be loaded.

Default

true

Valid values

• true
• false

dataload.acug.common.dir

The directory that contains common ACUG data files to be loaded.

Default

${source.dir}/dataload/acug/common

dataload.acug.common.order

Whether common ACUG data files are to be loaded in order as specified in ${dataload.acug.common.ordered.list}.

Default

false

Valid values

• true
• false

dataload.acug.common.fileset.includes

The comma-separated list of common ACUG data files, relative to ${dataload.acug.common.dir}, to be included for loading, if ${dataload.acug.common.order} is set to false. Leave the value of this property empty To include all files.

dataload.acug.common.fileset.excludes

The comma-separated list of common ACUG data files, relative to ${dataload.acug.common.dir}, to be excluded from loading, if ${dataload.acug.common.order} is set to false. Leave the value of this property to not exclude any file.

dataload.acug.common.ordered.list

The comma-separated list of common ACUG data files, relative to ${dataload.acug.common.dir}, to be loaded in order, if ${dataload.acug.common.order} is set to true.

dataload.acug.common.failonerror

Whether the Ant build should fail when there are errors loading the common ACUG data files.

Default

true

Since

7.0.0.3

Valid values

• true
• false

dataload.acug.target.dir

The directory that contains target-specific ACUG data files to be loaded.

Default

${source.dir}/dataload/acug/${target.env}

dataload.acug.target.order

Whether target-specific ACUG data files are to be loaded in order as specified in ${dataload.acug.target.ordered.list}.

Default

false

Valid values

• true
• false

dataload.acug.target.fileset.includes

The comma-separated list of target-specific ACUG data files, relative to ${dataload.acug.target.dir}, to be included for loading, if ${dataload.acug.target.order} is set to false. Leave the value of this property empty to include all files.

dataload.acug.target.fileset.excludes

The comma-separated list of target-specific ACUG data files, relative to ${dataload.acug.target.dir}, to be excluded from loading, if ${dataload.acug.target.order} is set to false. Leave the value of this property empty to To not exclude any file.

dataload.acug.target.ordered.list

The comma-separated list of target-specific ACUG data files, relative to ${dataload.acug.target.dir}, to be loaded in order, if ${dataload.acug.target.order} is set to true.

dataload.acug.target.failonerror

Whether the Ant build should fail when there are errors loading the target- specific ACUG data files.

Default

true

Since

7.0.0.3

Valid values

• true
• false

run.dataload.acp.common

Whether common ACP data should be loaded.

Default

true

Valid values

• true
• false

run.dataload.acp.target

Whether target-specific ACP data should be loaded.

Default

true

Valid values

• true
• false

dataload.acp.common.dir

The directory that contains common ACP data files to be loaded.

Default

${source.dir}/dataload/acp/common

dataload.acp.common.order

Whether common ACP data files are to be loaded in order as specified in ${dataload.acp.common.ordered.list}.

Default

false

Valid values

• true
• false

dataload.acp.common.fileset.includes

The comma-separated list of common ACP data files, relative to ${dataload.acp.common.dir}, to be included for loading, if ${dataload.acp.common.order} is set to false. Leave the value of this property empty to include all files.

dataload.acp.common.fileset.excludes

The comma-separated list of common ACP data files, relative to ${dataload.acp.common.dir}, to be excluded from loading, if ${dataload.acp.common.order} is set to false. Leave the value of this property empty to not exclude any file.

dataload.acp.common.ordered.list

The comma-separated list of common ACP data files, relative to ${dataload.acp.common.dir}, to be loaded in order, if ${dataload.acp.common.order} is set to true.

dataload.acp.common.failonerror

Whether the Ant build should fail when there are errors loading the common ACP data files.

Default

true

Since

7.0.0.3

Valid values

• true
• false

dataload.acp.target.dir

The directory that contains target-specific ACP data files to be loaded.

Default

${source.dir}/dataload/acp/${target.env}

dataload.acp.target.order

Whether target-specific ACP data files are to be loaded in order as specified in ${dataload.acp.target.ordered.list}.

Default

false

Valid values

• true
• false

dataload.acp.target.fileset.includes

The comma-separated list of target-specific ACP data files, relative to ${dataload.acp.target.dir}, to be included for loading, if ${dataload.acp.target.order} is set to false. Leave the value of this property empty to include all files.

dataload.acp.target.fileset.excludes

The comma-separated list of target-specific ACP data files, relative to ${dataload.acp.target.dir}, to be excluded from loading, if ${dataload.acp.target.order} is set to false. Leave the value of this property empty to not exclude any file.

dataload.acp.target.ordered.list

The comma-separated list of target-specific ACP data files, relative to ${dataload.acp.target.dir}, to be loaded in order, if ${dataload.acp.target.order} is set to true.

dataload.acp.target.failonerror

Whether the Ant build should fail when there are errors loading the target- specific ACP data files.

Default

true

Since

7.0.0.3

Valid values

• true
• false

run.dataload.acpnls.common

Whether common ACP NLS data should be loaded.

Default

true

Valid values

• true
• false

run.dataload.acpnls.target

Whether target-specific ACP NLS data should be loaded.

Default

true

Valid values

• true
• false

dataload.acpnls.common.dir

The directory that contains common ACP NLS data.

Default

${source.dir}/dataload/acpnls/common

dataload.acpnls.common.order

Whether common ACP NLS data files are to be loaded in order as specified in ${dataload.acpnls.common.ordered.list}.

Default

false

Valid values

• true
• false

dataload.acpnls.common.fileset.includes

The comma-separated list of common ACP NLS data files, relative to ${dataload.acpnls.common.dir}, to be included for loading, if ${dataload.acpnls.common.order} is set to false. Leave the value of this property empty to include all files.

dataload.acpnls.common.fileset.excludes

The comma-separated list of common ACP NLS data files, relative to ${dataload.acpnls.common.dir}, to be excluded from loading, if ${dataload.acpnls.common.order} is set to false. Leave the value of this property empty to not exclude any file.

dataload.acpnls.common.ordered.list

The comma-separated list of common dataload ACP NLS data files, relative to ${dataload.acpnls.common.dir}, to be loaded in order, if ${dataload.acpnls.common.order} is set to true.

dataload.acpnls.common.failonerror

Whether the Ant build should fail when there are errors loading the common ACP NLS data files.

Default

true

Since

7.0.0.3

Valid values

• true
• false

dataload.acpnls.target.dir

The directory that contains target-specific ACP NLS data.

Default

${source.dir}/dataload/acpnls/${target.env}

dataload.acpnls.target.order

Whether target-specific ACP NLS data files are to be loaded in order as specified in ${dataload.acpnls.target.ordered.list}.

Default

false

Valid values

• true
• false

dataload.acpnls.target.fileset.includes

The comma-separated list of target-specific ACP NLS data files, relative to ${dataload.acpnls.target.dir}, to be included for loading, if ${dataload.acpnls.target.order} is set to false. Leave the value of this property empty to include all files.

dataload.acpnls.target.fileset.excludes

The comma-separated list of target-specific ACP NLS data files, relative to ${dataload.acpnls.target.dir}, to be excluded from loading, if ${dataload.acpnls.target.order} is set to false. Leave the value of this property empty to not exclude any file.

dataload.acpnls.target.ordered.list

The comma-separated list of target-specific ACP NLS data file, relative to ${dataload.acpnls.target.dir}, to be loaded in order, if ${dataload.acpnls.target.order} is set to true.

dataload.acpnls.target.failonerror

Whether the Ant build should fail when there are errors loading the target- specific ACP NLS data files.

Default

true

Since

7.0.0.3

Valid values

• true
• false

run.wsadmin

Whether wsadmin deployment should be run.

Default

true

Valid values

• true
• false

wsadmin.ant.target

The Ant target containing the actual wsadmin call to ${wsadmin.deploy.script.file} with set arguments. Use the default target unless you are customizing the wsadmin Jython deployment scripts.

Default

wcbd.wsadmin.helper

wsadmin.script.dir

The wsadmin script directory.

Default

${basedir}/scripts

wsadmin.properties.file

The properties file that contains JVM system properties that are passed in to the wsadmin utility. It is used to enable wsadmin tracing among other uses. A template for the properties file, ${was.home}/properties/wsadmin.properties, is provided. For details, see WebSphere Application Server documentation. Leave the value of this property empty if you do not require this functionality.

Since

7.0.0.2

wsadmin.deploy.script.file

The deployment wsadmin Jython script. Use the default script unless you require customization.

Default

${wsadmin.script.dir}/wcbd-wsadmin.py

rollout.update

Whether rollout update should be used when updating the WebSphere Commerce application. This option only works for clustered or federated environment managed by a DMGR.

Default

false

Valid values

• true
• false

rollout.update.timeout

The timeout value for rollout update. You might need to increase this value depending on how large your customized WebSphere Commerce application is.

Default

300

partial.app.full.update

Whether the partial application update should be performed as a full update, which the binaries directory is erased and the content of the updated EAR file is completely extracted. Setting this value to true may improve the deployment time if the partial application zip file contains a large number of files. However, doing so will reset the file permission of the expanded EAR root on UNIX/Linux systems, which subsequently denies access to the static Web server contents by the Web server on a single-server environment. It is recommended that this property be set to false for UNIX/Linux, single-server environments.

Default

true

Since

7.0.0.1

Valid values

• true
• false

regen.plugin.cfg

Whether the Web server plug-in configuration should be regenerated at the end of the application update.

Default

true

Since

7.0.0.3

Valid values

• true
• false

wait.app.ready

Whether the application update process should wait until the WebSphere Commerce application is propagated and started on all nodes in a cluster.

Default

false

Since

7.0.0.3

Valid values

• true
• false

run.static.web.deploy

Whether static Web server assets should be deployed.

Default

true

Valid values

• true
• false

static.web.deploy.ant.file

The Ant file that is used to deploy static Web server assets. Refer to the documentation for details on creating a custom extract Ant file using the template provided.

static.web.dir

The static Web server assets directory.

Default

${source.dir}/staticweb

static.web.dir.includes

The comma-separated list of files in ${static.web.dir} to be included with deployment. Leave the value of this property empty to include all files.

static.web.dir.excludes

The comma-separated list of files in ${static.web.dir} to be excluded from deployment. Leave the value of this property empty to not exclude any file.

run.wc.server.sync

Whether wc-server.xml should be synchronized.

Default

true

Valid values

• true
• false

wc.server.sync.ant.file

The Ant file that is used to synchronize wc-server.xml. Refer to the documentation for details on creating a custom extract Ant file using the template provided.

run.dataload.cust.deploy

Whether Data Load utility customization should be deployed.

Default

false

Since

7.0.0.2

Valid values

• true
• false

dataload.cust.deploy.ant.file

The Ant file that is used to deploy Data Load utility customization. Refer to the documentation for details on creating a custom extract Ant file using the template provided.

Since

7.0.0.2

dataload.cust.deploy.java.module.includes

The comma-separated list of Java modules in ${ear.dir} to be included with deployment.

Default

WebSphereCommerceServerExtensionsLogic.jar

Since

7.0.0.2

dataload.cust.deploy.dsl.config.includes

The comma-separated list of Data Service Layer configuration files in ${ear.dir}/xml/config to be included with deployment.

Default

com.ibm.commerce.*-ext/**

Since

7.0.0.2

run.clean.working.dir

Whether the working directory should be cleaned at the end of the deployment process.

Default

false

Since

7.0.0.3

Valid values

• true
• false

run.mail.success

Whether deployment success notifications should be sent.

Default

false

Valid values

• true
• false

run.mail.failure

Whether deployment failure notifications should be sent.

Default

false

Valid values

• true
• false

mail.from

The sender e-mail address of deployment status notifications.

mail.success.tolist

The comma-separated list of e-mail addresses that receive deployment success notifications.

mail.failure.tolist

The comma-separated list of e-mail addresses that receive deployment failure notifications.

mail.mailhost

The host name of the SMTP server.

mail.mailport

The TCP port of the SMTP server.

Default

25

mail.ssl

Whether the SMTP server uses TLS/SSL for encryption.

Default

false

Valid values

• true
• false

mail.success.subject

The subject of deployment success notifications.

Default

WCBD Build Successful: ${build.label}

mail.failure.subject

The subject of deployment failure notifications.

Default

WCBD Build FAILED: ${build.label}

mail.success.message

The message body of deployment success notifications.

mail.failure.message

The message body of deployment failure notifications.

Default

Check attached logs for details.

baseline.properties.file

The location of the properties file that will store the baseline directory for subsequent delta deployment. This property is used by the one-step delta deployment process that runs both the delta preparation process and the deployment process in delta mode.

Default

${basedir}/../baseline.properties

Since

7.0.0.3

baseline.build.label

The baseline build label. This property intended to be set by the delta preparation process, as such it should not be set manually.

Since

7.0.0.3

baseline.source.dir

The source directory of the installed baseline deployment package.

Default

${baseline.dir}/source

Since

7.0.0.3

delta.source.dir

The deployment source directory that is created by the delta preparation process for delta deployment.

Default

${basedir}/delta-source

Since

7.0.0.3

delta.source.always.includes

The comma-separated list of files, relative to ${source.dir}, to be included in ${delta.source.dir} by the delta preparation process, regardless of whether the files have been changed. Leave the value of this property empty if there are no files that need to be included.

Since

7.0.0.3

delta.summary.file

The XML file that contains the summary of the delta comparison.

Default

${basedir}/delta-summary-${target.env}.xml

Since

7.0.0.3

delta.log.dir

The delta preparation and depoloyment log directory.

Default

${basedir}/logs/delta-deploy-${target.env}

Since

7.0.0.3

delta.prepare.log.file

The delta preparation log file.

Default

${delta.log.dir}/wcbd-delta-prepare.log

Since

7.0.0.3

delta.deploy.log.file

The delta deployment log file.

Default

${delta.log.dir}/wcbd-delta-deploy.log

Since

7.0.0.3

delta.prepare.fail.on.no.delta

Determines whether the delta preparation process should fail if there is no delta between the baseline and the target.

Default

true

Valid values

• true
• false