WAS v8.5 > Reference > Command-line utilities

EARExpander command

Use EARExpander to expand an EAR file into a directory or or collapse a directory containing application files into a single EAR file.

PROFILE_ROOT/binEarExpander -ear earName -operationDir dirName -operation <expand | collapse> [-expansionFlags <all|war>]

...where...

-ear

Name of the input EAR file for the expand operation or the name of the output EAR file for the collapse operation.

-operationDir

Directory where the EAR file is expanded or specifies the directory from where files are collapsed.

-operation <expand | collapse>

The expand value expands an EAR file into a directory structure required by the WAS run time. The collapse value creates an EAR file from an expanded directory structure.

-expansionFlags <all | war>

(Optional) The all value expands all files from all the modules. The war value only expands the files from web archive (WAR) file modules.

Examples...

    EARExpander.sh -ear /WebSphere/AppServer/installableApps/DefaultApplication.ear \
                   -operationDir /path/to/MyApps \
                   -operation expand \
                   -expansionFlags war

    EARExpander.sh -ear /backup/DefaultApplication.ear \
                   -operationDir /path/to/MyAppsDefaultApplication.ear \
                   -operation collapse

Run with with no arguments to learn more about its options.

Do not include a pound sign (#) in the name of files that are packaged within an application archive. Due to internal processing, the application server fails to correctly deploy the application when a pound sign is included in a file name within the application archive. When this failure occurs, an exception might occur when the application is being processed. Also, parts of the application might be missing after the application is deployed. To address this issue, rename any file names within the application archive so they do not contain a pound sign.

Return codes

The EARExpander command has the following return codes.

Return codes and their descriptions. The return code indicates the success of the operation.

Return code	Description
-1	A syntax error exists.
0	The command ran successfully.
1	An error occurred.
2	An exception occurred.

Related

Use command-line tools

+

Search Tips   |   Advanced Search