Customizing deployed virtual system instances

Optionally, you can update each virtual system instance that you deploy with your own customization in a WebSphere Commerce Build and Deployment tool package.

Procedure

Obtain the WebSphere Commerce Build and Deployment server deployment package.
1. Ensure that the package is in a .zip file format, not under a subdirectory.
2. Note the target-env name that is used in your server deployment package.
3. Ensure that the files are in the root of the .zip file, not under a subdirectory.
4. Ensure that any custom properties are already defined in the deploy-target-env.properties file, where target-env is the name you noted in the previous step.
5. Note the Ant build file to run when the package is deployed. You must provide the name of the Ant build file when you deploy the image.
  By default, it is wcbd-deploy.xml, but your WebSphere Commerce Build and Deployment developers might include a custom Ant script. Do not hardcode any values into custom Ant scripts. If you do, deployment might fail.
6. If your WebSphere Commerce Build and Deployment package sends status emails and if your SMTP server requires authentication, you must determine the SMTP user ID and password to use. You must provide this information when you deploy the image.
7. Host the WebSphere Commerce Build and Deployment package on your file server.
  - Make note of the URL to the package. You must provide the URL when you deploy the image.
  - Make note of the user ID and password that is needed to download the file. You must provide the user ID and password when you deploy the image.
Obtain the third-party library ant-contrib-1.0b3.jar and make the file available.
This library is needed to deploy using the WebSphere Commerce Build and Deployment tool.
1. Obtain the Ant-Contrib 1.0b3 package.
2. Extract the ant-contrib-1.0b3.jar file from the package.
3. Host the ant-contrib-1.0b3.jar file on your file server.
4. Make note of the URL to the file. You must provide the URL when you deploy the image.
5. Make note of the user ID and password that is needed to download the file. You must provide the user ID and password when you deploy the image.
Obtain an Apache Ant package.
1. Host the Apache Ant package on your own server. You must obtain the package and copy it to your file server.
2. Ensure that the package is in a compressed .tar archive (either a *.tar.gz or *.tgz file).
3. Make note of the URL to the package. You must provide the URL when you deploy the image.
4. Make note of the user ID and password that is needed to download the package. You must provide the user ID and password when you deploy the image.
One instance at a time, use the following steps to update each deployed virtual system instance with your customization.
1. Click Patterns > Virtual System Instances
2. Select the instance that you want to customize.
3. Click to expand the Virtual Machines folder.
4. Click to expand the virtual machine hostname-Standalone-Commerce
5. Under Commerce Customization, click Execute.
6. Enter the non-root user ID, password, and update the parameters for the Commerce Customization script.
7. Click OK.
When deployment is complete, check the status of the deployment customization. If the update is successful, your customization package is deployed. You can continue to verify your customization.
Repeat this step for each of the deployed virtual system instances that you want to customize.