Administer > Deploy > Overview: WCS Build and Deployment tool > Configure and run the server deployment process


Set up the WCS configuration file synchronization Ant script

Overview

Developers of a customization project often manually edit wc-server.xml outside of the Configuration Manager and check it into the repository. While convenient, it also makes the master copy...

WC_INSTALL/instances/instance/xml/instance.xml

...lose synchronization with the copy in the WCS EAR. One version can potentially overwrite the other if a different update method is used.

If you are not changing the WCS configuration file, you may skip this section.

If the file transfer protocol used in the customization project is not one to which sample scripts are provided, develop custom scripts.

As a best practice, the files must be synchronized, and WCBD supports this practice by transferring the wc-server.xml file that is in the server deployment package to the WCS server. In order to support remote servers that may have different file transfer methods, the server deployment scripts require users to provide a WCS configuration file synchronization Ant build file that is executed as part of the server deployment process.

Sample scripts for some popular file transfer protocols are provided by default in...

WCBD_DEPLOY_SERVER /wc-server-sync

...including...

FTP wcbd-sample-wc-server-sync-ftp.*
Local filesystem wcbd-sample-wc-server-sync-local.*
SCP and SFTP wcbd-sample-wc-server-sync-scp.*

protocol refers to one of ftp, local or scp that suits the environment.


Set up the WCS configuration file synchronization Ant script

  1. Make copies and change file permissions...

    cd WCBD_DEPLOY_SERVER/wc-server-sync
    cp wcbd-sample-wc-server-sync-protocol.private.properties wc-server-sync-protocol.private.properties
    cp sample-wc-server-sync-protocol.properties wc-server-sync-protocol.properties
    cp sample-wc-server-sync-protocol.xml wc-server-sync-protocol.xml
    chmod 755 wc-server-sync-protocol.*

  2. Edit...

    wc-server-sync-protocol.xml

    ...and replace the name attribute of the root project element from...

    wcbd-sample-wc-server-sync-protocol

    ...to...

    wc-server-sync-protocol

    For example, if the file transfer protocol is FTP, then...

    wc-server-sync-ftp.xml

    ...should have the following line...

    <project name="wcbd-sample-wc-server-sync-ftp" default="all">

    ...changed to...

    <project name="wc-server-sync-ftp" default="all">

  3. If step 1 is applicable, edit...

    wc-server-sync-protocol.private.properties

    ...and edit the properties according to the comments in...... the file. Properties in this file will be encoded when the deployment process is run.

  4. Edit...

    wc-server-sync-protocol.properties

    ...and edit the properties according to the comments in the file.


Previous topic: Set up the static Web server assets deployment Ant script


Next topic: Configure the server deployment settings


+

Search Tips   |   Advanced Search