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
- Description
- create-ear
- Creates
smcfs.ear
- The Sterling Order Management System Software application EAR file.
Procedure
<INSTALL_DIR>/bin
directory:
./buildear.sh -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
-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.
Notes:
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 inDCL.xml
.-Dapp.name=<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: http://publib.boulder.ibm.com/infocenter/wasinfo/v8r0/index.jsp.
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.