Creating the EAR file on WebSphere

About this task

During the ear build, when JAX-WS webservice creation occurs, Sterling Order Management System Software will look for customer extensions and use them if they exist. If they do not exist, default handler XML and handler classes will be built into the ear and used. Sterling Order Management System Software provides one single set of default handlers that will get used against all beans that are deployed and for which customers have not provided extensions. Customer extensions can be provided on a per JAX-WS bean basis.

Enterprise Archives are built using an ANT (buildEAR.xml) that accepts the following targets:

Main Target
Creates smcfs.ear - The Sterling Order Management System Software application EAR file.


To create an application EAR file, run the following command from the <INSTALL_DIR>/bin directory:
./ -Dappserver=websphere -Dwarfiles=<application wars> -Dearfile=smcfs.ear -Dasyncejb=true create-ear 
.\buildear.cmd -Dappserver=websphere -Dwarfiles=<application wars> -Dearfile=smcfs.ear -Dasyncejb=true create-ear 
Note: Sterling Order Management System Software supports the RPC encoded or document literal style and usage of invocation for Web services. When choosing style and usage for WebSphere®, pass the following in the ear command line:
-D websphere-java2wsdl-style=<rpc|document>

Running this command creates the smcfs.ear file in the <INSTALL_DIR>/external_deployments/ directory. Depending on the application wars provided in the command while creating the EAR, appropriate wars are included in the smcfs.ear. Examples:

  • smcfs.war - the Sterling Order Management System Software or Sterling Configure, Price, Quote war file.
  • sma.war - the System Management Administrator application war file.
  • sbc.war - the Sterling Business Center application war file.


You can add the following options to the end of the above buildear commands:

  • -Dnowebservice=true if you do not want to use Web services.
  • -Ddevmode=true if you want to use the HTTP API Tester in the development environment.
    Note: If the -Ddevmode is set to true while building the EAR, few struts developer notification errors may be logged while using the application. You can ignore the error log.
  • -Dnodocear=true if you want to skip the documentation build. Use this option when building the ear for a production environment. The doc ear does not contain end-user documentation, such as context-sensitive help files. It contains only development-related documentation, including API Javadoc, ERDs, and XSDs and should not be deployed to a production server.
  • -Dsupport.multi.war=true if you want to copy all the UI jars to <WAR>/WEB-INF/lib. The UI jars will be copied based on the entry in DCL.xml.
  •<application_name> if you want to override the default value of "Sterling applications" and build some other application, particularly in an auto-deploy scenario.
  • -Dasyncejb=true - Use this option only if you are implementing the Parallel Processing functionality.

For more information about WebSphere, see the IBM® WebSphere information center:


If using WebSphere: When building EJB-based web services, if WebSphere and Sterling Order Management System Software were installed with different users, you may see file permissions errors when running the ear build script. To avoid this, grant permissions to read and write in the Sterling Order Management System Software directory to the WebSphere installation user.

The build ear process will leave files owned by the other user and you may need to set permissions back.

Note: If exceptions are thrown regarding application server startup or EAR deployment, this may indicate failure that requires repair and redeployment. Consult the Troubleshooting and Support topics.