Administer > Deploy > Overview: WebSphere Commerce Build and Deployment tool
WebSphere Commerce Build and Deployment tool prerequisites
- Overview
- Prerequisites: Build system
- Prerequisites: Server deployment system
- Prerequisites: Toolkit deployment system
- Third-party library dependencies
- Migrate WCBD from v6.0 to v7.0
- See also
Overview
Before starting, determine..
- The SCM used by the customization project
- Deployment and execution of Apache Ant scripts
- Deployment of customized WCS configuration, database and EAR assets
- Configuration and application update of WAS particularly using the wsadmin tool and Jython scripting
- Remote file transfer protocols such as FTP, SCP and SFTP
Skills in Apache Ant and Jython are important if you intend to customize the tool.
Questions to answer...
- Which database is used by the customization project?
- How many server environments are used by the customization project (production, staging, testing)? If more than one, do these environments have different configuration settings (for example, different data in the database, or different settings in the wc-server.xml file)?
- For each server environment, is the WCS EAR deployed in a single-server environment or a clustered environment?
- For each server environment, if you have a remote Web server and it hosts static Web contents for the customization project, how do you deploy the Web assets? Can you use remote file transfer methods such as FTP or SCP?
- For each server environment, if you plan to deploy from a different system than the server with WCS installed, can you use remote file transfer methods such as FTP or SCP to access the server? This is required for synchronizing the WCS configuration files between the master copy and the EAR copy.
You also need access to the servers in the WCS topology. You will need to access these servers for information that is required to set up the build and deployment processes. If you do not have access to these servers, make sure the administrator can provide you with this information.
Prerequisites: Build system
- The build system requires that either WCS v7.0 (any edition) or WCS Developer v7.0 (any edition), and the associated requirements met, be installed. Refer to...
- It is highly recommended that a server is dedicated to performing builds.
- Matching WAS fix pack and interim fixes as the server deployment system installed to the WAS v7.0 Test Environment that is part of Rational Application Developer V7.5.
- 2 GB of additional disk space for WCBD, temporary files and deployment packages generated by the build process.
- EJB deployment can fail during the build process due to a long installation path of WAS or WAS Test Environment from Rational Application Developer.
To avoid this problem, the subst command can be used map the path to a virtual drive and the shorten path can be used in place of the original path. For example:
subst W: "C:\Program Files\IBM\WebSphere\AppServer"
The path W:\ can then be used in the build settings. For more information...
subst /?
- The ARG/ENV list size needs to be changed to 10 x 4K byte blocks or larger to support the EJB deploy tool. As the root user, run the following command:
- chdev -l sys0 -a ncargs='#-4KB-blocks'
- Apache Ant 1.7.1 or later installed.
To install, download the binary distribution and unzip it to a local directory.
- The client software of the SCM used (for example, CVS, Subversion, or ClearCase) must be installed and available in command line (with the PATH environment set for the SCM client).
- If you are using the e-mail notification functionality, access to an SMTP server is required.
Prerequisites: Server deployment system
WCBD requires WebSphere Commerce v7.0, and the associated requirements met, on the server deployment system.
In addition, the following requirements must also be met:
- The system from which wsadmin is run should have the SOAP request timeout value set to 0 (no timeout). This can be done by changing...
com.ibm.SOAP.requestTimeout...in...
WAS_HOME/profiles/profile_name/properties/soap.client.props
- 1 GB of additional disk space for the deployment package and temporary files generated during the deployment process.
- Apache Ant 1.7.1 or later installed.
To install, download the binary distribution and unzip it to a local directory.
- If using the e-mail notification functionality, access to an SMTP server is required.
Prerequisites: Toolkit deployment system
WCBD requires WebSphere Commerce Developer v7.0, and the associated requirements met, on the toolkit deployment system.
In addition, the following requirements must also be met:
- Matching WAS fix pack and interim fixes as the server deployment system installed to the WAS v7.0 Test Environment that is part of Rational Application Developer V7.5.
- 1 GB of additional disk space for the deployment package and temporary files generated during the deployment process.
Third-party library dependencies
WCBD depends on some third-party libraries that must be downloaded and placed on the build system separately. These libraries will be packaged into the deployment packages as the deployment process may depend on them as well.
Software Library file name System Required Ant-Contrib 1.0b3 ant-contrib-1.0b3.jar
- Build
- Server deployment
- Toolkit deployment
Yes Jakarta Commons Net 1.4.1 commons-net-1.4.1.jar Server deployment Yes if the ftp Ant task is used for...
- remote static Web asset deployment
- wc-server.xml synchronization
Jakarta ORO 2.0.8 jakarta-oro-2.0.8.jar Server deployment Yes if the ftp Ant task is used for...
- remote static Web asset deployment
- wc-server.xml synchronization
Java Activation Framework (JAF) 1.1.1 activation.jar
- Build
- Server deployment
Yes if the mail Ant task is used (for e-mail notification) JavaMail 1.4.1 mail.jar
- Build
- Server deployment
Yes if the mail Ant task is used (for e-mail notification) JSch 0.1.42 jsch-0.1.42.jar Server deployment Yes if the scp Ant task is used (for remote static Web asset deployment or wc-server.xml synchronization via SCP/SFTP) SvnAnt 1.2.1 All libraries in the lib directory of the distribution Build Yes if the svn Ant task is used (for source extraction from Subversion)
Migrate WCBD from v6.0 to v7.0
For WCS v6.0, WCBD was offered as a sample application. If you are using this sample application, it will not work with WCS v7.0. You must manually migrate any configuration and customization of WCBD from v6.0 to v7.0 to use it in v7.0.
See also
- Ant-Contrib
- Apache Ant
- Jakarta Commons Net
- Jakarta ORO
- Ant-contrib tasks
- JavaBeans Activation Framework
- JavaMail
- JSch
- IBM Software Support: WebSphere
- IBM WebSphere Developer Technical Journal: System Management for WAS V6 - Part 5
- Rational Application Developer V7.5 Information Center
- Webcast Replay: WCS v6 Deployment
- WAS v7.0 Information Center