Administer > Deploy > Overview: WebSphere Commerce Build and Deployment tool > Customize the Build and Deployment tool

Customize the toolkit deployment process

Advanced users can customize the toolkit deployment process using the Apache Ant scripting language. This task guides you through creating the customization files for use with the WebSphere Commerce Build and Deployment tool.

WCBD_deploy_toolkit_dir/wcbd-deploy-common.xml provides helper Ant targets that are reusable and serves as examples for customization.

Procedure

1. If new functionality is required in the Ant build:

   1. Create a helper Ant build file called WCBD_deploy_toolkit_dir/project-deploy-common.xml.

   2. Open the file with a text editor and add the following line after the root project element open tag:

      <import file="${basedir}/wcbd-deploy-common.xml" />

   3. Add new targets to the file as needed. The existing helper target and any targets that might depend on it can be overridden using the specification of the Ant import task.

2. If new security-sensitive properties (for example, user names and passwords) are required for the new changes:

   1. Copy WCBD_deploy_toolkit_dir/wcbd-deploy.private.properties.template as WCBD_deploy_toolkit_dir/project-deploy.private.properties.template.

   2. Add the new properties to the end of the file. See comments in the file for details.
   This file becomes the new properties template file for configuration.

3. If new properties are required for the new changes:

   1. Copy WCBD_deploy_toolkit_dir/wcbd-deploy.properties.template as WCBD_deploy_toolkit_dir/project-deploy.properties.template.

   2. Add the new properties to the end of the file. For more information, see the comments in the file.
   This file becomes the new properties template file for configuration.

4. If new libraries are required by Ant for the new changes:

   1. Copy WCBD_deploy_toolkit_dir/wcbd-setenv.bat.template as WCBD_deploy_toolkit_dir/project-setenv.bat.template.

   2. Update the CLASSPATH variable in WCBD_deploy_toolkit_dir/project-setenv.bat.template.
   These files become the new setenv template files for configuration.

5. To include the new or modified functionality in the overall toolkit deployment process:

   1. Copy WCBD_deploy_toolkit_dir/wcbd-deploy.xml as WCBD_deploy_toolkit_dir/project-deploy.xml.

   2. If the new helper Ant build file WCBD_deploy_toolkit_dir/project-deploy-common.xml was created as shown in the preceding example, change the following line in WCBD_deploy_toolkit_dir/project-deploy.xml:

      <import file="${basedir}/wcbd-deploy-common.xml" />

      to:

      <import file="${basedir}/project-deploy-common.xml" />

   3. Modify the logic of the toolkit deployment process to incorporate the new changes. Refer to comments in the file for details.
   To customize the files for Configure the toolkit deployment settings and Run the toolkit deployment process use the same steps, but use the project-* files instead of the wcbd-* files.

What to do next

When the customization is completed copy the new files to WCBD_INSTALL/deploy/toolkit directory on the build system. If applicable, check into SCM, so that the changes are reflected subsequent builds.

+

Search Tips   |   Advanced Search