ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzatz_5.4.0.1/51/admin/qshearexp.htm

79 lines
4.4 KiB
HTML
Raw Permalink Normal View History

2024-04-02 14:02:31 +00:00
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<META http-equiv="Content-Type" content="text/html; charset=utf-8">
<LINK rel="stylesheet" type="text/css" href="../../../rzahg/ic.css">
<title>Use the EARExpander script to work with applications</title>
</head>
<BODY>
<!-- Java sync-link -->
<SCRIPT LANGUAGE="Javascript" SRC="../../../rzahg/synch.js" TYPE="text/javascript"></SCRIPT>
<h3><a name="qshearexp"></a>Use the EARExpander script to work with applications</h3>
<p>The EARExpander script expands an EAR file into a directory to run the application in that EAR file. It also collapses a directory containing application files into a single EAR file. You can type EARExpander with no arguments to learn more about its options. For information on running Qshell scripts, see <a href="qshadm.htm">Configure Qshell to run WebSphere Application Server - Express scripts</a>.</p>
<p><strong>Authority</strong></p>
<p>No special authority is required to run this script.</p>
<p><strong>Usage</strong></p>
<p>To run the script, follow these steps:</p>
<ol>
<li><p>On the CL command line, run the STRQSH (Start Qshell) command.</p></li>
<li><p>Run the cd command to change to the directory that contains the script:</p>
<pre>cd /QIBM/ProdData/WebASE51/ASE/bin</pre></li>
<li><p>Run the EARExpander script:</p>
<pre>EARExpander -ear <em>earfile</em> -operation expand | collapse
-operationDir <em>directory</em></pre>
<p>where <em>earfile</em> is the name of the EAR file that you want to expand or the name of the EAR file that you want to create and <em>directory</em> is the name of the directory to which the EAR file is expanded or from which the EAR file is created.</p></li>
</ol>
<p><strong>Syntax</strong></p>
<p>The syntax of the EARExpander script is:</p>
<pre>EARExpander -ear <em>earfile</em> -operation expand | collapse
-operationDir <em>directory</em> [ -help | -? ]</pre>
<p><strong>Parameters</strong></p>
<p>The parameters of the EARExpander script are:</p>
<ul>
<li><p><strong>-ear</strong><br>
This is a required parameter. The value <em>earfile</em> specifies the name of the EAR file that the expand or collapse operation uses. It is recommended that you specify a fully qualified name for the EAR file.</p>
<ul>
<li>If you specify the expand operation, this EAR file is extracted to the directory specified by the -operationDir parameter. If you do not specify the fully qualified name of the EAR file, the script searches the current working directory for the EAR file.</li>
<li>If you specify the collapse operation, the script creates this EAR file from the contents of the directory specified by the -operationDir parameter. For a collapse operation, you must specify a new name for the EAR file. If you do not specify the fully qualified name of the EAR file, the script creates the EAR file in the current working directory.</li>
</ul><p></p></li>
<li><p><strong>-operation</strong><br>
This is a required parameter. Valid arguments are expand and collapse.</p>
<ul>
<li>If you specify expand, the script extracts the contents of the EAR file into the directory specified by -operationDir.</li>
<li>If you specify collapse, the script creates an EAR file from the contents of directory specified by -operationDir.</li>
</ul><p></p></li>
<li><p><strong>-operationDir</strong><br>
This is a required parameter. The value <em>directory</em> specifies the directory on which the expand or collapse operation runs.</p>
<ul>
<li>If you specify the expand operation, the EAR file is expanded to this directory. If the directory does not exist, the script creates it.</li>
<li>If you specify the collapse operation, the EAR file is created from the contents of this directory.</li>
</ul><p></p></li>
<li><p><strong>-help</strong> or <strong>-?</strong><br>
This optional paramter prints the usage statement for the script.</p></li></ul>
<p><strong>Examples</strong></p>
<pre>EARExpander -ear /home/myProfile/myFile.EAR -operation expand
-operationDir /home/myProfile/myApps/myApp1</pre>
<p>This example expands the file myFile.EAR into the /home/myProfile/myApps/myApp1 directory.</p>
<pre>EARExpander -ear /home/myProfile/myNewFile.EAR -operation collapse
-operationDir /home/myProfile/myApps/myNewApplication</pre>
<p>This example creates the file myNewFile.EAR from the contents of the /home/myProfile/myApps/myNewApplication directory.</p>
</body>
</html>