Building it - cmpaSample.ear

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

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:

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

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):
   • Type the following to uninstall the application:
     
     On Windows platforms:

     wsadmin -conntype none -c "$AdminApp uninstall cmpaSample" 

     
     On UNIX platforms:

     wsadmin.sh -conntype none -c "\$AdminApp uninstall cmpaSample" 

3. Reinstall the Sample:
• Change to the install_root/samples/lib/CMPa directory
• Locate the cmpaSample.ear file
• Type the following:
  
  On Windows platforms:

  wsadmin -conntype none -c "$AdminApp install cmpaSample.ear
  {-appname cmpaSample -usedefaultbindings -node
  <node> -deployejb -deployws}"
  	

  
  where <node> is the name of node on which to install the Sample.
  
  On UNIX platforms:
  

  wsadmin.sh -conntype none -c "\$AdminApp install cmpaSample.ear
  {-appname cmpaSample -usedefaultbindings -node
  <node> -deployejb -deployws}"
  	

  
  where <node> is the name of node on which to install the Sample.
4. Start the application server.