Building it - cmpaSample.ear



Important Information Note for z/OS customers: The following instructions cannot be executed on the z/OS platform. Please click here for z/OS instructions.

Getting started
Identifying the directory structure
Rebuilding and installing the EAR file

Getting started

Make a backup copy of the samples directory before attempting to modify or rebuild the Samples. Create a zip file of the samples directory. You can restore the samples directory to its original state by extracting the zip file.

Before executing commands in the sections that follow, make sure install_root/bin is in your PATH.

Identifying the directory structure of the Samples build

Locate the Samples in the following directories:

install_root/samples/src/CMPa Contains the sample source code for Container Managed Persistence over Anything.
install_root/samples/lib/CMPa Contains the final cmpaSample.ear and cmpaSdoRepository.rar files for sample.
install_root/samples/bld/CMPa Contains the generated class files. These class files are used to generate the final cmpaSample.ear and cmpaSdoRepository.rar files. The bld directory is created after the Samples are built.
install_root/samples/javadoc/CMPa Contains the generated JavaDoc documentation for the CMP/A sample. These HTML files explain the various Java source files that comprise the sample.

Rebuilding and installing the cmpaSample.ear file

The CMP/A Sample automatically installs with the WebSphere Business Integration Server. You do not have to build the Samples before using them. The directions that follow describe the steps to rebuild the Samples, along with additional information for modifying them.

Executing the Samples build script
Removing and reinstalling the cmpaSample.ear file

Executing the Samples build script

To rebuild the CMP/A Sample, change to the install_root/samples/src/CMPa directory, and type ws_ant at the command line.

Find the ws_ant script in the install_root/bin directory. The script sets the appropriate classpath information and executes the Ant 1.5 build utility. Ant reads the build.xml file, which describes how to build the sample. Refer to the Ant Web site for additional documentation on Ant 1.5.

Removing and reinstalling the cmpaSample.ear file

By default, the CMP/A Sample installs into the user_install_root/installedApps/<cell_name> directory. Where <cell_name> is the name of the cell where your application is installed. Reinstall the sample as follows:

  1. Stop the application server.
  2. Remove the Sample EAR file (install_root/bin must be in your PATH):
  3. Reinstall the Sample:
  4. Start the application server.