Running the overall delta deployment process in one step

The delta preparation process and server deployment process in delta mode can be run as a single step for convenience.

Before you begin

  • The target environment must be at the same code level as the baseline, otherwise delta deployment might introduce inconsistencies.
  • Both the baseline and the target deployment packages must be installed and available.
  • The deployment settings must have been configured for a full deployment in the target server deployment directory, so that the delta preparation process can determine the assets that need to be compared. Refer to the Configuring the server deployment settings topic for detail.
    Note: In order for the delta deployment process to delete modules that have been deleted from the target, you must add the deleted modules to the appropriate module list properties in WCBD_target_deploy_server_dir/deploy-target-env.properties.

Procedure

  1. If it does not already exist, create and configure the baseline.properties file.
    1. At the same directory level as WCBD_target_deploy_server_dir, create a new properties file called baseline.properties. For example, if WCBD_target_deploy_server_dir is C:\IBM\WebSphere\CommerceServer80\wcbd\deploy-server-workspace\wcbd-deploy-server-v1.1, the path of the baseline properties file should be C:\IBM\WebSphere\CommerceServer80\wcbd\deploy-server-workspace\baseline.properties.
    2. Open baseline.properties with a text editor, add the baseline.dir property, and set it to WCBD_baseline_deploy_server_dir. For example, if WCBD_baseline_deploy_server_dir is C:\IBM\WebSphere\CommerceServer80\wcbd\deploy-server-workspace\wcbd-deploy-server-v1.0, the contents of baseline.properties should be set as follows:
      baseline.dir=C:/IBM/WebSphere/CommerceServer80/wcbd/deploy-server-workspace/wcbd-deploy-server-v1.0
  2. Open a command prompt and change to the WCBD_target_deploy_server_dir directory.
  3. Run the following command:
    Windows
    wcbd-ant.bat -buildfile wcbd-delta-deploy.xml -Dtarget.env=target-env
    LinuxAIXFor IBM i OS operating system
    ./wcbd-ant -buildfile wcbd-delta-deploy.xml -Dtarget.env=target-env

Results

The overall delta deployment log file WCBD_target_deploy_server_dir/logs/delta-target-env/wcbd-delta-deploy.log is created. Upon a successful delta deployment, the baseline.dir property in baseline.properties will also be set to WCBD_target_deploy_server_dir. Subsequent delta deployment can then use the current target as the next baseline.

What to do next

The one-step delta deployment process can be used together with the centralized server deployment feature in the build process to automate delta deployment. This can be done by setting the deploy.server.command.args property in the build configuration properties file to use wcbd-delta-deploy.xml instead of wcbd-deploy.xml as the Ant build file.